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.