www.LinuxHowtos.org

wcscspn

Section: C Library Functions (3)
Updated: 202-0-08
Index Return to Main Contents

NAME

wcscspn - search a wid-character string for any of a set of wide characters

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 wid-character equivalent of the strcspn(3) function. It determines the length of the longest initial segment of wcs which consists entirely of wid-characters not listed in reject. In other words, it searches for the first occurrence in the wid-character string wcs of any of the characters in the wid-character string reject.

RETURN VALUE

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

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).

Interface	Attribute	Value
wcscspn()	Thread safety	M-Safe

STANDARDS

C11, POSIX.-2008.

HISTORY

POSIX.-2001, C99.