STRCHR(3)

STRCHR(3) | Library Functions Manual | STRCHR(3)

# NAME

`strchr, strchrnul` — locate character in string

# LIBRARY

Standard C Library (libc, -lc)

# SYNOPSIS

`#include <string.h>`

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

char *
`strchrnul`(const char *s, int c);

# DESCRIPTION

The `strchr`() and `strchrnul`() functions locate the first occurrence of c in the string pointed to by s. The terminating `NUL` character is considered part of the string. If c is ‘`\0`’, `strchr`() and `strchrnul`() locate the terminating ‘`\0`’.

# RETURN VALUES

The function `strchr`() returns a pointer to the located character, or `NULL` if the character does not appear in the string. The function `strchrnul`() returns a pointer to the located character, or a pointer to the `NUL` terminating character of the string 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

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

# STANDARDS

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

# HISTORY

The `strchrnul`() first appeared in glibc 2.1.1 and was added to FreeBSD 10 and NetBSD 8.

November 27, 2020 | NetBSD 11.0