memcpy32_s.c File Reference

#include "safe_mem_lib.h"

Include dependency graph for memcpy32_s.c:

Functions
EXPORT errno_t	memcpy32_s (uint32_t *dest, rsize_t dmax, const uint32_t *src, rsize_t smax)
	This function copies at most smax uint32_ts from src to dest, up to dmax. More...

Function Documentation

memcpy32_s()

EXPORT errno_t memcpy32_s	(	uint32_t *	dest,
		rsize_t	dmax,
		const uint32_t *	src,
		rsize_t	smax
	)

This function copies at most smax uint32_ts from src to dest, up to dmax.

Remarks

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

Parameters

[out]	dest	pointer to the memory that will be replaced by src.
[in]	dmax	maximum length of the resulting dest, in bytes
[in]	src	pointer to the memory that will be copied to dest
[in]	smax	maximum number bytes of src that can be copied

Precondition

Neither dest nor src shall be a null pointer.

dmax shall not be 0.

dmax shall not be greater than RSIZE_MAX_MEM.

smax shall not be greater than dmax.

Copying shall not take place between regions that overlap.

Returns

If there is a runtime-constraint violation, the memcpy_s function stores zeros in the first dmax bytes of the region pointed to by dest if dest is not a null pointer and smax is valid.

Return values

EOK	when operation is successful
ESNULLP	when dst/src is NULL POINTER
ESZEROL	when dmax = ZERO. Before C11 also with smax = ZERO
ESLEMAX	when dmax/smax > RSIZE_MAX_MEM
ESNOSPC	when dmax < smax
ESOVRLP	when src memory overlaps dst

See also

memcpy_s(), memcpy16_s(), memmove_s(), memmove16_s(), memmove32_s()