wcsspn()

Updated: April 19, 2023

Count the wide characters at the beginning of a string that are in a given character set

Synopsis:

#include <wchar.h>

size_t wcsspn( const wchar_t * ws1,
               const wchar_t * ws2 );

Arguments:

ws1
The wide-character string that you want to search.
ws2
The set of wide characters you want to look for.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The wcsspn() function returns the length of the initial segment of the string pointed to by ws1 consisting entirely of wide characters from the string pointed to by ws2. The terminating NUL isn't considered to be part of ws2.

Returns:

The length of the segment, or 0 if the first wide character in ws1 is not in ws2.

Classification:

ANSI, POSIX 1003.1

Safety:  
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes