NAME    [Toc]    [Back]

       wcsspn, wcscspn - Return the length of the initial segment
       of a wide-character string

SYNOPSIS    [Toc]    [Back]

       #include <wchar.h>

       size_t wcsspn(
               const wchar_t *wcstring1,
               const wchar_t *wcstring2 ); size_t wcscspn(
               const wchar_t *wcstring1,
               const wchar_t *wcstring2 );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       wcscspn(), wcsspn(): ISO C, XPG4

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Points to a wide-character string  being  checked  for  an
       initial  segment.   Points to a wide-character string containing
 a set of wide characters that define  the  initial
       segment.

DESCRIPTION    [Toc]    [Back]

       The wcsspn() and wcscspn() functions compute the number of
       wide characters in the initial segment of a wide-character
       string.  The  wcsspn() function considers the initial segment
 to consist of all wide characters that  are  included
       in  the set of wide characters pointed to by the wcstring2
       parameter. The function counts these wide characters until
       it  finds  one  that is not included in the set. The wcscspn()
 function considers the initial segment to consist of
       all  wide  characters  that are not included in the set of
       wide characters pointed to by the wcstring2 parameter. The
       function  counts  these wide characters until it finds one
       that is included in the set.

RETURN VALUES    [Toc]    [Back]

       On successful completion, the wcsspn() and wcscspn() functions
 return the number of wide characters in the segment.
       No error return is defined for these functions.

SEE ALSO    [Toc]    [Back]

       Functions: setlocale(3), strspn(3), wcslen(3)

       Standards: standards(5)



                                                        wcsspn(3)