The ILE C/C++ runtime library provides functions that
can be used when programming ILE C and C++ application programs. For more information, see the ILE C/C++ Runtime Library Functions manual, SC41-5607.
The ILE C/C++ runtime library functions are:
Access function arguments (va_arg()) accesses the arguments to a function when it takes a fixed number of required arguments and a variable number of optional arguments.
Access function arguments (va_start()) accesses the arguments to a function when it takes a fixed number of required arguments and a variable number of optional arguments.
Access function arguments (va_end()) accesses the arguments to a function when it takes a fixed number of required arguments and a variable number of optional arguments.
Acquire a program device (_Racquire()) acquires the program device specified by the dev parameter and associates it with the file specified by fp.
Adjust current file position (rewind()) repositions the file pointer associated with stream to the beginning of the file.
Change data area (QXXCHGDA()) allows you to change the data area specified by dtaname, starting at position offset, with the data in the user buffer pointed to by dtaptr of length len.
Compare wide character buffers (wmemcmp()) compares the first n wide characters of the object pointed to by s1 to the first n wide characters of the object pointed to by s2.
Compile regular expression (regcomp()) compiles the source regular expression pointed to by pattern into an executable version and stores it in the location pointed to by preg.
Compute power (pow()) calculates the value of x to the power of y.
Concatenate strings (strcat()) concatenates string2 to string1 and ends the resulting string with the null character.
Concatenate strings (strncat()) appends the first count characters of string2 to string1 and ends the resulting string with a null character.
Concatenate wide character strings (wcscat()) appends a copy of the string pointed to by string2 to the end of the string pointed to by string1.
Concatenate wide character strings (wcsncat()) appends up to count wide characters from string2 to the end of string1, and appends a wchar_t null character to the result.
Control buffering (setbuf()) controls buffering for the specified stream, if the operating system supports user-defined buffers.
Control buffering (setvbuf()) allows control over the buffering strategy and buffer size for a specified stream.
Convert a multibyte character to a wide character (restartable) (mbsrtowcs()) converts a sequence of multibyte characters that begins in the conversion state described by ps from the array indirectly pointed to by src into a sequence of corresponding wide characters.
Convert character (toascii()) determines to what character c would be mapped to in a 7-bit US-ASCII locale and returns the corresponding EBCDIC encoding in the current locale.
Convert character case (tolower()) converts the uppercase letter C to the corresponding lowercase letter.
Convert character case (toupper()) converts the lowercase letter c to the corresponding uppercase letter.
Convert date/time to string (strftime()) places bytes into the array pointed to by s as controlled by the string pointed to by format.
Convert double to packed decimal (QXXDTOP()) converts the double value specified in value to a packed decimal number with digits total digits, and fraction fractional digits.
Convert double to zoned decimal (QXXDTOZ()) converts the double value specified in value to a zoned decimal number with digits total digits, and fraction fractional digits.
Convert integer to packed decimal (QXXITOP()) converts the integer specified in value to a packed decimal number with digits total digits, and fraction fractional digits.
Convert integer to string (_itoa()) converts the digits of the given value to a character string that ends with a null character and stores the result in string.
Convert integer to zoned decimal (QXXITOZ()) converts the integer specified in value to a zoned decimal number with digits total digits, and fraction fractional digits.
Convert local time (mktime()) converts local time, stored as a tm structure pointed to by time, into a time_t structure suitable for use with other time functions.
Convert long integer to string (_ltoa()) converts the digits of the given long integer value to a character string that ends with a null character and stores the result in string.
Convert monetary value to string (strfmon()) places characters into the array pointed to by s as controlled by the string pointed to by format.
Convert string to date/time (strptime()) converts the character string pointed to by buf to values that are stored in the tm structure pointed to by tm, using the format specified by format.
Convert time (localtime64()) converts time to local time.
Convert time (gmtime64()) converts time to the Coordinated Universal Time structure.
Convert time (localtime()) converts a time value, in seconds, to a structure of type tm.
Convert time (gmtime()) breaks down the time value, in seconds, and stores it in a tm structure, defined in <time.h>.
Convert time (restartable) (localtime64_r()) converts time to local time (restartable version of the localtime64() function).
Convert time (restartable) (gmtime64_r()) converts time to the Coordinated Universal Time structure (restartable version of the gmtime() function).
Convert time (restartable) (localtime_r()) converts a time value, in seconds, to a structure of type tm.
Convert time (restartable) (gmtime_r()) breaks down the time value, in seconds, and stores it in a tm structure, defined in <time.h>.
Convert time to character string (ctime64_r()) converts time stored as a long long value to a character string (restartable version of the ctime64() function).
Convert to formatted date and time (wcsftime()) converts the time and date specification in the timeptr structure into a wide character string.
Convert unsigned long integer to string (_Ultoa()) converts the digits of the given unsigned long value to a character string that ends with a null character and stores the result in string.
Convert wide character case (towlower()) converts the lowercase character wc to the corresponding uppercase letter.
Convert wide character case (towupper()) converts the uppercase character wc to the corresponding lowercase letter.
Convert wide character string to date/time (wcsptime()) converts the wide character string pointed to by buf to values that are stored in the tm structure pointed to by tm, using the format specified by format.
Convert wide character string to multibyte string (restartable) (wcsrtombs()) converts a sequence of wide characters from the array indirectly pointed to by src into a sequence of corresponding multibyte characters that begins in the shift state described by ps.
Convert wide character to byte (wctob()) determines whether wc corresponds to a member of the extended character set, whose multibyte character has a length of 1 byte when in the initial shift state.
Convert zoned decimal to double (QXXZTOD()) converts to a double, the zoned decimal number (with digits total digits, and fraction fractional digits) pointed to by zptr.
Convert zoned decimal to integer (QXXZTOI()) converts to an integer, the zoned decimal number (with digits total digits, and fraction fractional digits) pointed to by zptr.
Copy bytes (memcpy()) copies count bytes of src to dest.
Copy bytes (memmove()) copies count bytes of src to dest.
Copy strings (strncpy()) copies count characters of string2 to string1.
Copy strings (strcpy()) copies string2, including the ending null character, to the location that is specified by string1.
Copy wide character buffer (wmemcpy()) copies n wide characters from the object pointed to by s2 to the object pointed to by s1.
Copy wide character buffer (wmemmove()) copies n wide characters from the object pointed to by s2 to the object pointed to by s1.
Copy wide character strings (wcscpy()) copies the contents of string2 (including the ending wchar_t null character) into string1.
Delete a record (_Rdelete()) deletes the record that is currently locked for update in the file specified by fp.
Delete file (remove()) deletes the file specified by filename.
Determine amount of teraspace memory used (_C_TS_malloc_info()) determines the amount of teraspace memory used and returns the informatoin within the given output_record structure.
Determine processor time (clock()) returns an approximation of the processor time used by the program since the beginning of an implementation-defined time-period that is related to the process invocation.
Determine the display width of a wide character string (wcswidth()) determines the number of printing positions that a graphic representation of n wide characters in the wide string pointed to by wcs occupies on a display device.
Duplicate string (strdup()) reserves storage space for a copy of string by calling malloc.
End program (exit()) returns control to the host environment from the program.
Execute a command (system()) passes the given string to the CL command processor for processing.
Execute compiled regular expression (regexec()) compares the null-ended string against the compiled regular expression preg to find a match between the two.
Find characters in string (strpbrk()) locates the first occurrence in the string pointed to by string1 of any character from the string pointed to by string2.
Find integer <= argument (floor()) calculates the largest integer that is less than or equal to x.
Find integer >= argument (ceil()) computes the smallest integer that is greater than or equal to x.
Find offset of first character match (strcspn()) finds the first occurrence of a character in string1 that belongs to the set of characters that is specified by string2.
Find offset of first non-matching character (strspn()) finds the first occurrence of a character in string1 that is not contained in the set of characters that is specified by string2.
Find offset of first non-matching wide character (wcsspn()) computes the number of wide characters in the initial segment of the string pointed to by string1, which consists entirely of wide characters from the string pointed to by string2.
Find offset of first wide character match (wcscspn()) determines the number of wchar_t characters in the initial segment of the string pointed to by string1 that do not appear in the string pointed to by string2.
Force the end-of-data (_Rfeod()) forces an end-of-data condition for a device or member associated with the file specified by fp.
Force the end-of-file (_Rfeov()) forces an end-of-volume condition for a tape file that is associated with the file that is specified by fp.
Format argument data as wide characters and print (vwprintf()) is equivalent to the wprintf() function, except that the variable argument list is replaced by arg, which the va_start macro (and possibly subsequent va_arg calls) will have initialized.
Format argument data as wide characters and write to a stream (vfwprintf()) is equivalent to the fwprintf() function, except that the variable argument list is replaced by arg, which the va_start macro (and possibly subsequent va_arg calls) will have initialized.
Free memory for regular expression (regfree()) frees any memory that was allocated by the regcomp() function to implement the regular expression preg.
Gamma function (gamma()) computes the natural logarithm of the absolute value of G(x) (ln(|G(x)|)).
Generate Quick Pool memory management report (_C_Quickpool_Report()) generates a spooled file that contains a snapshot of the memory used by the Quick Pool memory management algorithm in the current activation group.
Get current position (ftell()) finds the current position of the file associated with stream.
Get current position (ftello()) finds the current position of the file associated with stream.
Get device attributes (_Rdevatr()) returns a pointer to a copy of the device attributes feedback area for the file pointed to by fp, and the device specified by dev.
Get exception data (_GetExcData()) returns information about the current exception from within a C signal handler.
Get file position (fgetpos()) stores the current position of the file pointer that is associated with stream into the object pointed to by pos.
Get handle for character property classification (wctype()) determines values of wctype_t according to rules of the coded character set that are defined by character type information in the program's locale (category LC_CTYPE).
Get wide character from stdin (getwchar()) reads the next multibyte character from stdin, converts it to a wide character, and advances the associated file position indicator for stdin.
Handle interrupt signals (signal()) allows a program to choose one of several ways to handle an interrupt signal from the operating system or from the raise() function.
Handle to a C session (_C_Get_Ssn_Handle()) Returns a handle to the C session for use with Dynamic Screen Manager (DSM) APIs.
Language collation string comparison (wcscoll()) compares the wide character strings pointed to by wcs1 and wcs2, both interpreted as appropriate to the LC_COLLATE category of the current locale.
Locate wide character substring (wcswcs()) locates the first occurrence of string2 in the wide character string pointed to by string1.
Locate wide characters in string (wcspbrk()) locates the first occurrence in the string pointed to by string1 of any wide character from the string pointed to by string2.
Obtain I/O feedback information (_Riofbk()) returns a pointer to a copy of the I/O feedback area for the file that is specified by fp.
Obtain open feedback information (_Ropnfbk()) returns a pointer to a copy of the open feedback area for the file that is specified by fp.
Open a record file for I/O operations (_Ropen()) opens the record file specified by filename according to the mode parameter, which may be followed by optional parameters, if the varparm keyword parameter is specified in the mode parameter.
Open files (fopen()) opens the file that is specified by filename.
Open files (wfopen()) accepts file name and mode as wide characters and assumes CCSID 13488 if neither CCSID nor codepage keyword is specified.
Open message catalog (catopen()) opens a message catalog, which must be done before a message can be retrieved.
Produce temporary file name (tmpnam()) produces a valid file name that is not the same as the name of any existing file.
Provide information on last I/O operation (_Rupfb()) updates the feedback structure associated with the file specified by fp with information about the last I/O operation.
Read a character (fgetc()) reads a single unsigned character from the input stream at the current position and increases the associated file pointer, if any, so that it points to the next character.
Read a character (getc()) reads a single character from the current stream position and advances the stream position to the next character.
Read a character (getchar()) reads a single character from the current stream position and advances the stream position to the next character.
Read a line (gets()) reads a line from the standard input stream stdin and stores it in buffer.
Read a record by key (_Rreadk()) reads the record in the keyed access path that is currently being used for the file that is associated with fp.
Read a record by relative record number (_Rreadd()) reads the record that is specified by rrn in the arrival sequence access path for the file that is associated with fp.
Read a string (fgets()) reads characters from the current stream position up to and including the first new-line character (), up to the end of the stream, or until the number of characters read is equal to n-1, whichever comes first.
Read data (sscanf()) reads data from buffer into the locations that are given by argument-list.
Read data (scanf()) reads data from the standard input stream stdin into the locations that is given by each entry in argument-list.
Read data using wide character format string (wscanf()) is equivalent to the fwscanf() function with the argument stdin interposed before the arguments of the wscanf() function.
Read formatted data (vfscanf()) reads data from a stream into locations specified by a variable number of arguments.
Read formatted data (vsscanf()) reads data from a buffer into locations specified by a variable number of arguments.
Read formatted data (vscanf()) reads data from stdin into locations specified by a variable number of arguments.
Read formatted data (fscanf()) reads data from the current position of the specified stream into the locations that are given by the entries in argument-list, if any.
Read formatted wide character data (vswscanf()) reads wide data from a buffer into locations specified by a variable number of arguments.
Read formatted wide character data (vfwscanf()) reads wide data from a stream into locations specified by a variable number of arguments.
Read the next record (_Rreadn()) reads the next record in the access path that is currently being used for the file that is associated with fp.
Read the previous record (_Rreadp()) reads the previous record in the access path that is currently being used for the file that is associated with fp.
Read the same record (_Rreads()) reads the current record in the access path that is currently being used for the file that is associated with fp.
Read wide character data (swscanf()) specifies a wide string from which the input is to be obtained, rather than from a stream.
Read wide character from stream (fgetwc()) reads the next multibyte character from the input stream pointed to by stream, converts it to a wide character, and advances the associated file position indicator for the stream (if defined).
Read wide character from stream (getwc()) reads the next multibyte character from stream, converts it to a wide character, and advances the associated file position indicator for stream.
Read wide character string from stream (fgetws()) reads at most one less than the number of wide characters specified by n from the stream pointed to by stream.
Record program ending function (atexit()) records the function, pointed to by func, that the system calls at normal program end.
Redirect open files (freopen()) closes the file that is currently associated with stream and reassigns stream to the file that is specified by filename.
Release a program device (_Rrelease()) releases the program device that is specified by dev from the file that is associated with fp.
Release a record lock (_Rrlslck()) releases the lock on the currently locked record for the file specified by fp.
Retrieve locale information (nl_langinfo()) retrieves from the current locale the string that describes the requested information specified by item.
Retrieve wide locale information (wcslocaleconv()) sets the components of a structure having type structure wcslconv to values appropriate for the current locale.
Set characters in string (strnset()) sets, at most, the first n characters of string to c (converted to a char). If n is greater than the length of string, the length of string is used in place of n.
Set default program device (_Rpgmdev()) sets the current program device for the file that is associated with fp to dev.
Set file position (fsetpos()) moves any file position that is associated with stream to a new location within the file according to the value pointed to by pos.
Set locale (setlocale()) changes or queries variables that are defined in the <locale.h> include file, that indicate location.
Tokenize string (strtok()) reads string1 as a series of zero or more tokens, and string2 as the set of characters serving as delimiters of the tokens in string1.
Tokenize string (restartable) (strtok_r()) reads string as a series of zero or more tokens, and seps as the set of characters serving as delimiters of the tokens in string.
Tokenize wide character string (wcstok()) reads wcs1 as a series of zero or more tokens and wcs2 as the set of wide characters serving as delimiters for the tokens in wcs1.
Transform a wide character string (wcsxfrm()) transforms the wide character string pointed to by wcs2 to values which represent character collating weights and places the resulting wide character string into the array pointed to by wcs1.
Transform string (strxfrm()) transforms the string pointed to by string2 and places the result into the string pointed to by string1.
Translate wide character (towctrans()) maps the wide character wc using the mapping that is described by desc.
Update a record (_Rupdate()) updates the record that is currently locked for update in the file that is specified by fp.
Verify condition (assert()) prints a diagnostic message to stderr and aborts the program if expression is false (zero).
Write a character (putc()) converts c to unsigned char and then writes c to the output stream at the current position.
Write a character (putchar()) converts c to unsigned char and then writes c to the output stream at the current position.
Write a record directly (_Rwrited()) writes a record to the file associated with fp at the position specified by rrn.
Write a string (puts()) writes the given string to the standard output stream stdout; it also appends a new-line character to the output.
Write and read a record (_Rwriterd()) performs a write and then a read operation on the file that is specified by fp.
Write buffer to file (fflush()) causes the system to empty the buffer that is associated with the specified output stream, if possible.
Write character (_fputchar()) writes the single character c to the stdout stream at the current position.
Write character (fputc()) converts c to an unsigned char and then writes c to the output stream at the current position and advances the file position appropriately.
Write wide character (fputwc()) converts the wide character wc to a multibyte character and writes it to the output stream pointed to by stream at the current position.
Write wide character (putwc()) converts the wide character wc to a multibyte character, and writes it to the stream at the current position.
Write wide character string (fputws()) converts the wide character string wcs to a multibyte-character string and writes it to stream as a multibyte-character string.
Write wide character to stdout (putwchar()) converts the wide character wc to a multibyte character and writes it to stdout.
manual, SC41-5607.