memcmp_s.c File Reference

#include "safe_mem_lib.h"

Include dependency graph for memcmp_s.c:

Functions
EXPORT errno_t	memcmp_s (const void *dest, rsize_t dmax, const void *src, rsize_t smax, int *diff)
	Compares memory until they differ, and their difference sign (-1,0,1) is returned in diff. More...

Function Documentation

memcmp_s()

EXPORT errno_t memcmp_s	(	const void *	dest,
		rsize_t	dmax,
		const void *	src,
		rsize_t	smax,
		int *	diff
	)

Compares memory until they differ, and their difference sign (-1,0,1) is returned in diff.

If the block of memory is the same, *diff=0.

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

dest	pointer to memory to compare against
src	pointer to the source memory to compare with dest
dmax	maximum length of dest, in bytes
smax	length of the source memory block
*diff	pointer to the diff which is an integer greater than, equal to or less than zero according to whether the object pointed to by dest is greater than, equal to or less than the object pointed to by src.

Precondition

Neither dest nor src shall be a null pointer.

Neither dmax nor smax shall be 0.

dmax shall not be greater than RSIZE_MAX_MEM.

smax shall not be greater than dmax.

Return values

EOK	when operation is successful
ESNULLP	when dst/src is NULL POINTER
ESZEROL	when dmax/smax = ZERO
ESLEMAX	when dmax/smax > RSIZE_MAX_MEM
ESNOSPC	when dmax < smax

See also

memcmp16_s(), memcmp32_s()