www.LinuxHowtos.org

wcsspn

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

NAME

wcsspn - get length of a prefix wid-character substring

LIBRARY

Standard C library (libc,~-lc)

SYNOPSIS

#include <wchar.h>
size_t wcsspn(const wchar_t *wcs, const wchar_t *accept);

DESCRIPTION

The wcsspn() function is the wid-character equivalent of the strspn(3) function. It determines the length of the longest initial segment of wcs which consists entirely of wid-characters listed in accept. In other words, it searches for the first occurrence in the wid-character string wcs of a wid-character not contained in the wid-character string accept.

RETURN VALUE

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

ATTRIBUTES

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

Interface	Attribute	Value
wcsspn()	Thread safety	M-Safe

STANDARDS

C11, POSIX.-2008.

HISTORY

POSIX.-2001, C99.