wcsnicmp

Name

wcsnicmp - compare two wide-character strings, by converting them into lower-case

Library

libc.lib

Synopsis

#include <wchar.h>

int wcsnicmp (const wchar_t *wcs1, const wchar_t *wcs2, int n);

Detailed description

The wcsnicmp() function compares the first n characters from two null-terminated wide-character strings wcs1 and wcs2, by converting them into lower-case. It returns an integer value indicating the status of the comparision.

Return values

The wcsnicmp() returns an integer greater than, equal to, or less than 0, according as wcs1 is lexicographically greater than, equal to, or less than wcs2 after translation of each corresponding character to lower-case. The strings themselves are not modified.

Examples

#include <wchar.h>
/* Illustrates how to use wcsnicmp API */
int example_wcsnicmp(void)
{ 
  /* input strings which needs to be compared */
  wchar_t *ws1=L"testcasecmp";
  wchar_t *ws2=L"TESTCASECMP";
    
  /* function call to compare the two strings which */
  /* differ in case */
  int retval = wcsnicmp(ws1,ws2,12);
  /* returns 0 if they are equal or > 1 */
  /* if first string is greater than second string else -1 */
  return retval;
}

Feedback

For additional information or queries on this page send feedback