diff options
Diffstat (limited to 'man3/wcsstr.3')
| -rw-r--r-- | man3/wcsstr.3 | 39 |
1 files changed, 39 insertions, 0 deletions
diff --git a/man3/wcsstr.3 b/man3/wcsstr.3 new file mode 100644 index 000000000..2e94f52c8 --- /dev/null +++ b/man3/wcsstr.3 @@ -0,0 +1,39 @@ +.\" 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) |