strnstr (3) - Linux Man Pages

strnstr: locate a substring in a string

NAME

strnstr - locate a substring in a string

LIBRARY

Lb libbsd

SYNOPSIS

In bsd/string.h 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);

SEE ALSO

strstr(3), strcasestr(3), memchr(3), memmem(3), strchr(3), strcspn(3), strpbrk(3), strrchr(3), strsep(3), strspn(3), strtok(3), wcsstr(3)