STRCSPN(3)                OpenBSD Programmer's Manual               STRCSPN(3)

NAME
     strcspn - span the complement of a string

SYNOPSIS
     #include <string.h>

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

DESCRIPTION
     The strcspn() function spans the initial part of the NUL-terminated
     string s as long as the characters from s do not occur in string charset
     (it spans the complement of charset).

RETURN VALUES
     The strcspn() function returns the number of characters spanned.

EXAMPLES
     The following call to strcspn() will return 3, since the first three
     characters of string s do not occur in string charset:

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

           span = strcspn(s, charset);

     The following removes the first (if any) newline character from string
     line.  This is useful for trimming the newline after a fgets(3) call.

           char line[BUFSIZ];

           if (fgets(line, sizeof(line), fp) != NULL)
                   line[strcspn(line, "\n")] = '\0';

SEE ALSO
     memchr(3), strchr(3), strpbrk(3), strrchr(3), strsep(3), strspn(3),
     strstr(3), strtok(3)

STANDARDS
     The strcspn() function conforms to ANSI X3.159-1989 (``ANSI C'').

OpenBSD 4.9                     August 8, 2007                     OpenBSD 4.9