Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

wcsncmp - compare two wide character substrings

&pagelevel(4)&pagelevel

Syntax

#include <wchar.h>

int wcsncmp(const wchar_t *ws1, const wchar_t *ws2, size_t n);

Description

wcsncmp() compares the wide character strings ws1 and ws2 lexically up to a maximum length of n.

For example:

wcsncmp("Sie","Siemens",3)

returns 0 (equal), because the first three characters of both arguments match one another.

Return val.

Integer value:


< 0

In the first n characters, ws1 is lexically less than ws2.


0

In the first n characters, ws1 and ws2 are lexically equal.


> 0

In the first n characters, ws1 is lexically greater than ws2.

Notes

Wide character strings terminated with a null wide character code (\0) are expected as arguments.

The collating sequence is based on the EBCDIC character set.

Restriction
This version of the C runtime system only supports 1-byte characters as wide character codes. They are of type wchar_t (see stddef.h). (End)

See also

wcscmp(), wchar.h.