The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

 NAME

wcsncmp - compare part of two wide-character strings

 SYNOPSIS



#include <wchar.h>

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

 DESCRIPTION

The wcsncmp() function compares not more than n wide-character codes (wide-character codes that follow a null wide-character code are not compared) from the array pointed to by ws1 to the array pointed to by ws2.

The sign of a non-zero return value is determined by the sign of the difference between the values of the first pair of wide-character codes that differ in the objects being compared.

 RETURN VALUE

Upon successful completion, wcsncmp() returns an integer greater than, equal to or less than 0, if the possibly null-terminated array pointed to by ws1 is greater than, equal to or less than the possibly null-terminated array pointed to by ws2 respectively.

 ERRORS

No errors are defined.

 EXAMPLES

None.

 APPLICATION USAGE

None.

 FUTURE DIRECTIONS

None.

 SEE ALSO

wcscmp(), <wchar.h>.

DERIVATION

Derived from the MSE working draft.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]