wcsncmp_s.c File Reference

#include "safe_str_lib.h"

Include dependency graph for wcsncmp_s.c:

Functions
EXPORT errno_t	wcsncmp_s (const wchar_t *restrict dest, rsize_t dmax, const wchar_t *restrict src, rsize_t smax, rsize_t count, int *diff)
	Compares at most count wide characters of wide string src with wide string dest. More...

Function Documentation

wcsncmp_s()

EXPORT errno_t wcsncmp_s	(	const wchar_t *restrict	dest,
		rsize_t	dmax,
		const wchar_t *restrict	src,
		rsize_t	smax,
		rsize_t	count,
		int *	diff
	)

Compares at most count wide characters of wide string src with wide string dest.

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

[in]	dest	wide string to compare against
[in]	dmax	restricted maximum length of wide string dest
[in]	src	wide string to be compared to dest
[in]	smax	restricted maximum length of wide string src
[in]	count	maximum number of wide characters to compare
[out]	diff	pointer to result diff, greater than 0, equal to 0 or less than 0, if the dest is greater than, equal to or less than src respectively.

Precondition

Neither dest nor src shall be a null pointer.

diff shall not be a null pointer.

dmax/smax shall not be 0

dmax/smax shall not be greater than RSIZE_MAX_WSTR

Returns

diff (when the return code is OK)

Return values

>0	when dest greater than src
0	when wide strings the same
<0	when dest less than src
EOK	when comparison is complete
ESNULLP	when dest/src/diff is NULL pointer
ESZEROL	when dmax/smax = 0
ESLEMAX	when dmax/smax > RSIZE_MAX_WSTR

See also

strcmp_s(), wcscmp_s()