string/FreeBSD/strstr.3.patch

   1 --- strstr.3.orig       Fri Mar 11 08:33:31 2005
   2 +++ strstr.3    Fri Mar 11 08:35:28 2005
   3 @@ -41,7 +41,7 @@
   4  .Dt STRSTR 3
   5  .Os
   6  .Sh NAME
   7 -.Nm strstr , strcasestr , strnstr
   8 +.Nm strstr , strcasestr , strnstr , strcasestr_l
   9  .Nd locate a substring in a string
  10  .Sh LIBRARY
  11  .Lb libc
  12 @@ -53,6 +53,9 @@
  13  .Fn strcasestr "const char *big" "const char *little"
  14  .Ft char *
  15  .Fn strnstr "const char *big" "const char *little" "size_t len"
  16 +.In xlocale.h
  17 +.Ft char *
  18 +.Fn strcasestr_l "const char *big" "const char *little" "locale_t loc"
  19  .Sh DESCRIPTION
  20  The
  21  .Fn strstr
  22 @@ -86,6 +89,14 @@
  23  function is a
  24  .Fx
  25  specific API, it should only be used when portability is not a concern.
  26 +.Pp
  27 +While the
  28 +.Fn strcasestr
  29 +function uses the current locale, the
  30 +.Fn strcasestr_l
  31 +function may be passed a locale directly. See
  32 +.Xr xlocale 3
  33 +for more information.
  34  .Sh RETURN VALUES
  35  If
  36  .Fa little
  37 @@ -138,7 +149,8 @@
  38  .Xr strrchr 3 ,
  39  .Xr strsep 3 ,
  40  .Xr strspn 3 ,
  41 -.Xr strtok 3
  42 +.Xr strtok 3 ,
  43 +.Xr xlocale 3
  44  .Sh STANDARDS
  45  The
  46  .Fn strstr