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

CKTIS / C

strspn — comprimento de um prefixo com caracteres permitidos

strspn devolve o comprimento da parte inicial de uma cadeia que contém apenas caracteres pertencentes a um conjunto fornecido.

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

Sintaxe

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

strspn, declarada em <string.h>, devolve como size_t o comprimento do prefixo mais longo de s1 que contém apenas caracteres presentes em s2. s2 especifica um conjunto de caracteres, não uma subcadeia a procurar; a ordem e as repetições não são relevantes.

A contagem termina antes do primeiro carácter não permitido ou do \0 final, que não é contado. Se s1 ou s2 for vazia, o resultado é 0. Nenhuma das cadeias é alterada. Ambos os argumentos têm de apontar para cadeias válidas terminadas em nulo; NULL não é válido. O resultado conta bytes, não caracteres Unicode.

No exemplo, n é 4: a contagem termina antes de x. text + n aponta para a parte restante x45; %zu apresenta um valor size_t.

Exemplos

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

int main(void)
{
    const char text[] = "1203x45";
    size_t n = strspn(text, "0123456789");
    printf("%zu\n", n);
    printf("%s\n", text + n);
    return 0;
}

Resultado

4
x45

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