original/man3/wcsstr.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
   4 .\" This is free documentation; you can redistribute it and/or
   5 .\" modify it under the terms of the GNU General Public License as
   6 .\" published by the Free Software Foundation; either version 2 of
   7 .\" the License, or (at your option) any later version.
   8 .\" %%%LICENSE_END
   9 .\"
  10 .\" References consulted:
  11 .\"   GNU glibc-2 source code and manual
  12 .\"   Dinkumware C library reference http://www.dinkumware.com/
  13 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  14 .\"   ISO/IEC 9899:1999
  15 .\"
  16 .TH WCSSTR 3  2013-11-12 "GNU" "Linux Programmer's Manual"
  17 .SH NAME
  18 wcsstr \- locate a substring in a wide-character string
  19 .SH SYNOPSIS
  20 .nf
  21 .B #include <wchar.h>
  22 .sp
  23 .BI "wchar_t *wcsstr(const wchar_t *" haystack ", const wchar_t *" needle );
  24 .fi
  25 .SH DESCRIPTION
  26 The
  27 .BR wcsstr ()
  28 function is the wide-character equivalent of the
  29 .BR strstr (3)
  30 function.
  31 It searches for the first occurrence of the wide-character string
  32 .I needle
  33 (without its terminating null wide character (L\(aq\\0\(aq))
  34 as a substring in the wide-character string
  35 .IR haystack .
  36 .SH RETURN VALUE
  37 The
  38 .BR wcsstr ()
  39 function returns a pointer to the first occurrence of
  40 .I needle
  41 in
  42 .IR haystack .
  43 It returns NULL if
  44 .I needle
  45 does not occur
  46 as a substring in
  47 .IR haystack .
  48 .PP
  49 Note the special case:
  50 If
  51 .I needle
  52 is the empty wide-character string,
  53 the return value is always
  54 .I haystack
  55 itself.
  56 .SH ATTRIBUTES
  57 .SS Multithreading (see pthreads(7))
  58 The
  59 .BR wcsstr ()
  60 function is thread-safe.
  61 .SH CONFORMING TO
  62 C99.
  63 .SH SEE ALSO
  64 .BR strstr (3),
  65 .BR wcschr (3)
  66 .SH COLOPHON
  67 This page is part of release 3.67 of the Linux
  68 .I man-pages
  69 project.
  70 A description of the project,
  71 information about reporting bugs,
  72 and the latest version of this page,
  73 can be found at
  74 \%http://www.kernel.org/doc/man\-pages/.