NAME
wcscspn — get the
length of a complementary wide substring
SYNOPSIS
#include
<wchar.h>
size_t wcscspn(const wchar_t *ws1, const wchar_t *ws2);
DESCRIPTION
[CX] The functionality described on this reference page is aligned with the ISO C standard. Any conflict between the requirements described here and the ISO C standard is unintentional. This volume of POSIX.1-2024 defers to the ISO C standard.
The wcscspn () function shall
compute the length (in wide characters) of the maximum initial segment of
the wide-character string pointed to by ws1 which consists
entirely of wide-character codes
not from the
wide-character string pointed to by
ws2.
[CX] The wcscspn ()
function shall not change the setting of errno on valid
input.
RETURN VALUE
The wcscspn () function shall return the
length of the initial substring of ws1; no return value is
reserved to indicate an error.
ERRORS
No errors are defined.
EXAMPLES
None.
APPLICATION USAGE
None.
RATIONALE
None.
FUTURE DIRECTIONS
None.
SEE ALSO
XBD <wchar.h>
CHANGE HISTORY
First released in Issue 4. Derived from the MSE working draft.
Issue 5
The RETURN VALUE section is updated to indicate that
wcscspn () returns the length of
ws1, rather than ws1 itself.
Issue 8
Austin Group Defect 448 is applied, adding a requirement that
wcscspn () does not change the setting of
errno on valid input.