man3/wmemchr.3

   1 '\" t
   2 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   3 .\"
   4 .\" SPDX-License-Identifier: GPL-2.0-or-later
   5 .\"
   6 .\" References consulted:
   7 .\"   GNU glibc-2 source code and manual
   8 .\"   Dinkumware C library reference http://www.dinkumware.com/
   9 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  10 .\"   ISO/IEC 9899:1999
  11 .\"
  12 .TH wmemchr 3 (date) "Linux man-pages (unreleased)"
  13 .SH NAME
  14 wmemchr \- search a wide character in a wide-character array
  15 .SH LIBRARY
  16 Standard C library
  17 .RI ( libc ", " \-lc )
  18 .SH SYNOPSIS
  19 .nf
  20 .B #include <wchar.h>
  21 .P
  22 .BI "wchar_t *wmemchr(const wchar_t " s [. n "], wchar_t " c ", size_t " n );
  23 .fi
  24 .SH DESCRIPTION
  25 The
  26 .BR wmemchr ()
  27 function is the wide-character equivalent of the
  28 .BR memchr (3)
  29 function.
  30 It searches the
  31 .I n
  32 wide characters starting at
  33 .I s
  34 for
  35 the first occurrence of the wide character
  36 .IR c .
  37 .SH RETURN VALUE
  38 The
  39 .BR wmemchr ()
  40 function returns a pointer to the first occurrence of
  41 .I c
  42 among the
  43 .I n
  44 wide characters starting at
  45 .IR s ,
  46 or NULL if
  47 .I c
  48 does
  49 not occur among these.
  50 .SH ATTRIBUTES
  51 For an explanation of the terms used in this section, see
  52 .BR attributes (7).
  53 .TS
  54 allbox;
  55 lbx lb lb
  56 l l l.
  57 Interface       Attribute       Value
  58 T{
  59 .na
  60 .nh
  61 .BR wmemchr ()
  62 T}      Thread safety   MT-Safe
  63 .TE
  64 .SH STANDARDS
  65 C11, POSIX.1-2008.
  66 .SH HISTORY
  67 POSIX.1-2001, C99.
  68 .SH SEE ALSO
  69 .BR memchr (3),
  70 .BR wcschr (3)