dwww Home | Manual pages | Find package

wcscspn(3)                 Library Functions Manual                 wcscspn(3)

NAME
       wcscspn - search a wide-character string for any of a set of wide char-
       acters

LIBRARY
       Standard C library (libc, -lc)

SYNOPSIS
       #include <wchar.h>

       size_t wcscspn(const wchar_t *wcs, const wchar_t *reject);

DESCRIPTION
       The  wcscspn()  function  is the wide-character equivalent of the strc-
       spn(3) function.  It determines the length of the longest initial  seg-
       ment  of  wcs  which consists entirely of wide-characters not listed in
       reject.  In other words, it searches for the first  occurrence  in  the
       wide-character  string wcs of any of the characters in the wide-charac-
       ter string reject.

RETURN VALUE
       The wcscspn() function returns the number of  wide  characters  in  the
       longest  initial segment of wcs which consists entirely of wide-charac-
       ters not listed in reject.  In other words, it returns the position  of
       the  first  occurrence  in  the wide-character string wcs of any of the
       characters in the wide-character string reject, or wcslen(wcs) if there
       is none.

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

STANDARDS
       C11, POSIX.1-2008.

HISTORY
       POSIX.1-2001, C99.

SEE ALSO
       strcspn(3), wcspbrk(3), wcsspn(3)

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

Generated by dwww version 1.16 on Tue Dec 16 14:48:08 CET 2025.