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

CKTIS / C

atol — função de biblioteca C23

`atol(const char *nptr)` de `<stdlib.h>` lê o inteiro decimal inicial e devolve `long int`. Ignora espaços, aceita sinal opcional e para no primeiro caráter exterior ao número.

Versão: C23

Sintaxe

long int atol(const char *nptr);

atol(const char *nptr) de <stdlib.h> lê o inteiro decimal inicial e devolve long int. Ignora espaços, aceita sinal opcional e para no primeiro caráter exterior ao número.

É adequada a contadores já validados usados por interfaces de tipo long. O exemplo converte realmente "+123456ms" em 123456 e imprime com o formato correto %ld.

A largura de long depende da plataforma e pode ser apenas 32 bits. Sem algarismos, 0 é ambíguo; fora de LONG_MIN..LONG_MAX, C23 dá comportamento indefinido, e nptr não pode ser NULL. strtol permite verificar fim e intervalo.

Exemplos

#include <stdio.h>
#include <stdlib.h>

int main(void) {
    long count = atol("+123456ms");
    printf("%ld\n", count);
    return 0;
}

Resultado

123456

É adequada a contadores já validados usados por interfaces de tipo `long`. O exemplo converte realmente `"+123456ms"` em `123456` e imprime com o formato correto `%ld`.

Fontes