| .\" Copyright (c) Bruno Haible <haible@clisp.cons.org> |
| .\" |
| .\" This is free documentation; you can redistribute it and/or |
| .\" modify it under the terms of the GNU General Public License as |
| .\" published by the Free Software Foundation; either version 2 of |
| .\" the License, or (at your option) any later version. |
| .\" |
| .\" References consulted: |
| .\" GNU glibc-2 source code and manual |
| .\" Dinkumware C library reference http://www.dinkumware.com/ |
| .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html |
| .\" ISO/IEC 9899:1999 |
| .\" |
| .TH WCSSTR 3 1999-07-25 "GNU" "Linux Programmer's Manual" |
| .SH NAME |
| wcsstr \- locate a substring in a wide-character string |
| .SH SYNOPSIS |
| .nf |
| .B #include <wchar.h> |
| .sp |
| .BI "wchar_t *wcsstr(const wchar_t *" haystack ", const wchar_t *" needle ); |
| .fi |
| .SH DESCRIPTION |
| The \fBwcsstr\fP() function is the wide-character equivalent of the \fBstrstr\fP() |
| function. It searches for the first occurrence of the wide-character string |
| \fIneedle\fP (without its terminating L'\\0' character) as a substring in |
| the wide-character string \fIhaystack\fP. |
| .SH "RETURN VALUE" |
| The \fBwcsstr\fP() function returns a pointer to the first occurrence of |
| \fIneedle\fP in \fIhaystack\fP. It returns NULL if \fIneedle\fP does not occur |
| as a substring in \fIhaystack\fP. |
| .PP |
| Note the special case: If \fIneedle\fP is the empty wide-character string, |
| the return value is always \fIhaystack\fP itself. |
| .SH "CONFORMING TO" |
| ISO/ANSI C, UNIX98 |
| .SH "SEE ALSO" |
| .BR strstr (3), |
| .BR wcschr (3) |