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

CKTIS / C

Limites e larguras dos tipos inteiros

As macros de <limits.h> descrevem os intervalos e as larguras dos tipos inteiros de uma implementação. Usa-as em vez de pressupor um byte de 8 bits ou um int de 32 bits.

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

Sintaxe

#include <limits.h>
/* Use object-like macros directly: INT_MIN, INT_MAX, INT_WIDTH. */

<limits.h> disponibiliza macros do tipo objeto. Os pares mínimo/máximo são: SCHAR_MIN/SCHAR_MAX (signed char), SHRT_MIN/SHRT_MAX (short), INT_MIN/INT_MAX (int), LONG_MIN/LONG_MAX (long) e LLONG_MIN/LLONG_MAX (long long). Os máximos correspondentes dos tipos sem sinal são UCHAR_MAX, USHRT_MAX, UINT_MAX, ULONG_MAX e ULLONG_MAX; o mínimo é 0.

CHAR_MIN/CHAR_MAX dependem de o tipo char ter ou não sinal: correspondem aos limites de signed char ou ao intervalo 0–UCHAR_MAX. CHAR_BIT indica o número de bits por byte, pelo menos 8. CHAR_WIDTH, SCHAR_WIDTH e UCHAR_WIDTH são iguais a este valor. Os pares SHRT_WIDTH/USHRT_WIDTH, INT_WIDTH/UINT_WIDTH, LONG_WIDTH/ULONG_WIDTH e LLONG_WIDTH/ULLONG_WIDTH descrevem as larguras dos tipos correspondentes e são iguais dentro de cada par.

A largura inclui o bit de sinal, mas exclui os bits de preenchimento; não tem necessariamente de ser igual a sizeof(type) * CHAR_BIT. C23 acrescenta as macros _WIDTH e BITINT_MAXWIDTH. BOOL_WIDTH tem o valor 1. C23 não define a macro BOOL_MAX em <limits.h>. BITINT_MAXWIDTH limita N em _BitInt(N) e é pelo menos igual a ULLONG_WIDTH. MB_LEN_MAX é o número máximo de bytes por carácter multibyte em todas as configurações regionais suportadas, não a largura de um tipo inteiro.

Verifica INT_MAX antes de incrementar: o overflow de um tipo com sinal tem comportamento indefinido. O exemplo evita-o sem pressupor um determinado tamanho de int. A existência de uma opção de compilador C23 no repositório, por si só, não comprova o suporte de todas as macros nem do ambiente de execução de produção.

Exemplos

#include <limits.h>
#include <stdio.h>

static int increment(int *value)
{
    if (*value == INT_MAX) {
        return 0;
    }
    ++*value;
    return 1;
}

int main(void)
{
    int value = INT_MAX - 1;
    int first = increment(&value);
    int second = increment(&value);
    printf("%d %d %d\n", first, second, value == INT_MAX);
    return 0;
}

Resultado

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