# wcscasecmp

## PROLOG



           This manual page is part of the POSIX Programmer's Manual.  The
           Linux implementation of this interface may differ (consult the
           corresponding Linux manual page for details of Linux behavior), or
           the interface may not be implemented on Linux.
    


## NAME



           wcscasecmp, wcscasecmp_l, wcsncasecmp, wcsncasecmp_l — case-
           insensitive wide-character string comparison
    


## SYNOPSIS



           #include <wchar.h>
    
           int wcscasecmp(const wchar_t *_ws1_ , const wchar_t *_ws2_);
           int wcscasecmp_l(const wchar_t *_ws1_ , const wchar_t *_ws2_ ,
               locale_t _locale_);
           int wcsncasecmp(const wchar_t *_ws1_ , const wchar_t *_ws2_ , size_t _n_);
           int wcsncasecmp_l(const wchar_t *_ws1_ , const wchar_t *_ws2_ ,
               size_t _n_ , locale_t _locale_);
    


## DESCRIPTION



           The _wcscasecmp_() and _wcsncasecmp_() functions are the wide-
           character equivalent of the _strcasecmp_() and _strncasecmp_()
           functions, respectively.
    
           The _wcscasecmp_() and _wcscasecmp_l_() functions shall compare, while
           ignoring differences in case, the wide-character string pointed to
           by _ws1_ to the wide-character string pointed to by _ws2_.
    
           The _wcsncasecmp_() and _wcsncasecmp_l_() functions shall compare,
           while ignoring differences in case, not more than _n_ wide-
           characters from the wide-character string pointed to by _ws1_ to the
           wide-character string pointed to by _ws2_.
    
           The _wcscasecmp_() and _wcsncasecmp_() functions use the current
           locale to determine the case of the wide characters.
    
           The _wcscasecmp_l_() and _wcsncasecmp_l_() functions use the locale
           represented by _locale_ to determine the case of the wide
           characters.
    
           When the _LC_CTYPE_ category of the locale being used is from the
           POSIX locale, these functions shall behave as if the wide-
           character strings had been converted to lowercase and then a
           comparison of wide-character codes performed.  Otherwise, the
           results are unspecified.
    
           The information for _wcscasecmp_l_() and _wcsncasecmp_l_() about the
           case of the characters comes from the locale represented by
           _locale_.
    
           The behavior is undefined if the _locale_ argument to _wcscasecmp_l_()
           or _wcsncasecmp_l_() is the special locale object LC_GLOBAL_LOCALE
           or is not a valid locale object handle.
    


## RETURN VALUE



           Upon completion, the _wcscasecmp_() and _wcscasecmp_l_() functions
           shall return an integer greater than, equal to, or less than 0 if
           the wide-character string pointed to by _ws1_ is, ignoring case,
           greater than, equal to, or less than the wide-character string
           pointed to by _ws2_ , respectively.
    
           Upon completion, the _wcsncasecmp_() and _wcsncasecmp_l_() functions
           shall return an integer greater than, equal to, or less than 0 if
           the possibly null wide-character terminated string pointed to by
           _ws1_ is, ignoring case, greater than, equal to, or less than the
           possibly null wide-character terminated string pointed to by _ws2_ ,
           respectively.
    
           No return values are reserved to indicate an error.
    


## ERRORS



           No errors are defined.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *