sprintf_s.c File Reference

#include "config.h"
#include "safe_str_lib.h"
#include "safe_str_constraint.h"
#include <stdarg.h>

Include dependency graph for sprintf_s.c:

Go to the source code of this file.

Functions
int	sprintf_s (char *restrict dest, rsize_t dmax, const char *restrict fmt,...)
	The sprintf_s function composes a string with same test that would be printed if format was used on printf. More...

Function Documentation

sprintf_s()

int sprintf_s	(	char *restrict	dest,
		rsize_t	dmax,
		const char *restrict	fmt,
			...
	)

The sprintf_s function composes a string with same test that would be printed if format was used on printf.

Instead of being printed, the content is stored in dest.

Remarks

SPECIFIED IN

• C11 standard (ISO/IEC 9899:2011): K.3.5.3.6 The sprintf_s function (p: 595-596) http://en.cppreference.com/w/c/string/byte/sprintf

Parameters

[out]	dest	storage location for output buffer.
[in]	dmax	maximum number of characters to store in buffer.
[in]	fmt	format-control string.
[in]	...	optional arguments

Precondition

Neither dest nor fmt shall be a null pointer.

dmax shall not be greater than RSIZE_MAX_STR.

dmax shall not equal zero.

dmax shall be greater than strnlen_s(dest, dmax).

fmt shall not contain the conversion specifier n

None of the arguments corresponding to s is a null pointer

No encoding error shall occur.

Returns

On success the total number of characters written is returned.

On failure a negative number is returned.

If the buffer dest is too small for the formatted text, including the terminating null, then the buffer is set to an empty string by placing a null character at dest[0], and the invalid parameter handler is invoked. Unlike _snprintf, sprintf_s guarantees that the buffer will be null-terminated unless the buffer size is zero.

Return values

ESNULLP	when dest/fmt is NULL pointer
ESZEROL	when dmax = 0
ESLEMAX	when dmax > RSIZE_MAX_STR
ESNOSPC	when return value exceeds dmax

Definition at line 49 of file sprintf_s.c.