wcswcs(3) Library Functions Manual wcswcs(3)
NAME
wcswcs - Searches for a substring in a wide-character string.
LIBRARY
Standard C Library (libc)
SYNOPSIS
#include <wchar.h>
wchar_t *wcswcs( const wchar_t *wcstring1, const wchar_t *wcstring2);
STANDARDS
Interfaces documented on this reference page conform to industry standards 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.
Application 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.
RELATED INFORMATION
Functions: strstr(3), wcschr(3), wcspbrk(3), wcsstr(3)
Standards: standards(5) delim off
wcswcs(3)