Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

strncmp — comparação limitada por bytes

strncmp compara no máximo n bytes e para em '\0'. Prefixos iguais não significam que as cadeias completas sejam iguais.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <string.h>
int strncmp(const char *s1, const char *s2, size_t n);

strncmp, de <string.h>, compara no máximo n bytes; os bytes depois de \0 não são comparados. n tem o tipo size_t.

O resultado é negativo, zero ou positivo. O seu sinal depende do primeiro par diferente, interpretado como unsigned char; não assuma que seja -1 ou 1. Trata-se de uma comparação byte a byte, não linguística.

Forneça ponteiros válidos e um intervalo de comparação acessível. Se não houver \0, têm de estar acessíveis n bytes. Um acesso para além de um objeto causa comportamento indefinido. Com n == 0, o resultado é zero, mas NULL continua a ser inválido. memcmp também compara os bytes depois do zero; strcmp não tem limite n.

Exemplos

#include <stdio.h>
#include <string.h>

int main(void)
{
    printf("%d\n", strncmp("cat", "car", 2) == 0);
    printf("%d\n", strncmp("cat", "catfish", 4) < 0);
    printf("%d\n", strncmp("a\0x", "a\0y", 3) == 0);
    return 0;
}

Resultado

1
1
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.

Fontes