fprintf_s.c File Reference

#include "safe_lib.h"

Include dependency graph for fprintf_s.c:

Functions
EXPORT int	fprintf_s (FILE *restrict stream, const char *restrict fmt,...)
	The fprintf_s function composes a string via the format string and writes it to a FILE buffer. More...

Function Documentation

fprintf_s()

EXPORT int fprintf_s	(	FILE *restrict	stream,
		const char *restrict	fmt,
			...
	)

The fprintf_s function composes a string via the format string and writes it to a FILE buffer.

Note

POSIX specifies that errno is set on error. However, the safeclib extended ES* errors do not set errno, only when the underlying system vfprintf call fails, errno is set.

Remarks

SPECIFIED IN

• C11 standard (ISO/IEC 9899:2011): K.3.5.3.1 The fprintf_s function (p: 591) http://en.cppreference.com/w/c/io/fprintf

Parameters

[out]	stream	output file stream to write to
[in]	fmt	format-control string.
[in]	...	optional arguments

Precondition

Neither stream nor fmt shall be a null pointer.

fmt shall not contain the conversion specifier n.

None of the arguments corresponding to s is a null pointer. (not yet)

No encoding error shall occur.

Returns

On success the total number of characters written is returned.

On failure a negative number is returned.

Return values

-ESNULLP	when stream/fmt is NULL pointer
-EINVAL	when fmt contains n
-1	on some other error. errno is set then.