### wcsstr -- Locate Wide-Character Substring

Format

>     #include <wchar.h>
>     wchar_t *wcsstr(const wchar_t *wcs1, const wchar_t *wcs2);

Language Level: ANSI 93
wcsstr locates the first occurrence of wcs2 in wcs1. In the matching process, wcsstr ignores the wchar_t null character that ends wcs2.

The behavior of wcsstr is affected by the LC_CTYPE category of the current locale.

Return Value
wcsstr returns a pointer to the beginning of the first occurrence of wcs2 in wcs1. If wcs2 does not appear in wcs1, wcsstr returns NULL. If wcs2 points to a wide-character string with zero length, wcsstr returns wcs1.

Example
This example uses wcsstr to find the first occurrence of hay in the wide-character string needle in a haystack.

    #include <stdio.h>
    #include <wchar.h>

    int main(void)
    {
       wchar_t *wcs1 = L"needle in a haystack";
       wchar_t *wcs2 = L"hay";

       printf("result: \"%ls\"\n", wcsstr(wcs1, wcs2));
       return 0;

       /***********************************************
          The output should be similar to:

          result: "haystack"
       ***********************************************/
    }

strstr -- Locate Substring
wcschr -- Search for Wide Character
wcsrchr -- Locate Wide Character in String
wcswcs -- Locate Wide-Character Substring
<wchar.h>