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), wcscspn(3)
STANDARDS
The strcspn() function conforms to
ANSI X3.159-1989
(“ANSI C89”).
HISTORY
The strcspn() function first appeared in
AT&T System III UNIX and was
reimplemented for 4.3BSD-Tahoe.