dwww Home | Manual pages | Find package

wcsncasecmp(3)             Library Functions Manual             wcsncasecmp(3)

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

LIBRARY
       Standard C library (libc, -lc)

SYNOPSIS
       #include <wchar.h>

       int wcsncasecmp(const wchar_t s1[.n], const wchar_t s2[.n], size_t n);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       wcsncasecmp():
           Since glibc 2.10:
               _POSIX_C_SOURCE >= 200809L
           Before glibc 2.10:
               _GNU_SOURCE

DESCRIPTION
       The wcsncasecmp() function is  the  wide-character  equivalent  of  the
       strncasecmp(3) function.  It compares the wide-character string pointed
       to  by s1 and the wide-character string pointed to by s2, but at most n
       wide characters from each string,  ignoring  case  differences  (towup-
       per(3), towlower(3)).

RETURN VALUE
       The  wcsncasecmp()  function returns zero if the wide-character strings
       at s1 and s2, truncated to at most length n, are equal except for  case
       distinctions.  It returns a positive integer if truncated s1 is greater
       than  truncated  s2,  ignoring  case.  It returns a negative integer if
       truncated s1 is smaller than truncated s2, ignoring case.

ATTRIBUTES
       For an explanation of the terms  used  in  this  section,  see  attrib-
       utes(7).
       ┌────────────────────────────────────┬───────────────┬────────────────┐
       │ Interface                          Attribute     Value          │
       ├────────────────────────────────────┼───────────────┼────────────────┤
       │ wcsncasecmp()                      │ Thread safety │ MT-Safe locale │
       └────────────────────────────────────┴───────────────┴────────────────┘

STANDARDS
       POSIX.1-2008.

HISTORY
       glibc 2.1.

NOTES
       The  behavior  of wcsncasecmp() depends on the LC_CTYPE category of the
       current locale.

SEE ALSO
       strncasecmp(3), wcsncmp(3)

Linux man-pages 6.7               2023-10-31                    wcsncasecmp(3)

Generated by dwww version 1.16 on Mon Jul 13 22:09:47 CEST 2026.