mirror of
https://git.rtems.org/rtems-docs/
synced 2025-05-19 15:37:54 +08:00
519 lines
8.0 KiB
ReStructuredText
519 lines
8.0 KiB
ReStructuredText
Language-Specific Services for the C Programming Language Manager
|
|
#################################################################
|
|
|
|
Introduction
|
|
============
|
|
|
|
The
|
|
language-specific services for the C programming language manager is ...
|
|
|
|
The directives provided by the language-specific services for the C programming language manager are:
|
|
|
|
- ``setlocale`` - Set the Current Locale
|
|
|
|
- ``fileno`` - Obtain File Descriptor Number for this File
|
|
|
|
- ``fdopen`` - Associate Stream with File Descriptor
|
|
|
|
- ``flockfile`` - Acquire Ownership of File Stream
|
|
|
|
- ``ftrylockfile`` - Poll to Acquire Ownership of File Stream
|
|
|
|
- ``funlockfile`` - Release Ownership of File Stream
|
|
|
|
- ``getc_unlocked`` - Get Character without Locking
|
|
|
|
- ``getchar_unlocked`` - Get Character from stdin without Locking
|
|
|
|
- ``putc_unlocked`` - Put Character without Locking
|
|
|
|
- ``putchar_unlocked`` - Put Character to stdin without Locking
|
|
|
|
- ``setjmp`` - Save Context for Non-Local Goto
|
|
|
|
- ``longjmp`` - Non-Local Jump to a Saved Context
|
|
|
|
- ``sigsetjmp`` - Save Context with Signal Status for Non-Local Goto
|
|
|
|
- ``siglongjmp`` - Non-Local Jump with Signal Status to a Saved Context
|
|
|
|
- ``tzset`` - Initialize Time Conversion Information
|
|
|
|
- ``strtok_r`` - Reentrant Extract Token from String
|
|
|
|
- ``asctime_r`` - Reentrant struct tm to ASCII Time Conversion
|
|
|
|
- ``ctime_r`` - Reentrant time_t to ASCII Time Conversion
|
|
|
|
- ``gmtime_r`` - Reentrant UTC Time Conversion
|
|
|
|
- ``localtime_r`` - Reentrant Local Time Conversion
|
|
|
|
- ``rand_r`` - Reentrant Random Number Generation
|
|
|
|
Background
|
|
==========
|
|
|
|
There is currently no text in this section.
|
|
|
|
Operations
|
|
==========
|
|
|
|
There is currently no text in this section.
|
|
|
|
Directives
|
|
==========
|
|
|
|
This section details the language-specific services for the C programming language manager's directives.
|
|
A subsection is dedicated to each of this manager's directives
|
|
and describes the calling sequence, related constants, usage,
|
|
and status codes.
|
|
|
|
setlocale - Set the Current Locale
|
|
----------------------------------
|
|
.. index:: setlocale
|
|
.. index:: set the current locale
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int setlocale(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
fileno - Obtain File Descriptor Number for this File
|
|
----------------------------------------------------
|
|
.. index:: fileno
|
|
.. index:: obtain file descriptor number for this file
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int fileno(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
fdopen - Associate Stream with File Descriptor
|
|
----------------------------------------------
|
|
.. index:: fdopen
|
|
.. index:: associate stream with file descriptor
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int fdopen(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
flockfile - Acquire Ownership of File Stream
|
|
--------------------------------------------
|
|
.. index:: flockfile
|
|
.. index:: acquire ownership of file stream
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int flockfile(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
ftrylockfile - Poll to Acquire Ownership of File Stream
|
|
-------------------------------------------------------
|
|
.. index:: ftrylockfile
|
|
.. index:: poll to acquire ownership of file stream
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int ftrylockfile(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
funlockfile - Release Ownership of File Stream
|
|
----------------------------------------------
|
|
.. index:: funlockfile
|
|
.. index:: release ownership of file stream
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int funlockfile(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
getc_unlocked - Get Character without Locking
|
|
---------------------------------------------
|
|
.. index:: getc_unlocked
|
|
.. index:: get character without locking
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int getc_unlocked(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
getchar_unlocked - Get Character from stdin without Locking
|
|
-----------------------------------------------------------
|
|
.. index:: getchar_unlocked
|
|
.. index:: get character from stdin without locking
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int getchar_unlocked(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
putc_unlocked - Put Character without Locking
|
|
---------------------------------------------
|
|
.. index:: putc_unlocked
|
|
.. index:: put character without locking
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int putc_unlocked(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
putchar_unlocked - Put Character to stdin without Locking
|
|
---------------------------------------------------------
|
|
.. index:: putchar_unlocked
|
|
.. index:: put character to stdin without locking
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int putchar_unlocked(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
setjmp - Save Context for Non-Local Goto
|
|
----------------------------------------
|
|
.. index:: setjmp
|
|
.. index:: save context for non
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int setjmp(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
longjmp - Non-Local Jump to a Saved Context
|
|
-------------------------------------------
|
|
.. index:: longjmp
|
|
.. index:: non
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int longjmp(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
sigsetjmp - Save Context with Signal Status for Non-Local Goto
|
|
--------------------------------------------------------------
|
|
.. index:: sigsetjmp
|
|
.. index:: save context with signal status for non
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int sigsetjmp(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
siglongjmp - Non-Local Jump with Signal Status to a Saved Context
|
|
-----------------------------------------------------------------
|
|
.. index:: siglongjmp
|
|
.. index:: non
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int siglongjmp(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
tzset - Initialize Time Conversion Information
|
|
----------------------------------------------
|
|
.. index:: tzset
|
|
.. index:: initialize time conversion information
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int tzset(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
strtok_r - Reentrant Extract Token from String
|
|
----------------------------------------------
|
|
.. index:: strtok_r
|
|
.. index:: reentrant extract token from string
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int strtok_r(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
asctime_r - Reentrant struct tm to ASCII Time Conversion
|
|
--------------------------------------------------------
|
|
.. index:: asctime_r
|
|
.. index:: reentrant struct tm to ascii time conversion
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int asctime_r(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
ctime_r - Reentrant time_t to ASCII Time Conversion
|
|
---------------------------------------------------
|
|
.. index:: ctime_r
|
|
.. index:: reentrant time_t to ascii time conversion
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int ctime_r(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
gmtime_r - Reentrant UTC Time Conversion
|
|
----------------------------------------
|
|
.. index:: gmtime_r
|
|
.. index:: reentrant utc time conversion
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int gmtime_r(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
localtime_r - Reentrant Local Time Conversion
|
|
---------------------------------------------
|
|
.. index:: localtime_r
|
|
.. index:: reentrant local time conversion
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int localtime_r(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
rand_r - Reentrant Random Number Generation
|
|
-------------------------------------------
|
|
.. index:: rand_r
|
|
.. index:: reentrant random number generation
|
|
|
|
**CALLING SEQUENCE:**
|
|
|
|
.. code:: c
|
|
|
|
int rand_r(
|
|
);
|
|
|
|
**STATUS CODES:**
|
|
|
|
*E*
|
|
The
|
|
|
|
**DESCRIPTION:**
|
|
|
|
**NOTES:**
|
|
|
|
.. COMMENT: COPYRIGHT (c) 1988-2002.
|
|
|
|
.. COMMENT: On-Line Applications Research Corporation (OAR).
|
|
|
|
.. COMMENT: All rights reserved.
|
|
|