stdio.h File Reference

#include <pthread.h>
#include <stdarg.h>
#include <stddef.h>
#include <stdint.h>
#include <sys/reent.h>
#include <sys/types.h>

Include dependency graph for stdio.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
union	FILE

Macros
#define	SEEK_SET   0
#define	SEEK_CUR   1
#define	SEEK_END   2
#define	fopen   _fopen
#define	fclose   _fclose
#define	fread   _fread
#define	fwrite   _fwrite
#define	fseek   _fseek
#define	fileno   _fileno
#define	__SIZEOF_FILE   sizeof(__FILE)

Functions
FILE *	fopen (const char *pathname, const char *mode)
	Open the file whose name is the string pointed to by pathname and associate a stream with it. More...
int	fclose (FILE *stream)
	Close the given file stream. More...
size_t	fread (void *ptr, size_t size, size_t nmemb, FILE *stream)
	Read nmemb items of data, each size bytes long, from the stream pointed to by stream, storing them at the location given by ptr. More...
size_t	fwrite (const void *ptr, size_t size, size_t nmemb, FILE *stream)
	Write nmemb items of data, each size bytes long, to the stream pointed to by stream, obtaining them from the location given by ptr. More...
int	fseek (FILE *stream, long offset, int whence)
	Set the file position indicator for the stream pointed to by stream. More...
int	fileno (FILE *stream)
	Examine the argument stream and returns the integer file descriptor used to implement this stream. More...
int	printf (const char *format,...)
	Format and print data to the standard output. More...
int	fprintf (FILE *stream, const char *format,...)
	Format and print data to a file. More...
int	dprintf (int fd, const char *format,...)
	Format and print data to a file. More...
int	sprintf (char *str, const char *format,...)
	Format and print data to a buffer. More...
int	snprintf (char *str, size_t size, const char *format,...)
	Format and print data to a buffer with limited buffer size. More...
int	vprintf (const char *format, va_list ap)
	Format and print data to the standard output with argument list. More...
int	vfprintf (FILE *stream, const char *format, va_list ap)
	Format and print data to a file with argument list. More...
int	vdprintf (int fd, const char *format, va_list ap)
	Format and print data to a file with argument list. More...
int	vsprintf (char *str, const char *format, va_list ap)
	Format and print data to a buffer with argument list. More...
int	vsnprintf (char *str, size_t size, const char *format, va_list ap)
	Format and print data to a buffer with limited size and argument list. More...

Variables
FILE *	stdin
FILE *	stdout
FILE *	stderr

Function Documentation

dprintf()

int dprintf	(	int	fd,
		const char *	format,
			...
	)

Format and print data to a file.

Parameters

str	The pointer to the print buffer.
format	Format string.
...	Print arguments.

Return values

Upon	successful return, the function returns the number of characters printed; otherwie a negative value is returned.

fclose()

int fclose

(

FILE *

stream

)

Close the given file stream.

Parameters

stream

The file stream to provide.

Return values

int	0 on success and nonzero error number on error.

fileno()

int fileno

(

FILE *

stream

)

Examine the argument stream and returns the integer file descriptor used to implement this stream.

Parameters

stream

The file stream to provide.

Return values

int	The file descriptor integer.

fopen()

FILE* fopen	(	const char *	pathname,
		const char *	mode
	)

Open the file whose name is the string pointed to by pathname and associate a stream with it.

Parameters

pathname	The pathname of the file to open.
mode	Not used.

Return values

FILE	*: File stream object.

fprintf()

int fprintf	(	FILE *	stream,
		const char *	format,
			...
	)

Format and print data to a file.

Parameters

stream	The pointer to the file stream.
format	Format string.
...	Print arguments.

Return values

Upon	successful return, the function returns the number of characters printed; otherwie a negative value is returned.

fread()

size_t fread	(	void *	ptr,
		size_t	size,
		size_t	nmemb,
		FILE *	stream
	)

Read nmemb items of data, each size bytes long, from the stream pointed to by stream, storing them at the location given by ptr.

Parameters

ptr	The memory space for storing the read data.
size	The number of nmemb bytes to read.
nmemb	The bytes number to read at once.
stream	The file stream to provide.

Return values

int	The read number on success and nonzero error number on error.

fseek()

int fseek	(	FILE *	stream,
		long	offset,
		int	whence
	)

Set the file position indicator for the stream pointed to by stream.

Parameters

stream	The file stream to provide.
offset	The new offset to the position specified by whence.
whence	The start position of the new offset.

Return values

int	The new file position on success and nonzero error number on error.

fwrite()

size_t fwrite	(	const void *	ptr,
		size_t	size,
		size_t	nmemb,
		FILE *	stream
	)

Write nmemb items of data, each size bytes long, to the stream pointed to by stream, obtaining them from the location given by ptr.

Parameters

ptr	The data to write to the file.
size	The number of nmemb bytes to write.
nmemb	The byte number to write at once.
stream	The file stream to provide.

Return values

int	The write number on success and nonzero error number on error.

printf()

int printf	(	const char *	format,
			...
	)

Format and print data to the standard output.

Parameters

format	Format string.
...	Print arguments.

Return values

Upon	successful return, the function returns the number of characters printed; otherwie a negative value is returned.

snprintf()

int snprintf	(	char *	str,
		size_t	size,
		const char *	format,
			...
	)

Format and print data to a buffer with limited buffer size.

Parameters

str	The pointer to the print buffer.
size	The size of the buffer.
format	Format string.
...	Print arguments.

Return values

Upon	successful return, the function returns the number of characters printed; otherwie a negative value is returned.

sprintf()

int sprintf	(	char *	str,
		const char *	format,
			...
	)

Format and print data to a buffer.

Parameters

str	The pointer to the print buffer.
format	Format string.
...	Print arguments.

Return values

Upon	successful return, the function returns the number of characters printed; otherwie a negative value is returned.

vdprintf()

int vdprintf	(	int	fd,
		const char *	format,
		va_list	ap
	)

Format and print data to a file with argument list.

Parameters

	fd: File descriptor number.
format	Format string.
ap	Argument list.

Return values

Upon	successful return, the function returns the number of characters printed; otherwie a negative value is returned.

vfprintf()

int vfprintf	(	FILE *	stream,
		const char *	format,
		va_list	ap
	)

Format and print data to a file with argument list.

Parameters

stream	The pointer to the file stream.
format	Format string.
ap	Argument list.

Return values

Upon	successful return, the function returns the number of characters printed; otherwie a negative value is returned.

vprintf()

int vprintf	(	const char *	format,
		va_list	ap
	)

Format and print data to the standard output with argument list.

Parameters

format	Format string.
ap	Argument list.

Return values

Upon	successful return, the function returns the number of characters printed; otherwie a negative value is returned.

vsnprintf()

int vsnprintf	(	char *	str,
		size_t	size,
		const char *	format,
		va_list	ap
	)

Format and print data to a buffer with limited size and argument list.

Parameters

str	The pointer to the print buffer.
size	The size of the buffer.
format	Format string.
ap	Argument list.

Return values

Upon	successful return, the function returns the number of characters printed; otherwie a negative value is returned.

vsprintf()

int vsprintf	(	char *	str,
		const char *	format,
		va_list	ap
	)

Format and print data to a buffer with argument list.

Parameters

str	The pointer to the print buffer.
size	The size of the buffer.
format	Format string.
ap	Argument list.

Return values

Upon	successful return, the function returns the number of characters printed; otherwie a negative value is returned.