Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

string(3)

wcsstr(3)

wcswcs(3)

standards(5)

strstr(3)  —  Subroutines

NAME

strstr − Finds a substring

LIBRARY

Standard C Library (libc.so, libc.a)

SYNOPSIS

#include <string.h>

char ∗strstr(
        const char ∗s1,
        const char ∗s2);

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

strstr():  ISO C, XPG4, XPG4−UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags. 

PARAMETERS

s1Specifies the character string being searched. 

s2Specifies the substring to be located. 

DESCRIPTION

The strstr() function locates the first occurrence in the string pointed to by the s1 parameter of the sequence of bytes in the string pointed to by the s2 parameter, excluding the terminating null character. 

RETURN VALUES

On successful completion, the strstr() function returns a pointer to the located string or a null pointer if the string is not found.  When the s2 parameter points to a string having 0 (zero) length, the strstr() function returns the string pointed to by parameter s1. 

RELATED INFORMATION

Functions: string(3), wcsstr(3), wcswcs(3)

Standards: standards(5)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026