strnstr (3)

Leading comments

 Copyright (c) 2001 Mike Barcroft <mike@FreeBSD.org>
 Copyright (c) 1990, 1991, 1993
	The Regents of the University of California.  All rights reserved.

 This code is derived from software contributed to Berkeley by
 Chris Torek and the American National Standards Committee X3,
 on Information Processing Systems.

 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions
 are met:
 1. Redistributions of source code...

(The comments found at the beginning of the groff file "man3/strnstr.3bsd".)

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);

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)