XgCrtStdio


Defines

#define EOF   (-1)
 End of file.
#define _IOFBF   0x00
 Fully buffered.
#define _IOLBF   0x01
 Line buffered.
#define _IONBF   0x02
 Unbuffered.
#define stdin   (__iob[0])
 Standard input stream.
#define stdout   (__iob[1])
 Standard output stream.
#define stderr   (__iob[2])
 Standard error output stream.
#define CF_LONG   0x01
#define CF_SUPPRESS   0x02
#define CF_SIGNOK   0x04
#define CF_NDIGITS   0x08
#define CF_PFXOK   0x10
#define CF_NZDIGITS   0x20
#define CF_DPTOK   0x10
#define CF_EXPOK   0x20
#define CT_CHAR   0
#define CT_STRING   2
#define CT_INT   3
#define CT_FLOAT   4
#define BUF   16
#define PADSIZE   16
#define ALT   0x01
#define LADJUST   0x04
#define LONGINT   0x08
#define ZEROPAD   0x10

Typedefs

typedef struct __iobuf FILE
 Stream structure type.

Functions

void clearerr (FILE *stream)
 Reset error status of a stream.
int fclose (FILE *stream)
 Close a stream.
void fcloseall (void)
 Close all open streams.
FILE_fdopen (int fd, CONST char *mode)
 Open a stream associated with a file, device or socket descriptor.
int feof (FILE *stream)
 Test if a stream reached the end of file.
int ferror (FILE *stream)
 Test for an error on a stream.
int fflush (FILE *stream)
 Flush a stream.
int fgetc (FILE *stream)
 Read a character from a stream.
char * fgets (char *buffer, int count, FILE *stream)
 Read a line from a stream.
int _fileno (FILE *stream)
 Get the file descriptor associated with a stream.
void _flushall (void)
 Flushes all streams.
int _fmode (CONST char *mode)
FILEfopen (CONST char *name, CONST char *mode)
 Open a stream.
int fprintf (FILE *stream, CONST char *fmt,...)
 Print formatted data to a stream.
int fprintf_P (FILE *stream, PGM_P fmt,...)
 Print formatted data to a stream.
int fpurge (FILE *stream)
 Purge a stream, i.e. discards the input buffer.
int fputc (int c, FILE *stream)
 Write a character to a stream.
int fputs (CONST char *string, FILE *stream)
 Write a string to a stream.
int fputs_P (PGM_P string, FILE *stream)
 Write a string from progam memory to a stream.
size_t fread (void *buffer, size_t size, size_t count, FILE *stream)
 Read data from a stream.
FILEfreopen (CONST char *name, CONST char *mode, FILE *stream)
 Reassign a stream.
int fscanf (FILE *stream, CONST char *fmt,...)
 Read formatted data from a stream.
int fscanf_P (FILE *stream, PGM_P fmt,...)
 Read formatted data from a stream.
int fseek (FILE *stream, long offset, int origin)
 Move read/write position of a stream.
long ftell (FILE *stream)
 Return the read/write position of a stream.
size_t fwrite (CONST void *data, size_t size, size_t count, FILE *stream)
 Write data to a stream.
size_t fwrite_P (PGM_P data, size_t size, size_t count, FILE *stream)
 Write data from program space to a stream.
int getc (FILE *stream)
 Read a character from a stream.
int getchar (void)
 Read a character from a standard input.
int _getf (int _getb(int, void *, size_t), int fd, CONST char *fmt, va_list ap)
 Read formatted data using a given input function.
char * gets (char *buffer)
 Get a line from the standard input stream.
int printf (CONST char *fmt,...)
 Print formatted data to the standard output stream.
int printf_P (PGM_P fmt,...)
 Print formatted output to the standard output stream.
int putc (int c, FILE *stream)
 Write a character to a stream.
int putchar (int c)
 Write a character to standard output.
static void _putpad (int _putb(int fd, CONST void *, size_t), int fd, char *padch, int count)
int _putf (int _putb(int, CONST void *, size_t), int fd, CONST char *fmt, va_list ap)
 Write formatted data using a given output function.
int puts (CONST char *string)
 Write a string to stdout.
int puts_P (PGM_P string)
 Write a string from program memory to stdout.
int scanf (CONST char *fmt,...)
 Read formatted data from the standard input stream.
int scanf_P (PGM_P fmt,...)
 Read formatted data from the standard input stream.
int sprintf (char *buffer, CONST char *fmt,...)
 Write formatted data to a string.
int sprintf_P (char *buffer, PGM_P fmt,...)
 Write formatted data to a string.
int sscanf (CONST char *string, CONST char *fmt,...)
 Read formatted data from a string.
int sscanf_P (CONST char *string, CONST char *fmt,...)
 Read formatted data from a string.
int ungetc (int c, FILE *stream)
 Push a character back onto a stream.
int vfprintf (FILE *stream, CONST char *fmt, va_list ap)
 Write argument list to a stream using a given format.
int vfprintf_P (FILE *stream, PGM_P fmt, va_list ap)
 Write argument list to a stream using a given format.
int vfscanf (FILE *stream, CONST char *fmt, va_list ap)
 Read formatted data from a stream.
int vfscanf_P (FILE *stream, PGM_P fmt, va_list ap)
 Read formatted data from a stream.
static int _sputb (int fd, CONST void *buffer, size_t count)
int vsprintf (char *buffer, CONST char *fmt, va_list ap)
 Write argument list to a string using a given format.
int vsprintf_P (char *buffer, PGM_P fmt, va_list ap)
 Write argument list to a string using a given format.
static int _sgetb (int fd, void *buffer, size_t count)
int vsscanf (CONST char *string, CONST char *fmt, va_list ap)
 Read formatted data from a string.
int vsscanf_P (CONST char *string, PGM_P fmt, va_list ap)
 Read formatted data from a string.

Variables

FILE__iob []
FILE__iob [FOPEN_MAX] = { (FILE *) 1, (FILE *) 2, (FILE *) 3 }
static char blanks [PADSIZE]
static char zeroes [PADSIZE]

Define Documentation

#define _IOFBF   0x00

Fully buffered.

Definition at line 104 of file stdio.h.

#define _IOLBF   0x01

Line buffered.

Definition at line 105 of file stdio.h.

#define _IONBF   0x02

Unbuffered.

Definition at line 106 of file stdio.h.

#define ALT   0x01

Definition at line 127 of file putf.c.

Referenced by _putf().

#define BUF   16

Definition at line 99 of file putf.c.

Referenced by _putf().

#define CF_DPTOK   0x10

Definition at line 88 of file getf.c.

Referenced by _getf().

#define CF_EXPOK   0x20

Definition at line 89 of file getf.c.

Referenced by _getf().

#define CF_LONG   0x01

Definition at line 82 of file getf.c.

Referenced by _getf().

#define CF_NDIGITS   0x08

Definition at line 85 of file getf.c.

Referenced by _getf().

#define CF_NZDIGITS   0x20

Definition at line 87 of file getf.c.

Referenced by _getf().

#define CF_PFXOK   0x10

Definition at line 86 of file getf.c.

Referenced by _getf().

#define CF_SIGNOK   0x04

Definition at line 84 of file getf.c.

Referenced by _getf().

#define CF_SUPPRESS   0x02

Definition at line 83 of file getf.c.

Referenced by _getf().

#define CT_CHAR   0

Definition at line 94 of file getf.c.

Referenced by _getf().

#define CT_FLOAT   4

Definition at line 97 of file getf.c.

Referenced by _getf().

#define CT_INT   3

Definition at line 96 of file getf.c.

Referenced by _getf().

#define CT_STRING   2

Definition at line 95 of file getf.c.

Referenced by _getf().

#define EOF   (-1)

End of file.

Returned by an input or output operation when the end of a file is encountered. Some routines return this value to indicate an error.

Definition at line 100 of file stdio.h.

Referenced by _fdopen(), _fmode(), _getf(), fclose(), fflush(), fgetc(), fgets(), fopen(), fpurge(), fputc(), freopen(), gets(), puts(), puts_P(), ungetc(), and wgetch().

#define LADJUST   0x04

Definition at line 128 of file putf.c.

Referenced by _putf().

#define LONGINT   0x08

Definition at line 129 of file putf.c.

Referenced by _putf().

#define PADSIZE   16

Definition at line 103 of file putf.c.

Referenced by _putpad().

#define stderr   (__iob[2])

Standard error output stream.

Definition at line 124 of file stdio.h.

#define stdin   (__iob[0])

Standard input stream.

Definition at line 122 of file stdio.h.

Referenced by getchar(), gets(), kbhit(), scanf(), and scanf_P().

#define stdout   (__iob[1])

Standard output stream.

Definition at line 123 of file stdio.h.

Referenced by printf(), printf_P(), putchar(), puts(), and puts_P().

#define ZEROPAD   0x10

Definition at line 130 of file putf.c.

Referenced by _putf().


Typedef Documentation

typedef struct __iobuf FILE

Stream structure type.

A pointer to this type is used for all standard I/O functions to specify a stream.

Note:
Applications should make any assumptions about the contents of this structure as it may change without further notice.

Definition at line 118 of file stdio.h.


Function Documentation

FILE* _fdopen ( int  fd,
CONST char *  mode 
)

Open a stream associated with a file, device or socket descriptor.

Parameters:
fd Descriptor of a previously opened file, device or connected socket.
mode Specifies the access mode.
  • "r" Read only.
  • "w" Write only.
  • "a" Write only at the end of file.
  • "r+" Read and write existing file.
  • "w+" Read and write, destroys existing file contents.
  • "a+" Read and write, preserves existing file contents.
  • "b" May be appended to any of the above strings to specify binary access.
Returns:
A pointer to the open stream or a null pointer to indicate an error.

Definition at line 74 of file fdopen.c.

References __iob, _fmode(), ENFILE, ENOMEM, EOF, errno, FCNTL_TEXT, FOPEN_MAX, __iobuf::iob_fd, __iobuf::iob_flags, __iobuf::iob_mode, __iobuf::iob_unget, and malloc.

int _fileno ( FILE stream  ) 

Get the file descriptor associated with a stream.

In contrast to other implementations, the standard streams stdin, stdout and stderr do not return 0, 1 and 2 resp.

Parameters:
stream Pointer to a previously opened stream.
Returns:
The file descriptor.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 66 of file fileno.c.

References __iobuf::iob_fd.

Referenced by kbhit(), vfscanf(), and vfscanf_P().

void _flushall ( void   ) 

Flushes all streams.

Definition at line 57 of file flushall.c.

References __iob, fflush(), and FOPEN_MAX.

int _fmode ( CONST char *  mode  ) 

Definition at line 63 of file fmode.c.

References EINVAL, EOF, errno, FCNTL_APPEND, FCNTL_BINARY, FCNTL_CREATE, FCNTL_RDONLY, FCNTL_TEXT, FCNTL_TRUNC, and FCNTL_WRONLY.

Referenced by _fdopen(), fopen(), and freopen().

int _getf ( int   _getbint, void *, size_t,
int  fd,
CONST char *  fmt,
va_list  ap 
)

Read formatted data using a given input function.

Parameters:
_getb Input function for reading data.
fd Descriptor of a previously opened file, device or connected socket.
fmt Format string containing coversion specifications.
ap List of pointer arguments.
Returns:
The number of fields successfully converted and assigned. The return value is EOF, if an error occurs or if the end of the stream is reached before the first conversion.

Definition at line 112 of file getf.c.

References CF_DPTOK, CF_EXPOK, CF_LONG, CF_NDIGITS, CF_NZDIGITS, CF_PFXOK, CF_SIGNOK, CF_SUPPRESS, CT_CHAR, CT_FLOAT, CT_INT, CT_STRING, EOF, isspace(), strtod(), and strtol().

Referenced by vfscanf(), vfscanf_P(), vsscanf(), and vsscanf_P().

int _putf ( int   _putbint, CONST void *, size_t,
int  fd,
CONST char *  fmt,
va_list  ap 
)

Write formatted data using a given output function.

Parameters:
_putb Output function for writing data.
fd Descriptor of a previously opened file, device or connected socket.
fmt Format string containing conversion specifications.
ap List of arguments.

Definition at line 143 of file putf.c.

References _putpad(), ALT, blanks, BUF, dtostre(), dtostrf(), free, LADJUST, LONGINT, malloc, memchr(), strcpy_P, strlen(), strlen_P, zeroes, and ZEROPAD.

Referenced by vfprintf(), vfprintf_P(), vsprintf(), and vsprintf_P().

static void _putpad ( int   _putbint fd, CONST void *, size_t,
int  fd,
char *  padch,
int  count 
) [static]

Definition at line 114 of file putf.c.

References PADSIZE.

Referenced by _putf().

static int _sgetb ( int  fd,
void *  buffer,
size_t  count 
) [static]

Definition at line 63 of file vsscanf.c.

Referenced by vsscanf(), and vsscanf_P().

static int _sputb ( int  fd,
CONST void *  buffer,
size_t  count 
) [static]

Definition at line 59 of file vsprintf.c.

References memcpy().

Referenced by vsprintf(), and vsprintf_P().

void clearerr ( FILE stream  ) 

Reset error status of a stream.

Parameters:
stream Pointer to a previously opened stream.
Note:
This function does nothing.

Definition at line 61 of file clrerr.c.

int fclose ( FILE stream  ) 

Close a stream.

The calling thread may be suspended until all buffered output data has been written.

Parameters:
stream Pointer to a previously opened stream.
Returns:
0 if the stream is successfully closed, EOF otherwise.

Definition at line 69 of file fclose.c.

References __iob, _close(), EBADF, EOF, errno, FOPEN_MAX, free, and __iobuf::iob_fd.

Referenced by fcloseall().

void fcloseall ( void   ) 

Close all open streams.

The standard streams stdin, stdout and stderr are not closed.

The calling thread may be suspended until all buffered output data has been written.

Definition at line 60 of file fcloseall.c.

References __iob, fclose(), and FOPEN_MAX.

int feof ( FILE stream  ) 

Test if a stream reached the end of file.

Parameters:
stream Pointer to a previously opened stream.
Returns:
0 if the current position is not the end of the file.

Definition at line 61 of file feof.c.

References _IOEOF, and __iobuf::iob_flags.

int ferror ( FILE stream  ) 

Test for an error on a stream.

Parameters:
stream Pointer to a previously opened stream.
Returns:
0 if no error occured.

Definition at line 62 of file ferror.c.

References _IOERR, and __iobuf::iob_flags.

int fflush ( FILE stream  ) 

Flush a stream.

The calling thread may be suspended until all buffered output data has been written.

Parameters:
stream Pointer to a previously opened stream.
Returns:
0 if the buffer was successfully flushed, EOF if an error occured.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 67 of file fflush.c.

References _write(), EOF, and __iobuf::iob_fd.

Referenced by _flushall().

int fgetc ( FILE stream  ) 

Read a character from a stream.

Parameters:
stream Pointer to a previously opened stream.
Returns:
Character read or EOF to indicate an error or end of file. In the latter case feof() or ferror() can be used to determine the cause of the failure.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 71 of file fgetc.c.

References _IOEOF, _IOERR, _IOUNG, _read(), EOF, __iobuf::iob_fd, __iobuf::iob_flags, and __iobuf::iob_unget.

Referenced by fgets(), getc(), getchar(), gets(), and wgetch().

char* fgets ( char *  buffer,
int  count,
FILE stream 
)

Read a line from a stream.

Read at most one less than the specified number of characters from a stream or stop when a newline has been read.

Parameters:
buffer Pointer to the buffer that receives the data including the linefeed character.
count Maximum number of characters to read.
stream Pointer to a previously opened stream.
Returns:
Pointer to the given buffer or NULL to indicate an error or the end of the file.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 68 of file fgets.c.

References EOF, and fgetc().

FILE* fopen ( CONST char *  name,
CONST char *  mode 
)

Open a stream.

Parameters:
name The name of a registered device, optionally followed by a colon and a filename.
mode Specifies the access mode.
  • "r" Read only.
  • "w" Write only.
  • "a" Write only at the end of file.
  • "r+" Read and write existing file.
  • "w+" Read and write, destroys existing file contents.
  • "a+" Read and write, preserves existing file contents.
  • "b" May be appended to any of the above strings to specify binary access.
Returns:
A pointer to the open stream or a null pointer to indicate an error.

Definition at line 76 of file fopen.c.

References _fmode(), _open(), ENFILE, EOF, errno, FCNTL_TEXT, FOPEN_MAX, free, __iobuf::iob_flags, __iobuf::iob_mode, __iobuf::iob_unget, and malloc.

int fprintf ( FILE stream,
CONST char *  fmt,
  ... 
)

Print formatted data to a stream.

Parameters:
stream Pointer to a previously opened stream.
fmt Format string containing conversion specifications.
Returns:
The number of characters written or a negative value to indicate an error.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 63 of file fprintf.c.

References vfprintf().

int fprintf_P ( FILE stream,
PGM_P  fmt,
  ... 
)

Print formatted data to a stream.

Similar to fprintf() except that the format string is located in program memory.

Parameters:
stream Pointer to a previously opened stream.
fmt Format string in program space containing conversion specifications.
Returns:
The number of bytes written or a negative value to indicate an error.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Do not use this function with a debug device while running in interrupt context.

Definition at line 73 of file fprintf_p.c.

References vfprintf_P.

int fpurge ( FILE stream  ) 

Purge a stream, i.e. discards the input buffer.

Parameters:
stream Pointer to a previously opened stream.
Returns:
0 if the buffer was successfully purged, EOF if an error occured.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 62 of file fpurge.c.

References _read(), EOF, and __iobuf::iob_fd.

int fputc ( int  c,
FILE stream 
)

Write a character to a stream.

Parameters:
c Character to write.
stream Pointer to a previously opened stream.
Returns:
The character written or EOF to indicate an error.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 65 of file fputc.c.

References _write(), EOF, and __iobuf::iob_fd.

Referenced by putc(), putchar(), puts(), and puts_P().

int fputs ( CONST char *  string,
FILE stream 
)

Write a string to a stream.

Parameters:
stream Pointer to a previously opened stream.
string String to write.
Returns:
A non-negative value if successful or EOF to indicate an error.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 66 of file fputs.c.

References _write(), __iobuf::iob_fd, and strlen().

Referenced by puts().

int fputs_P ( PGM_P  string,
FILE stream 
)

Write a string from progam memory to a stream.

Similar to fputs() except that the string is located in program space.

Parameters:
stream Pointer to a previously opened stream.
string String in program memory to write.
Returns:
A non-negative value if successful or EOF to indicate an error.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 69 of file fputs_p.c.

References _write_P(), __iobuf::iob_fd, and strlen_P.

size_t fread ( void *  buffer,
size_t  size,
size_t  count,
FILE stream 
)

Read data from a stream.

Parameters:
buffer Pointer to the buffer that receives the data.
size Item size in bytes.
count Maximum number of items to read.
stream Pointer to a previously opened stream.
Returns:
The number of full items read, which may be less then the specified number.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 71 of file fread.c.

References _IOEOF, _IOERR, _IOUNG, _read(), __iobuf::iob_fd, __iobuf::iob_flags, and __iobuf::iob_unget.

FILE* freopen ( CONST char *  name,
CONST char *  mode,
FILE stream 
)

Reassign a stream.

Parameters:
name The name of a registered device, optionally followed by a colon and a filename.
mode Specifies the access mode.
  • "r" Read only.
  • "w" Write only.
  • "a" Write only at the end of file.
  • "r+" Read and write existing file.
  • "w+" Read and write, destroys existing file contents.
  • "a+" Read and write, preserves existing file contents.
  • "b" May be appended to any of the above strings to specify binary access.
stream Pointer to a previously opened stream.
Returns:
A pointer to the open stream or a null pointer to indicate an error.

Definition at line 82 of file freopen.c.

References __iob, _fmode(), _open(), EBADF, EOF, errno, FCNTL_TEXT, FOPEN_MAX, free, __iobuf::iob_flags, __iobuf::iob_mode, __iobuf::iob_unget, and malloc.

int fscanf ( FILE stream,
CONST char *  fmt,
  ... 
)

Read formatted data from a stream.

Parameters:
stream Pointer to a previously opened stream.
fmt Format string containing conversion specifications.
Returns:
The number of fields successfully converted and assigned. The return value is EOF, if an error occurs or if the end of the stream is reached before the first conversion.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 64 of file fscanf.c.

References vfscanf().

int fscanf_P ( FILE stream,
PGM_P  fmt,
  ... 
)

Read formatted data from a stream.

Similar to fscanf() except that the format string is expected in program space.

Parameters:
stream Pointer to a previously opened stream.
fmt Format string in program space containing conversion specifications.
Returns:
The number of fields successfully converted and assigned. The return value is EOF, if an error occurs or if the end of the stream is reached before the first conversion.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 68 of file fscanf_p.c.

References vfscanf_P.

int fseek ( FILE stream,
long  offset,
int  origin 
)

Move read/write position of a stream.

Parameters:
stream Pointer to a previously opened stream.
offset Number of bytes from initial position.
origin Initial position to seek from.
Returns:
0 if no error occured. -1 on error. Errno is set

Definition at line 65 of file fseek.c.

References _seek(), and __iobuf::iob_fd.

long ftell ( FILE stream  ) 

Return the read/write position of a stream.

Parameters:
stream Pointer to a previously opened stream.
Returns:
The current position.

Definition at line 63 of file ftell.c.

References _tell(), and __iobuf::iob_fd.

size_t fwrite ( CONST void *  data,
size_t  size,
size_t  count,
FILE stream 
)

Write data to a stream.

Parameters:
data Pointer to items to be written.
size Item size in bytes.
count Number of items to write.
stream Pointer to a previously opened stream.
Returns:
The number of items written, which may be less than the specified number.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 75 of file fwrite.c.

References _write(), and __iobuf::iob_fd.

size_t fwrite_P ( PGM_P  data,
size_t  size,
size_t  count,
FILE stream 
)

Write data from program space to a stream.

Similar to fwrite() except that the data is located in program memory.

Parameters:
data Pointer to items in program space to be written.
size Item size in bytes.
count Number of items to write.
stream Pointer to a previously opened stream.
Returns:
The number of items written, which may be less than the specified number.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 69 of file fwrite_p.c.

References _write_P(), and __iobuf::iob_fd.

int getc ( FILE stream  ) 

Read a character from a stream.

Same as fgetc().

Parameters:
stream Pointer to a previously opened stream.
Returns:
Character read or EOF to indicate an error or end of file.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 66 of file getc.c.

References fgetc().

int getchar ( void   ) 

Read a character from a standard input.

Returns:
Character read or EOF to indicate an error or end of file.

Definition at line 56 of file getchar.c.

References fgetc(), and stdin.

char* gets ( char *  buffer  ) 

Get a line from the standard input stream.

Read characters from a stream until a newline has been read.

Parameters:
buffer Pointer to the buffer that receives the line excluding the linefeed character.
Returns:
The given argument on success, 0 otherwise.
Warning:
This function is potentially unsafe, because it may write pass the end of the buffer.

Definition at line 64 of file gets.c.

References EOF, fgetc(), and stdin.

int printf ( CONST char *  fmt,
  ... 
)

Print formatted data to the standard output stream.

Parameters:
fmt Format string containing conversion specifications.
Returns:
The number of characters written or a negative value to indicate an error.

Definition at line 60 of file printf.c.

References stdout, and vfprintf().

int printf_P ( PGM_P  fmt,
  ... 
)

Print formatted output to the standard output stream.

Similar to printf() except that the format string is located in program memory.

Parameters:
fmt Format string in program space containing conversion specifications.
Returns:
The number of characters written or a negative value to indicate an error.
Warning:
Do not use this function with a debug device while running in interrupt context.

Definition at line 70 of file printf_p.c.

References stdout, and vfprintf_P.

int putc ( int  c,
FILE stream 
)

Write a character to a stream.

Same as fputc().

Parameters:
c Character to write.
stream Pointer to a previously opened stream.
Returns:
The character written or EOF to indicate an error.
Warning:
The function will not check, if the stream pointer points to a valid stream.

Definition at line 67 of file putc.c.

References fputc().

int putchar ( int  c  ) 

Write a character to standard output.

Parameters:
c Character to write.
Returns:
The character written or EOF to indicate an error.

Definition at line 61 of file putchar.c.

References fputc(), and stdout.

int puts ( CONST char *  string  ) 

Write a string to stdout.

Parameters:
string String to write.
Returns:
A non-negative value or EOF to indicate an error.

Definition at line 58 of file puts.c.

References EOF, fputc(), fputs(), and stdout.

int puts_P ( PGM_P  string  ) 

Write a string from program memory to stdout.

Similar to puts() except that the string is located in program memory.

Parameters:
string String in program memory to write.
Returns:
A non-negative value or EOF to indicate an error.

Definition at line 61 of file puts_p.c.

References EOF, fputc(), fputs_P, and stdout.

int scanf ( CONST char *  fmt,
  ... 
)

Read formatted data from the standard input stream.

Parameters:
fmt Format string containing conversion specifications.
Returns:
The number of fields successfully converted and assigned. The return value is EOF, ff an error occurs or if the end of the stream is reached before the first conversion.

Definition at line 60 of file scanf.c.

References stdin, and vfscanf().

int scanf_P ( PGM_P  fmt,
  ... 
)

Read formatted data from the standard input stream.

Similar to scanf() except that the format string is located in program space.

Parameters:
fmt Format string containing conversion specifications.
Returns:
The number of fields successfully converted and assigned. The return value is EOF, ff an error occurs or if the end of the stream is reached before the first conversion.

Definition at line 63 of file scanf_p.c.

References stdin, and vfscanf_P.

int sprintf ( char *  buffer,
CONST char *  fmt,
  ... 
)

Write formatted data to a string.

Parameters:
buffer Pointer to a buffer that receives the output string.
fmt Format string containing conversion specifications.
Returns:
The number of characters written or a negative value to indicate an error.

Definition at line 61 of file sprintf.c.

References vsprintf().

int sprintf_P ( char *  buffer,
PGM_P  fmt,
  ... 
)

Write formatted data to a string.

Similar to sprintf() except that the format string is located in program memory.

Parameters:
buffer Pointer to a buffer that receives the output string.
fmt Format string in program space containing conversion specifications.
Returns:
The number of characters written or a negative value to indicate an error.

Definition at line 68 of file sprintf_p.c.

References vsprintf_P.

int sscanf ( CONST char *  string,
CONST char *  fmt,
  ... 
)

Read formatted data from a string.

Parameters:
string Pointer to the string that contains the data.
fmt Format string containing conversion specifications.
Returns:
The number of fields successfully converted and assigned. The return value is EOF, if an error occurs or if the end of the stream is reached before the first conversion.

Definition at line 61 of file sscanf.c.

References vsscanf().

int sscanf_P ( CONST char *  string,
CONST char *  fmt,
  ... 
)

Read formatted data from a string.

Similar to sscanf() except that the format string is located in program space.

Parameters:
string Pointer to the string that contains the data.
fmt Format string in program space containing conversion specifications.
Returns:
The number of fields successfully converted and assigned. The return value is EOF, if an error occurs or if the end of the stream is reached before the first conversion.

Definition at line 65 of file sscanf_p.c.

References vsscanf_P.

int ungetc ( int  c,
FILE stream 
)

Push a character back onto a stream.

Parameters:
c Character to push back.
stream Pointer to a previously opened stream.
Warning:
Only a single character can be pushed back. Any previously pushed and not yet read character will be lost.

Definition at line 60 of file ungetc.c.

References _IOUNG, EOF, __iobuf::iob_flags, and __iobuf::iob_unget.

int vfprintf ( FILE stream,
CONST char *  fmt,
va_list  ap 
)

Write argument list to a stream using a given format.

Parameters:
stream Pointer to a previously opened stream.
fmt Format string containing conversion specifications.
ap List of arguments.
Returns:
The number of characters written or a negative value to indicate an error.

Definition at line 63 of file vfprintf.c.

References _putf(), _write(), and __iobuf::iob_fd.

Referenced by fprintf(), and printf().

int vfprintf_P ( FILE stream,
PGM_P  fmt,
va_list  ap 
)

Write argument list to a stream using a given format.

Similar to vfprintf() except that the format string is located in program memory.

Parameters:
stream Pointer to a previously opened stream.
fmt Format string in program space containing conversion specifications.
ap List of arguments.
Returns:
The number of characters written or a negative value to indicate an error.

Definition at line 70 of file vfprintf_p.c.

References _putf(), _write(), __iobuf::iob_fd, memcpy_P, NutHeapAlloc(), NutHeapFree(), and strlen_P.

int vfscanf ( FILE stream,
CONST char *  fmt,
va_list  ap 
)

Read formatted data from a stream.

Parameters:
stream Pointer to a previously opened stream.
fmt Format string containing conversion specifications.
ap List of pointer arguments.
Returns:
The number of fields successfully converted and assigned. The return value is EOF, if an error occurs or if the end of the stream is reached before the first conversion.

Definition at line 66 of file vfscanf.c.

References _fileno(), _getf(), and _read().

Referenced by fscanf(), and scanf().

int vfscanf_P ( FILE stream,
PGM_P  fmt,
va_list  ap 
)

Read formatted data from a stream.

Similar to vfscanf() except that the format string is located in program space.

Parameters:
stream Pointer to a previously opened stream.
fmt Format string in program space containing conversion specifications.
ap List of pointer arguments.
Returns:
The number of fields successfully converted and assigned. The return value is EOF, if an error occurs or if the end of the stream is reached before the first conversion.

Definition at line 73 of file vfscanf_p.c.

References _fileno(), _getf(), _read(), memcpy_P, NutHeapAlloc(), NutHeapFree(), and strlen_P.

int vsprintf ( char *  buffer,
CONST char *  fmt,
va_list  ap 
)

Write argument list to a string using a given format.

Parameters:
buffer Pointer to a buffer that receives the output string.
fmt Format string containing conversion specifications.
ap List of arguments.
Returns:
The number of characters written or a negative value to indicate an error.

Definition at line 79 of file vsprintf.c.

References _putf(), and _sputb().

Referenced by prnt(), and sprintf().

int vsprintf_P ( char *  buffer,
PGM_P  fmt,
va_list  ap 
)

Write argument list to a string using a given format.

Similar to vsprintf() except that the format string is located in program memory.

Parameters:
buffer Pointer to a buffer that receives the output string.
fmt Format string in program space containing conversion specifications.
ap List of arguments.
Returns:
The number of characters written or a negative value to indicate an error.

Definition at line 81 of file vsprintf_p.c.

References _putf(), _sputb(), memcpy_P, NutHeapAlloc(), NutHeapFree(), and strlen_P.

int vsscanf ( CONST char *  string,
CONST char *  fmt,
va_list  ap 
)

Read formatted data from a string.

Parameters:
string Pointer to a string that contains the data.
fmt Format string containing conversion specifications.
ap List of pointer arguments.
Returns:
The number of fields successfully converted and assigned. The return value is EOF, if an error occurs or if the end of the stream is reached before the first conversion.

Definition at line 91 of file vsscanf.c.

References _getf(), _sgetb(), and CONST.

Referenced by sscanf().

int vsscanf_P ( CONST char *  string,
PGM_P  fmt,
va_list  ap 
)

Read formatted data from a string.

Similar to vsscanf() except that the format string is located in program space.

Parameters:
string Pointer to a string that contains the data.
fmt Format string in program space containing conversion specifications.
ap List of pointer arguments.
Returns:
The number of fields successfully converted and assigned. The return value is EOF, if an error occurs or if the end of the stream is reached before the first conversion.

Definition at line 93 of file vsscanf_p.c.

References _getf(), _sgetb(), CONST, memcpy_P, NutHeapAlloc(), NutHeapFree(), and strlen_P.


Variable Documentation

FILE* __iob[FOPEN_MAX] = { (FILE *) 1, (FILE *) 2, (FILE *) 3 }

Definition at line 56 of file fopen.c.

Referenced by _fdopen(), _flushall(), fclose(), fcloseall(), and freopen().

FILE* __iob[]

Definition at line 56 of file fopen.c.

Referenced by _fdopen(), _flushall(), fclose(), fcloseall(), and freopen().

char blanks[PADSIZE] [static]

Initial value:

 { ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ',
    ' ', ' '
}

Definition at line 104 of file putf.c.

Referenced by _putf().

char zeroes[PADSIZE] [static]

Initial value:

 { '0', '0', '0', '0', '0', '0', '0', '0', '0', '0', '0', '0', '0', '0',
    '0', '0'
}

Definition at line 107 of file putf.c.

Referenced by _putf().


Generated on Sun Aug 31 13:31:34 2008 for FrankenRTOS by  doxygen 1.5.6