wcswcs(3)wcswcs(3)NAMEwcswcs - Searche for a substring in a wide-character string.
SYNOPSIS
#include <wchar.h>
wchar_t *wcswcs(
const wchar_t *wcstring1,
const wchar_t *wcstring2 );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
wcswcs(): XSH5.0
The wcswcs() function, although included in Issue 4 and later versions
of the XSH specification, is not included in the ISO C standard. Appli‐
cation developers are strongly encouraged to use wcsstr(), which is
included in both XSH Issue 5 and the ISO C standard.
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
Points to the wide-character string being searched. Points to the
wide-character string to be located.
DESCRIPTION
The wcswcs() function locates the first occurrence of a wide-character
string in another wide-character string. The function locates the first
occurrence in the string pointed to by the wcstring1 parameter of the
sequence of wchar_t characters (excluding the terminating null wide
character) in the string pointed to by the wcstring2 parameter.
RETURN VALUES
The wcswcs() function returns a pointer to the located wide-character
string or a null pointer if the wide-character string is not found. If
the wcstring2 parameter points to a wide-character string with zero
length, the function returns the wcstring1 parameter.
SEE ALSO
Functions: strstr(3), wcschr(3), wcspbrk(3), wcsstr(3)
Standards: standards(5)wcswcs(3)