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>