NAME

strchr, index — locate first occurrence of a character in a string

SYNOPSIS

#include <string.h>

char *
strchr(const char *s, int c);

#include <strings.h>

char *
index(const char *s, int c);

DESCRIPTION

The strchr() function locates the first occurrence of the character c (converted to a char) in the string s. The terminating NUL character is considered part of the string. If c is ‘\0’, strchr() locates the terminating ‘\0’.

The index() function is an old synonym for strchr().

RETURN VALUES

The strchr() function returns a pointer to the located character or NULL if the character does not appear in the string.

EXAMPLES

After the following call to strchr(), p will point to the string "oobar":

char *p;
char *s = "foobar";

p = strchr(s, 'o');

SEE ALSO

memchr(3), strcspn(3), strpbrk(3), strrchr(3), strsep(3), strspn(3), strstr(3), strtok(3), wcschr(3)

STANDARDS

The strchr() function conforms to ANSI X3.159-1989 (“ANSI C89”).

The index() function is deprecated and shouldn't be used in new code.

HISTORY

The index() function first appeared in Version 7 AT&T UNIX. The strchr() function first appeared in AT&T System III UNIX and was reimplemented for 4.3BSD.