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.

VERSIONS
       The wcsncasecmp() function is provided since glibc 2.1.

ATTRIBUTES
       For an  explanation  of  the  terms  used  in  this  section,  see  at-
       tributes(7).

       ┌─────────────────────────────────────┬───────────────┬────────────────┐
       │InterfaceAttributeValue          │
       ├─────────────────────────────────────┼───────────────┼────────────────┤
       │wcsncasecmp()                        │ Thread safety │ MT-Safe locale │
       └─────────────────────────────────────┴───────────────┴────────────────┘

STANDARDS
       POSIX.1-2008.   This  function is not specified in POSIX.1-2001, and is
       not widely available on other systems.

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.03              2022-12-15                    wcsncasecmp(3)

Generated by dwww version 1.15 on Wed Jun 26 18:09:21 CEST 2024.