user_namespaces.7: Add an example program
[man-pages.git] / man3 / wcsrchr.3
blob246cd8d8e15ccace68c210518d12e0dfbe284bc7
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 WCSRCHR 3  2013-11-19 "GNU" "Linux Programmer's Manual"
17 .SH NAME
18 wcsrchr \- search a wide character in a wide-character string
19 .SH SYNOPSIS
20 .nf
21 .B #include <wchar.h>
22 .sp
23 .BI "wchar_t *wcsrchr(const wchar_t *" wcs ", wchar_t " wc );
24 .fi
25 .SH DESCRIPTION
26 The
27 .BR wcsrchr ()
28 function is the wide-character equivalent
29 of the
30 .BR strrchr (3)
31 function.
32 It searches the last occurrence of
33 .I wc
34 in the wide-character
35 string pointed to by
36 .IR wcs .
37 .SH RETURN VALUE
38 The
39 .BR wcsrchr ()
40 function returns a pointer to the last occurrence of
41 .I wc
42 in the wide-character string pointed to by
43 .IR wcs ,
44 or NULL if
45 .I wc
46 does not occur in the string.
47 .SH ATTRIBUTES
48 .SS Multithreading (see pthreads(7))
49 The
50 .BR wcsrchr ()
51 function is thread-safe.
52 .SH CONFORMING TO
53 C99.
54 .SH SEE ALSO
55 .BR strrchr (3),
56 .BR wcschr (3)