CKTIS / C
wcsncmp — comparación limitada de caracteres anchos
wcsncmp compara como máximo n elementos wchar_t. El resultado indica el orden o la igualdad de la parte comparada, no necesariamente de las cadenas completas.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#include <wchar.h>
int wcsncmp(const wchar_t *s1, const wchar_t *s2, size_t n);wcsncmp, declarado en <wchar.h>, compara como máximo n caracteres anchos. Los caracteres posteriores a L'\0' no se comparan. El primer par de caracteres distintos en la comparación determina el signo del resultado, pero C no garantiza que la implementación deje de leer en ese punto. El límite cuenta elementos wchar_t, no bytes.
Un resultado negativo, cero o positivo significa que la parte comparada es, respectivamente, menor, igual o mayor. Comprueba el signo, no los valores exactos -1 o 1. El orden se basa en los valores de los caracteres, no en las reglas de ordenación de la configuración regional.
Si n == 0, el resultado es cero; aun así, proporciona punteros válidos. Cada arreglo debe proporcionar al menos n elementos o contener un terminador L'\0' entre sus elementos disponibles. No confíes en que haya una diferencia temprana para pasar un arreglo más corto sin terminador. Que los prefijos sean iguales no demuestra que las cadenas completas lo sean.
Ejemplos
#include <stdio.h>
#include <wchar.h>
int main(void)
{
const wchar_t a[] = L"cat";
const wchar_t b[] = L"car";
printf("prefix_equal=%d\n", wcsncmp(a, b, 2) == 0);
printf("whole_equal=%d\n", wcsncmp(a, b, 3) == 0);
printf("zero_equal=%d\n", wcsncmp(a, b, 0) == 0);
return 0;
}Resultado
prefix_equal=1 whole_equal=0 zero_equal=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.