strcspn()

Count string characters not in a character set

Synopsis:

#include <string.h>

size_t strcspn( const char* str,
                const char* charset );

Library:

libc

Description:

The strcspn() function finds the length of the initial segment of the string pointed to by str that consists entirely of characters not from the string pointed to by charset. The terminating NUL character isn't considered part of str.

Returns:

The length of the initial segment.

Examples:

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

int main( void )
{
    printf( "%d\n", strcspn( "abcbcadef", "cba" ) );
    printf( "%d\n", strcspn( "xxxbcadef", "cba" ) );
    printf( "%d\n", strcspn( "123456789", "cba" ) );
    
    return EXIT_SUCCESS;
}

produces the output:

0
3
9

Classification:

ANSI

See also:

strspn()