strstr(3)

strstr3

String search substring

Usage

#include <string.h>

char *strstr(const char *haystack, const char *needle);

Library

Standard C library (libc, -lc)

Overview

strstr() finds the first occurrence of the substring needle in the string haystack.

The terminating null bytes ('\0') are not compared.

It is equivalent to

memmem(haystack, strlen(haystack), needle, strlen(needle))

Return value

strstr(3) returns a pointer to the beginning of the located substring, or NULL if the substring is not found.

If needle is the empty string, the return value is always haystack itself.

Attributes

For an explanation of the terms used in this section, see attributes(7).

InterfaceAttributeValue
strstr()Thread safetyMT-Safe

Releases

19 releases since Debian 1.1 (Buzz); the text changed 14 times.

  1. 1.1–1.3
  2. 2.0–2.2
  3. 3.0
  4. 3.1
  5. 4.0
  6. 5.0
  7. 6.0
  8. 7
  9. 8
  10. 9
  11. 10
  12. 11
  13. 12
  14. 13
  15. Arch

Standards

C11, POSIX.1-2008.

History

POSIX.1-2001, C89.

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