strspn, wcsspn, _mbsspn

Find the first substring.

size_tstrspn(constchar*string,constchar*strCharSet);

size_twcsspn(constwchar_t*string,constwchar_t*strCharSet);

size_t_mbsspn(constunsignedchar*string,constunsignedchar*strCharSet);

For additional compatibility information, see Compatibility in the Introduction.

Libraries

Return Value

strspn, wcsspn, and _mbsspn return an integer value specifying the length of the substring in string that consists entirely of characters in strCharSet. If string begins with a character not in strCharSet, the function returns 0. No return value is reserved to indicate an error. For each of these routines, no return value is reserved to indicate an error.

Parameters

string

Null-terminated string to search

strCharSet

Null-terminated character set

Remarks

The strspn function returns the index of the first character in string that does not belong to the set of characters in strCharSet. The search does not include terminating null characters.

wcsspn and _mbsspn are wide-character and multibyte-character versions of strspn. The arguments of wcsspn are wide-character strings; those of _mbsspn are multibyte-character strings. These three functions behave identically otherwise.

Generic-Text Routine Mappings

Example

/* STRSPN.C: This program uses strspn to determine
 * the length of the segment in the string "cabbage"
 * consisting of a's, b's, and c's. In other words,
 * it finds the first non-abc letter.
 */

#include <string.h>
#include <stdio.h>

void main( void )
{
   char string[] = "cabbage";
   int  result;
   result = strspn( string, "abc" );
   printf( "The portion of '%s' containing only a, b, or c "
           "is %d bytes long\n", string, result );
}

Output

The portion of 'cabbage' containing only a, b, or c is 5 bytes long

String Manipulation Routines

See Also   _mbsspnp,strcspn, strncat, strncmp, strncpy, _strnicmp, strrchr