Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::size_t — il tipo per le dimensioni degli oggetti

std::size_t è un tipo intero senza segno definito dall’implementazione, in grado di rappresentare la dimensione di qualsiasi oggetto in byte. È il tipo restituito da sizeof ed è dichiarato in <cstddef>. Non presumere una larghezza specifica e non usarlo per rappresentare valori negativi.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

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

std::size_t indica un tipo intero senza segno definito dall’implementazione, abbastanza grande da contenere la dimensione di qualsiasi oggetto in byte. Includi <cstddef> quando usi questo nome. Non è un tipo di classe distinto; non presumere che significhi sempre unsigned long o che abbia 64 bit.

Gli operatori sizeof e sizeof... restituiscono std::size_t. sizeof indica una dimensione in byte, non il numero di elementi. Per un array vero e proprio, sizeof(values) / sizeof(values[0]) dà il numero di elementi, perché la dimensione dell’array è il prodotto del numero di elementi per la dimensione di un elemento. Questa formula non funziona con un puntatore: applicare sizeof a un puntatore misura il puntatore stesso.

Usa std::size_t per dimensioni non negative e indici appropriati, non per valori che rappresentano una differenza negativa. Convertire -1 in std::size_t produce il valore massimo di quel tipo, non un valore sentinella negativo per gli errori. Controlla l’intervallo dei dati con segno prima di convertirli; mescolare tipi con e senza segno richiede attenzione.

L’esempio calcola il numero di elementi di un array e poi li somma usando un indice di tipo std::size_t. Il risultato non dipende dal numero di byte occupati da un int. Il sorgente fornito è una bozza di standard in evoluzione, non un’edizione C++23 definitiva; l’esempio è pensato per la verifica locale in modalità C++23.

Esempi

#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';
}

Risultato

count=3, total=20

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti