wcsstr

 

C

Language

Headers

Type support

Program utilities

Variadic function support

Error handling

Dynamic memory management

Strings library

Algorithms

Numerics

Date and time utilities

Input/output support

Localization support

Concurrency support (哋它亢11)

Technical Specifications

Symbol index

 

Strings library

Byte strings

Multibyte strings

Wide strings

 

Null-terminated wide strings

Functions
Character manipulation
iswalnum (哋它亢95) iswalpha (哋它亢95) iswlower (哋它亢95) iswupper (哋它亢95) iswdigit (哋它亢95) iswxdigit (哋它亢95) iswblank (哋它亢99) wctype (哋它亢95) iswctype (哋它亢95)	iswcntrl (哋它亢95) iswgraph (哋它亢95) iswspace (哋它亢95) iswprint (哋它亢95) iswpunct (哋它亢95) towlower (哋它亢95) towupper (哋它亢95) wctrans (哋它亢95) towctrans (哋它亢95)
Conversions to numeric formats
wcstolwcstoll (哋它亢95)(哋它亢99) wcstoulwcstoull (哋它亢95)(哋它亢99)	wcstofwcstodwcstold (哋它亢99)(哋它亢95)(哋它亢99) wcstoimaxwcstoumax (哋它亢99)(哋它亢99)
String manipulation
wcslenwcsnlen_s (哋它亢95)(哋它亢11) wcscpywcscpy_s (哋它亢95)(哋它亢11) wcsncpywcsncpy_s (哋它亢95)(哋它亢11) wcscatwcscat_s (哋它亢95)(哋它亢11) wcsncatwcsncat_s (哋它亢95)(哋它亢11) wcsstr (哋它亢95)	wcscmp (哋它亢95) wcsncmp (哋它亢95) wcscoll (哋它亢95) wcsxfrm (哋它亢95) wcschr (哋它亢95) wcsrchr (哋它亢95) wcspbrk (哋它亢95) wcsspn (哋它亢95) wcscspn (哋它亢95) wcstokwcstok_s (哋它亢95)(哋它亢11)
Array manipulation
wmemcpywmemcpy_s (哋它亢95)(哋它亢11) wmemmovewmemmove_s (哋它亢95)(哋它亢11)	wmemcmp (哋它亢95) wmemchr (哋它亢95) wmemset (哋它亢95)

 

Defined in header <wchar.h>
wchar_t *wcsstr( const wchar_t *dest, const wchar_t *src );	(1)	(since 哋它亢95)
/*QWchar_t*/ *wcsstr( /*QWchar_t*/ *dest, const wchar_t *src );	(2)	(since 哋它亢23)

1) Finds the first occurrence of the wide string src in the wide string pointed to by dest. The terminating null characters are not compared.

2) Type-generic function equivalent to (1). Let T be an unqualified wide character object type.

• If dest is of type const T*, the return type is const wchar_t*.
• Otherwise, if dest is of type T*, the return type is wchar_t*.
• Otherwise, the behavior is undefined.

If a macro definition of each of these generic functions is suppressed to access an actual function (e.g. if (wcsstr) or a function pointer is used), the actual function declaration (1) becomes visible.

Parameters

dest	-	pointer to the null-terminated wide string to examine
src	-	pointer to the null-terminated wide string to search for

Return value

Pointer to the first character of the found substring in dest, or a null pointer if no such substring is found. If src points to an empty string, dest is returned.

Example

Run this code

#include <stdio.h>
#include <locale.h>
#include <wchar.h>
 
int main(void)
{
    setlocale(LC_ALL, "ru_RU.UTF-8");
 
    wchar_t str[5][64] = {
        L"Строка, где есть подстрока 'но'.",
        L"Строка, где такой подстроки нет.",
        L"Он здесь.",
        L"Здесь он.",
        L"Его нет."
    };
 
    for (size_t i = 0; i < 5; ++i) {
        if (wcsstr(str[i], L"но")) {
            wprintf(L"%ls\n", str[i]);
        }
    }
}

Output:

Строка, где есть подстрока 'но'.

References

• 哋它亢11 standard (ISO/IEC 9899:2011):

• 7.29.4.5.6 The wcsstr function (p: 437)

• 哋它亢99 standard (ISO/IEC 9899:1999):

• 7.24.4.5.6 The wcsstr function (p: 383)

See also

wcschr (哋它亢95)	finds the first occurrence of a wide character in a wide string (function)
wcsrchr (哋它亢95)	finds the last occurrence of a wide character in a wide string (function)