Epson S5U1C17001C, Руководство пользователя

Страница: 395 / 742

S5U1C17001C ManUal
EPSOn
7-9
(C COMPilEr PaCkagE fOr S1C17 faMily) (Ver. 1.5.0)
7 liBrary
7
Library
7.3 anSi library
7.3.1 Overview
The S1C17 Family C Compiler Package contains an ANSI library.
Each function in this library has ANSI-standard functionality. Certain ANSI library functions not supported by this
package are not included in the ANSI library.
The client assumes responsibility for function implementation and prototype declarations when using ANSI library
functions not listed in Section 7.3.2, “ANSI Library Function List.”
For some ANSI library functions not supported by this package, the header files include only prototype
declarations. In these cases, include the pertinent header file rather than declaring a prototype before implementing
the function.
See the table in Section 4.2.2, “Library Functions and Header Files” for a discussion of ANSI library functions with
prototype declarations only.
The
libc.a
ANSI library file is installed in separate directories (
\gnu17\lib\24bit
and
\gnu17\lib\
16bit
) for each memory model. A
long long
-type ANSI library is included in
libgcc.a (libgccM.a/
libgccMD.a)
.
The following header files which contain definitions of each function are installed in the
include
directory.
stdio.h stdlib.h time.h math.h errno.h float.h limits.h ctype.h
string.h stdarg.h setjmp.h smcvals.h stddef.h
registers used in the library
• The registers
%r0
to
%r7
are used.
• The registers
%r4
to
%r7
are protected by saving to the stack before execution of a function and by restoring
from the stack after completion of the function.
7.3.2 anSi library function list
The contents of the Reentrant column in the tables are as follows:
Reentrant:
Reentrant function
Nonreentrant: Non-reentrant function
Conditional: Non-reentrant function (This function refers to a global variable. It can be used as a reentrant function
if there is no change in the global variable, and your created
read()
and
write()
are reentrant functions.)
input/output functions
The table below lists the input/output functions included in
libc.a
.
Table 7.3.2.1 Input/output functions
Header file:
stdio.h
function functionality reentrant notes
size_t fread (void *ptr, size_t size,
size_t count, FILE *stream);
Input array element from
stdin. Conditional Refer to global variables
stdin
and
_iob
, and call
read
function.
size_t
fwrite
(void *ptr, size_t size,
size_t count, FILE *stream);
Output array element to
stdout. Conditional Refer to global variables
stdout
,
stderr
and
_iob
, and call
write
function.
int fgetc (FILE *stream); Input one character from
stdin. Conditional Refer to global variables
stdin
and
_iob
, and call
read
function.
int getc (FILE *stream); Input one character from
stdin. Conditional Refer to global variables
stdin
and
iob
, and call
read
function.
int getchar ( );
Input one character from
stdin. Conditional Refer to global variables
stdin
and
_iob
, and call
read
function.
int
ungetc
(int c, FILE *stream);
Push one character back
to input buffer. Nonreentrant Refer to global variables
stdin
,
std-
out
,
stderr
, and
_iob
, returned value
overwrite.
char * fgets (char *s, int n, FILE
*stream);
Input character string
from stdin. Conditional Refer to global variables
stdin
and
_iob
, and call
read
function.
char * gets (char *s); Input character string
from stdin. Conditional Refer to global variables
stdin
and
_iob
, and call
read
function.