wcsicmp

Name

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

Library

libc.lib

Synopsis

#include <wchar.h>

int wcsicmp (const wchar_t *wcs1, const wchar_t *wcs2);

Detailed description

The wcsicmp() function compares the 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 wcsicmp() 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 wcsicmp API */
int example_wcsicmp(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 = wcsicmp(ws1,ws2);
  /* 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