wcsncasecmp

Name

wcsncasecmp - compare two fixed-size wide-character strings, ignoring case

Library

libc.lib

Synopsis

#include <wchar.h>

int wcsncasecmp (const wchar_t *s1, const wchar_t *s2, size_t n);

Return values

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

Detailed description

The wcsncasecmp() function compares atmost n wide-characters from the null-terminated wide-character strings s1 and s2.

Examples

#include <wchar.h>
/* Illustrates how to use wcsncasecmp API */
int example_wcsncasecmp()
{ 
  /* input strings which need 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 = wcsncasecmp(ws1,ws2,11);
  /* returns 0 if they are equal except the case 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