strchr(3p)

strchr3p

String scanning operation

Usage

#include <string.h>

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

Prolog

This manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ (consult the corresponding Linux manual page for details of Linux behavior), or the interface may not be implemented on Linux.

Overview

The functionality described on this reference page is aligned with the ISO C standard. Any conflict between the requirements described here and the ISO C standard is unintentional. This volume of POSIX.1‐2017 defers to the ISO C standard.

The strchr() function shall locate the first occurrence of c (converted to a char) in the string pointed to by s. The terminating NUL character is considered to be part of the string.

Return value

Upon completion, strchr() shall return a pointer to the byte, or a null pointer if the byte was not found.

Errors

No errors are defined.

The following sections are informative.

Examples

None.

Application usage

None.

Rationale

None.

Future directions

None.

From man-pages 6.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.