NAME

wcswcs - find a wide substring

 SYNOPSIS

#include <wchar.h>

wchar_t *wcswcs(const wchar_t *ws1, const wchar_t *ws2);

 DESCRIPTION

The wcswcs() function locates the first occurrence in the wide-character string pointed to by ws1 of the sequence of wide-character codes (excluding the terminating null wide-character code) in the wide-character string pointed to by ws2.

 RETURN VALUE

Upon successful completion, wcswcs() returns a pointer to the located wide-character string or a null pointer if the wide-character string is not found.

If ws2 points to a wide-character string with zero length, the function returns ws1.

 ERRORS

No errors are defined.

 EXAMPLES

None.

 APPLICATION USAGE

This function was not included in the final ISO/IEC 9899:1990/Amendment 1:1994 (E). Application developers are strongly encouraged to use the wcsstr() function instead.

 FUTURE DIRECTIONS

None.

 SEE ALSO

wcschr(), wcsstr(), <wchar.h>.

DERIVATION

Derived from the MSE working draft.