Movatterモバイル変換

wcscasecmp(3p) — Linux manual page

WCSCASECMP(3P)          POSIX Programmer's ManualWCSCASECMP(3P)

PROLOG        top

       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        top

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

SYNOPSIS        top

       #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_tlocale);       int wcsncasecmp(const wchar_t *ws1, const wchar_t *ws2, size_tn);       int wcsncasecmp_l(const wchar_t *ws1, const wchar_t *ws2,           size_tn, locale_tlocale);

DESCRIPTION        top

       Thewcscasecmp() andwcsncasecmp() functions are the wide-       character equivalent of thestrcasecmp() andstrncasecmp()       functions, respectively.       Thewcscasecmp() andwcscasecmp_l() functions shall compare, while       ignoring differences in case, the wide-character string pointed to       byws1 to the wide-character string pointed to byws2.       Thewcsncasecmp() andwcsncasecmp_l() functions shall compare,       while ignoring differences in case, not more thann wide-       characters from the wide-character string pointed to byws1 to the       wide-character string pointed to byws2.       Thewcscasecmp() andwcsncasecmp() functions use the current       locale to determine the case of the wide characters.       Thewcscasecmp_l() andwcsncasecmp_l() functions use the locale       represented bylocale to determine the case of the wide       characters.       When theLC_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 forwcscasecmp_l() andwcsncasecmp_l() about the       case of the characters comes from the locale represented bylocale.       The behavior is undefined if thelocale argument towcscasecmp_l()       orwcsncasecmp_l() is the special locale object LC_GLOBAL_LOCALE       or is not a valid locale object handle.

RETURN VALUE        top

       Upon completion, thewcscasecmp() andwcscasecmp_l() functions       shall return an integer greater than, equal to, or less than 0 if       the wide-character string pointed to byws1 is, ignoring case,       greater than, equal to, or less than the wide-character string       pointed to byws2, respectively.       Upon completion, thewcsncasecmp() andwcsncasecmp_l() functions       shall return an integer greater than, equal to, or less than 0 if       the possibly null wide-character terminated string pointed to byws1 is, ignoring case, greater than, equal to, or less than the       possibly null wide-character terminated string pointed to byws2,       respectively.       No return values are reserved to indicate an error.

ERRORS        top

       No errors are defined.The following sections are informative.

EXAMPLES        top

       None.

APPLICATION USAGE        top

       None.

RATIONALE        top

       None.

FUTURE DIRECTIONS        top

       None.

SEE ALSO        top

strcasecmp(3p),wcscmp(3p),wcsncmp(3p)       The Base Definitions volume of POSIX.1‐2017,wchar.h(0p)

COPYRIGHT        top

       Portions of this text are reprinted and reproduced in electronic       form from IEEE Std 1003.1-2017, Standard for Information       Technology -- Portable Operating System Interface (POSIX), The       Open Group Base Specifications Issue 7, 2018 Edition, Copyright       (C) 2018 by the Institute of Electrical and Electronics Engineers,       Inc and The Open Group.  In the event of any discrepancy between       this version and the original IEEE and The Open Group Standard,       the original IEEE and The Open Group Standard is the referee       document. The original Standard can be obtained online athttp://www.opengroup.org/unix/online.html .       Any typographical or formatting errors that appear in this page       are most likely to have been introduced during the conversion of       the source files to man page format. To report such errors, seehttps://www.kernel.org/doc/man-pages/reporting_bugs.html .IEEE/The Open Group                2017WCSCASECMP(3P)

Pages that refer to this page:wchar.h(0p), strcasecmp(3p), wcscmp(3p), wcsncasecmp(3p), wcsncmp(3p)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.