wcsstr Subroutine

Purpose

Find a wide-character substring.

Library

Standard library (libc.a)

Syntax

#include <wchar.h>
wchar_t *wcsstr (const wchar_t * ws1, const wchar_t * ws2);

Description

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

Return Values

On successful completion, wcsstr 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.