strcpyfldout_s.c File Reference

#include "safeclib_private.h"
#include "safe_str_constraint.h"
#include "safe_str_lib.h"

Include dependency graph for strcpyfldout_s.c:

Go to the source code of this file.

Functions
errno_t	strcpyfldout_s (char *dest, rsize_t dmax, const char *src, rsize_t slen)
	The strcpyfldout_s function copies slen characters from the character array pointed to by src into the string pointed to by dest. More...

Function Documentation

strcpyfldout_s()

errno_t strcpyfldout_s	(	char *	dest,
		rsize_t	dmax,
		const char *	src,
		rsize_t	slen
	)

The strcpyfldout_s function copies slen characters from the character array pointed to by src into the string pointed to by dest.

A null is included to properly termiante the dest string. The copy operation does not stop on the null character as function copies dmax characters.

Remarks

EXTENSION TO ISO/IEC TR 24731, Programming languages, environments and system software interfaces, Extensions to the C Library, Part I: Bounds-checking interfaces

Parameters

[out]	dest	pointer to string that will be replaced by src.
[in]	dmax	restricted maximum length of dest
[in]	src	pointer to the character array to be copied to dest and null terminated.
[in]	slen	the maximum number of characters that will be copied from the src field into the dest string.

Precondition

Neither dest nor src shall be a null pointer.

dmax shall not equal zero.

dmax shall not be greater than RSIZE_MAX_STR.

slen shall not equal zero.

slen shall not exceed dmax

Copying shall not take place between objects that overlap.

Returns

If there is a runtime-constraint violation, then if dest is not a null pointer and dmax is greater than zero and not greater than RSIZE_MAX_STR, then strcpyfldout_s nulls dest

Return values

EOK	when successful operation
ESNULLP	when dest/src is NULL pointer
ESZEROL	when dmax/slen = 0
ESLEMAX	when dmax > RSIZE_MAX_STR
ESOVRLP	when strings overlap
ESNOSPC	when dmax < slen

See also

strcpyfld_s(), strcpyfldin_s()

Definition at line 79 of file strcpyfldout_s.c.