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.