Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje