NAME

strspn — span a string

SYNOPSIS

#include <string.h>

size_t
strspn(const char *s, const char *charset);

DESCRIPTION

The strspn() function spans the initial part of the NUL-terminated string s as long as the characters from s occur in string charset.

RETURN VALUES

The strspn() function returns the number of characters spanned.

EXAMPLES

The following call to strspn() will return 3, since the first three characters of string s are part of string charset:

char *s = "foobar";
char *charset = "of";
size_t span;

span = strspn(s, charset);

SEE ALSO

memchr(3), strchr(3), strcspn(3), strpbrk(3), strrchr(3), strsep(3), strstr(3), strtok(3), wcsspn(3)

STANDARDS

The strspn() function conforms to ANSI X3.159-1989 (“ANSI C89”).

HISTORY

The strspn() function first appeared in AT&T System III UNIX and was reimplemented for 4.3BSD.