wcscspn(3)

1wcscspn(3)                 Library Functions Manual                 wcscspn(3)
2
3
4

NAME

6       wcscspn - search a wide-character string for any of a set of wide char‐
7       acters
8

LIBRARY

10       Standard C library (libc, -lc)
11

SYNOPSIS

13       #include <wchar.h>
14
15       size_t wcscspn(const wchar_t *wcs, const wchar_t *reject);
16

DESCRIPTION

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

RETURN VALUE

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

ATTRIBUTES

34       For an  explanation  of  the  terms  used  in  this  section,  see  at‐
35       tributes(7).
36
37       ┌────────────────────────────────────────────┬───────────────┬─────────┐
38       │Interface                                   │ Attribute     │ Value   │
39       ├────────────────────────────────────────────┼───────────────┼─────────┤
40       │wcscspn()                                   │ Thread safety │ MT-Safe │
41       └────────────────────────────────────────────┴───────────────┴─────────┘
42

STANDARDS

44       C11, POSIX.1-2008.
45

HISTORY

47       POSIX.1-2001, C99.
48