STRSTR

Section: Misc. Reference Manual Pages (3bsd)
Page Index

BSD mandoc

NAME

strnstr - locate a substring in a string

LIBRARY

Lb libbsd

SYNOPSIS

In string.h (See libbsd(7) for include usage.) Ft char * Fn strnstr const char *big const char *little size_t len

DESCRIPTION

The Fn strnstr function locates the first occurrence of the null-terminated string Fa little in the string Fa big , where not more than Fa len characters are searched. Characters that appear after a `\0' character are not searched. Since the Fn strnstr function is a Fx specific API, it should only be used when portability is not a concern.

RETURN VALUES

If Fa little is an empty string, Fa big is returned; if Fa little occurs nowhere in Fa big , NULL is returned; otherwise a pointer to the first character of the first occurrence of Fa little is returned.

EXAMPLES

The following sets the pointer ptr to NULL because only the first 4 characters of largestring are searched:

const char *largestring = "Foo Bar Baz";
const char *smallstring = "Bar";
char *ptr;

ptr = strnstr(largestring, smallstring, 4);