CKTIS / C
wcsncmp — comparação limitada de caracteres largos
wcsncmp compara, no máximo, n elementos wchar_t. O resultado indica a ordem ou a igualdade da parte comparada, não necessariamente das cadeias completas.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <wchar.h>
int wcsncmp(const wchar_t *s1, const wchar_t *s2, size_t n);wcsncmp, declarada em <wchar.h>, compara, no máximo, n caracteres largos. Os caracteres a seguir a L'\0' não são comparados. O primeiro par de caracteres diferentes na comparação determina o sinal do resultado, mas C não garante que a implementação deixe de ler nesse ponto. O limite conta elementos wchar_t, não bytes.
Um resultado negativo, zero ou positivo significa que a parte comparada é, respetivamente, menor, igual ou maior. Verifique o sinal, não os valores exatos -1 ou 1. A ordem depende dos valores dos caracteres, não das regras de ordenação da localidade.
Se n == 0, o resultado é zero; ainda assim, forneça ponteiros válidos. Cada array tem de disponibilizar pelo menos n elementos ou conter um terminador L'\0' entre os elementos disponíveis. Não conte com uma diferença antes do fim para passar um array mais curto sem terminador. Prefixos iguais não provam que as cadeias completas sejam iguais.
Exemplos
#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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.