Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes