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

CKTIS / C++

std::size_t — o tipo para dimensões de objetos

std::size_t é um tipo inteiro sem sinal, definido pela implementação, que pode representar a dimensão de qualquer objeto em bytes. É o tipo de resultado de sizeof e é declarado em <cstddef>. Não pressuponha uma largura específica nem o utilize para representar valores negativos.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <cstddef>
std::size_t count = 0;

std::size_t designa um tipo inteiro sem sinal definido pela implementação, suficientemente grande para conter a dimensão de qualquer objeto em bytes. Inclua <cstddef> quando utilizar este nome. Não é um tipo de classe distinto; não pressuponha que significa sempre unsigned long ou que tem 64 bits.

Os operadores sizeof e sizeof... devolvem std::size_t. sizeof indica uma dimensão em bytes, não um número de elementos. Para um array propriamente dito, sizeof(values) / sizeof(values[0]) dá o número de elementos, porque a dimensão do array é o produto do número de elementos pela dimensão de cada elemento. Esta fórmula não funciona com um ponteiro: aplicar sizeof a um ponteiro mede o próprio ponteiro.

Utilize std::size_t para dimensões não negativas e índices adequados, não para valores que representem uma diferença negativa. Converter -1 para std::size_t produz o maior valor desse tipo, não um marcador de erro negativo. Verifique o intervalo dos dados com sinal antes de os converter; misturar tipos com e sem sinal exige cuidado.

O exemplo calcula o número de elementos de um array e depois soma-os usando um índice do tipo std::size_t. O resultado não depende do número de bytes ocupados por um int. O código-fonte fornecido é um projeto de norma em evolução, não uma edição C++23 congelada; o exemplo destina-se a verificação local em modo C++23.

Exemplos

#include <cstddef>
#include <iostream>

int main() {
    constexpr int values[] = {4, 7, 9};
    constexpr std::size_t count = sizeof(values) / sizeof(values[0]);
    static_assert(count == 3);

    int total = 0;
    for (std::size_t i = 0; i < count; ++i) {
        total += values[i];
    }

    std::cout << "count=" << static_cast<unsigned int>(count) << ", total=" << total << '\n';
}

Resultado

count=3, total=20

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