HP C/iX Library Reference Manual (30026-90004)

Chapter 5 349
HP C/iX Library Function Descriptions
strspn
strspn
Returns the length of the first substring in s1 composed entirely of members of the
character set
s2 .
Syntax
#include <string.h>
size_t strspn(const char * s1 , const char * s2 );
Parameters
s1 A pointer to a null-terminated character string to be searched.
s2 A pointer to a null-terminated character string containing a character set.
Return Values
x The length of the initial segment in s1 formed by characters found in the
s2 character set.
Description
The strspn function sequentially processes each character in the array referenced by s1 .
For each character in the array, it scans
s2 looking for a match. If a match is found, a
counter is incremented and the process continues. If a match is not found, this function
ends, returning the value of the counter.
Example
Given the following two strings:
'A tattletale never wins.'
for string s1, and
' -Aatle'
for s2. Executing
strspn(s1, s2);
with the strings shown returns a value of 13, because the first 13 characters in s1 all occur
in
s2 "A tattletale ".
See Also
strcspn(), ANSI C 4.11.5.6, POSIX.1 8.1