Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

wcsstr — buscar una subcadena en una cadena ancha

wcsstr encuentra la primera aparición de una subcadena ancha. Devuelve un puntero a la coincidencia o NULL si no existe ninguna.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

#include <wchar.h>
QWchar_t *wcsstr(QWchar_t *s1, const wchar_t *s2);

wcsstr, de <wchar.h>, busca la secuencia s2 en s1, sin incluir el L'\0' final del patrón. Si s2 está vacío, devuelve s1; el resultado apunta a la cadena existente, no a una copia.

Ambos argumentos deben apuntar a cadenas válidas terminadas en L'\0'. NULL y los arrays sin terminador provocan un comportamiento indefinido. Comprueba que el resultado no sea NULL antes de usarlo.

En la notación de C23, QWchar_t es un marcador del estándar, no un tipo que se deba declarar: el resultado conserva la calificación const de los elementos de s1. Para const wchar_t * devuelve const wchar_t *; para wchar_t *, devuelve wchar_t *.

Ejemplos

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

int main(void)
{
    const wchar_t text[] = L"red blue blue";
    const wchar_t *match = wcsstr(text, L"blue");

    if (match != NULL) {
        printf("index=%td\n", match - text);
    }
    printf("missing=%d\n", wcsstr(text, L"green") == NULL);
    printf("empty=%d\n", wcsstr(text, L"") == text);
    return 0;
}

Resultado

index=4
missing=1
empty=1

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes