Loading...
--- Libc/Libc-498/string/strstr.3
+++ Libc/Libc-262/string/strstr.3
@@ -35,53 +35,32 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)strstr.3 8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/string/strstr.3,v 1.12 2001/11/20 14:11:07 ru Exp $
+.\" $FreeBSD: src/lib/libc/string/strstr.3,v 1.11 2001/10/11 15:49:06 mike Exp $
.\"
.Dd October 11, 2001
.Dt STRSTR 3
.Os
.Sh NAME
-.Nm strcasestr ,
-.Nm strcasestr_l ,
-.Nm strnstr ,
-.Nm strstr
+.Nm strstr , strcasestr , strnstr
.Nd locate a substring in a string
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.In string.h
.Ft char *
-.Fo strcasestr
-.Fa "const char *s1"
-.Fa "const char *s2"
-.Fc
+.Fn strstr "const char *big" "const char *little"
.Ft char *
-.Fo strnstr
-.Fa "const char *s1"
-.Fa "const char *s2"
-.Fa "size_t n"
-.Fc
+.Fn strcasestr "const char *big" "const char *little"
.Ft char *
-.Fo strstr
-.Fa "const char *s1"
-.Fa "const char *s2"
-.Fc
-.In string.h
-.In xlocale.h
-.Ft char *
-.Fo strcasestr_l
-.Fa "const char *s1"
-.Fa "const char *s2"
-.Fa "locale_t loc"
-.Fc
+.Fn strnstr "const char *big" "const char *little" "size_t len"
.Sh DESCRIPTION
The
.Fn strstr
function
locates the first occurrence of the null-terminated string
-.Fa s2
+.Fa little
in the null-terminated string
-.Fa s1 .
+.Fa big .
.Pp
The
.Fn strcasestr
@@ -93,11 +72,11 @@
.Fn strnstr
function
locates the first occurrence of the null-terminated string
-.Fa s2
+.Fa little
in the string
-.Fa s1 ,
+.Fa big ,
where not more than
-.Fa n
+.Fa len
characters are searched.
Characters that appear after a
.Ql \e0
@@ -106,35 +85,26 @@
.Fn strnstr
function is a
.Fx
-specific API, it should only be used when portability is not a concern.
-.Pp
-While the
-.Fn strcasestr
-function uses the current locale, the
-.Fn strcasestr_l
-function may be passed a locale directly. See
-.Xr xlocale 3
-for more information.
+specific API, it should only be used when portablility is not a concern.
.Sh RETURN VALUES
If
-.Fa s2
+.Fa little
is an empty string,
-.Fa s1
+.Fa big
is returned;
if
-.Fa s2
+.Fa little
occurs nowhere in
-.Fa s1 ,
-.Dv NULL
-is returned;
+.Fa big ,
+NULL is returned;
otherwise a pointer to the first character of the first occurrence of
-.Fa s2
+.Fa little
is returned.
.Sh EXAMPLES
The following sets the pointer
.Va ptr
to the
-.Qq Li Bar Baz
+.Dq Li Bar Baz
portion of
.Va largestring :
.Bd -literal -offset indent
@@ -147,9 +117,7 @@
.Pp
The following sets the pointer
.Va ptr
-to
-.Dv NULL ,
-because only the first 4 characters of
+to NULL, because only the first 4 characters of
.Va largestring
are searched:
.Bd -literal -offset indent
@@ -167,8 +135,7 @@
.Xr strrchr 3 ,
.Xr strsep 3 ,
.Xr strspn 3 ,
-.Xr strtok 3 ,
-.Xr xlocale 3
+.Xr strtok 3
.Sh STANDARDS
The
.Fn strstr