Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

string(3)

wcswcs(3)

strstr(3)  —  Subroutines

NAME

strstr − Finds a substring

LIBRARY

Standard C Library (libc.a)

SYNOPSIS

#include <string.h> char ∗strstr(
const char ∗s1,
const char ∗s2);

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. 

NOTES

AES Support Level:
Full use.

RETURN VALUES

Upon successful completion, the strstr() function returns a pointer to the located string or a null pointer when 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.  Upon error, a null pointer is returned, and errno is set to indicate the error. 

RELATED INFORMATION

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

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