CKTIS / C++
std::size_t — typ pro velikosti objektů
std::size_t je implementací definovaný celočíselný typ bez znaménka, který dokáže vyjádřit velikost libovolného objektu v bajtech. Je návratovým typem sizeof a deklaruje se v <cstddef>. Nepředpokládejte konkrétní šířku ani jej nepoužívejte k reprezentaci záporných hodnot.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cstddef>
std::size_t count = 0;std::size_t označuje implementací definovaný celočíselný typ bez znaménka, který je dostatečně velký, aby pojal velikost libovolného objektu v bajtech. Pokud tento název používáte, zahrňte <cstddef>. Nejde o samostatný třídní typ; nepředpokládejte, že vždy znamená unsigned long nebo má 64 bitů.
Operátory sizeof a sizeof... vracejí std::size_t. sizeof udává velikost v bajtech, nikoli počet prvků. U skutečného pole výraz sizeof(values) / sizeof(values[0]) udává počet jeho prvků, protože velikost pole je součinem počtu prvků a velikosti jednoho prvku. Tento vzorec nefunguje pro ukazatel: použití sizeof na ukazatel měří samotný ukazatel.
std::size_t používejte pro nezáporné velikosti a vhodné indexy, nikoli pro hodnoty představující záporný rozdíl. Převod -1 na std::size_t vytvoří největší hodnotu tohoto typu, nikoli zápornou chybovou hodnotu. Před převodem kontrolujte rozsah vstupů se znaménkem; kombinování typů se znaménkem a bez znaménka vyžaduje opatrnost.
Příklad vypočítá počet prvků pole a poté je sečte pomocí indexu typu std::size_t. Výsledek nezávisí na tom, kolik bajtů zabírá int. Dodaný zdroj je vyvíjející se návrh standardu, nikoli zmrazené vydání C++23; příklad je určen k místnímu ověření v režimu C++23.
Příklady
#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';
}
Výsledek
count=3, total=20
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.