CKTIS / C++
std::size_t — el tipo para tamaños de objetos
std::size_t es un tipo entero sin signo, definido por la implementación, que puede representar el tamaño de cualquier objeto en bytes. Es el tipo de resultado de sizeof y se declara en <cstddef>. No presupongas una anchura concreta ni lo uses para representar valores negativos.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#include <cstddef>
std::size_t count = 0;std::size_t designa un tipo entero sin signo definido por la implementación, lo bastante grande para contener el tamaño de cualquier objeto en bytes. Incluye <cstddef> cuando uses este nombre. No es un tipo de clase distinto; no des por hecho que siempre significa unsigned long o que tiene 64 bits.
Los operadores sizeof y sizeof... devuelven std::size_t. sizeof indica un tamaño en bytes, no una cantidad de elementos. Para un array real, sizeof(values) / sizeof(values[0]) da su número de elementos, porque el tamaño del array es el producto de la cantidad de elementos por el tamaño de cada elemento. Esta fórmula no funciona con un puntero: aplicar sizeof a un puntero mide el propio puntero.
Usa std::size_t para tamaños no negativos e índices adecuados, no para valores que representen una diferencia negativa. Convertir -1 a std::size_t produce el valor más grande de ese tipo, no un indicador de error negativo. Comprueba el rango de los datos con signo antes de convertirlos; mezclar tipos con signo y sin signo requiere cuidado.
El ejemplo calcula el número de elementos de un array y luego los suma usando un índice de tipo std::size_t. El resultado no depende de cuántos bytes ocupa un int. El código fuente proporcionado es un borrador de estándar en evolución, no una edición C++23 congelada; el ejemplo está pensado para verificarse localmente en modo C++23.
Ejemplos
#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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.