Namespaces
Variants

wcsstr

From cppreference.net
< c ‎ | string ‎ | wide
C
Strings library
Null-terminated wide strings
Definido en el encabezado <wchar.h>
wchar_t * wcsstr ( const wchar_t * dest, const wchar_t * src ) ;
(1) (desde C95)
/*QWchar_t*/ * wcsstr ( /*QWchar_t*/ * dest, const wchar_t * src ) ;
(2) (desde C23)
1) Encuentra la primera ocurrencia de la cadena ancha src en la cadena ancha apuntada por dest . Los caracteres nulos de terminación no se comparan.
2) Función genérica de tipos equivalente a (1) . Sea T un tipo de objeto de carácter ancho no calificado.
  • Si dest es de tipo const T * , el tipo de retorno es const wchar_t * .
  • De lo contrario, si dest es de tipo T * , el tipo de retorno es wchar_t * .
  • De lo contrario, el comportamiento es indefinido.
Si se suprime la definición de macro de cada una de estas funciones genéricas para acceder a una función real (por ejemplo, si se usa ( wcsstr ) o un puntero a función), la declaración de función real (1) se hace visible.

Contenidos

Parámetros

dest - puntero a la cadena ancha terminada en nulo a examinar
src - puntero a la cadena ancha terminada en nulo a buscar

Valor de retorno

Puntero al primer carácter de la subcadena encontrada en dest , o un puntero nulo si no se encuentra dicha subcadena. Si src apunta a una cadena vacía, dest es retornado.

Ejemplo

Ejecutar este código 
#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]);
        }
    }
}

Salida: 

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

Referencias

  • Estándar C11 (ISO/IEC 9899:2011):
  • 7.29.4.5.6 La función wcsstr (p: 437)
  • Estándar C99 (ISO/IEC 9899:1999):
  • 7.24.4.5.6 La función wcsstr (p: 383)

Véase también

(C95)
encuentra la primera ocurrencia de un carácter ancho en una cadena ancha
(función)
(C95)
encuentra la última ocurrencia de un carácter ancho en una cadena ancha
(función)
Documentación de C++ para wcsstr