strchr(3) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
STRCHR(3)               NetBSD 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 consid-
     ered 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 ter-
     minating 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'').
     strchrnul() function appeared in NetBSD 8.

NetBSD 10.1                    November 27, 2020                   NetBSD 10.1