Loading...
--- Libc/Libc-763.13/string/FreeBSD/strstr.3
+++ Libc/Libc-825.26/string/FreeBSD/strstr.3
@@ -37,26 +37,47 @@
.Dt STRSTR 3
.Os
.Sh NAME
-.Nm strstr , strcasestr , strnstr
+.Nm strcasestr ,
+.Nm strcasestr_l ,
+.Nm strnstr ,
+.Nm strstr
.Nd locate a substring in a string
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.In string.h
.Ft char *
-.Fn strstr "const char *big" "const char *little"
+.Fo strcasestr
+.Fa "const char *s1"
+.Fa "const char *s2"
+.Fc
.Ft char *
-.Fn strcasestr "const char *big" "const char *little"
+.Fo strnstr
+.Fa "const char *s1"
+.Fa "const char *s2"
+.Fa "size_t n"
+.Fc
.Ft char *
-.Fn strnstr "const char *big" "const char *little" "size_t len"
+.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
.Sh DESCRIPTION
The
.Fn strstr
function
locates the first occurrence of the null-terminated string
-.Fa little
+.Fa s2
in the null-terminated string
-.Fa big .
+.Fa s1 .
.Pp
The
.Fn strcasestr
@@ -68,11 +89,11 @@
.Fn strnstr
function
locates the first occurrence of the null-terminated string
-.Fa little
+.Fa s2
in the string
-.Fa big ,
+.Fa s1 ,
where not more than
-.Fa len
+.Fa n
characters are searched.
Characters that appear after a
.Ql \e0
@@ -82,20 +103,28 @@
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.
.Sh RETURN VALUES
If
-.Fa little
+.Fa s2
is an empty string,
-.Fa big
+.Fa s1
is returned;
if
-.Fa little
+.Fa s2
occurs nowhere in
-.Fa big ,
+.Fa s1 ,
.Dv NULL
is returned;
otherwise a pointer to the first character of the first occurrence of
-.Fa little
+.Fa s2
is returned.
.Sh EXAMPLES
The following sets the pointer
@@ -128,7 +157,6 @@
.Ed
.Sh SEE ALSO
.Xr memchr 3 ,
-.Xr memmem 3 ,
.Xr strchr 3 ,
.Xr strcspn 3 ,
.Xr strpbrk 3 ,
@@ -136,7 +164,8 @@
.Xr strsep 3 ,
.Xr strspn 3 ,
.Xr strtok 3 ,
-.Xr wcsstr 3
+.Xr wcsstr 3 ,
+.Xr xlocale 3
.Sh STANDARDS
The
.Fn strstr