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.