Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::size_t — typ rozmiarów obiektów

std::size_t to zdefiniowany przez implementację typ całkowity bez znaku, który może reprezentować rozmiar dowolnego obiektu w bajtach. Jest typem wyniku sizeof; deklarację udostępnia nagłówek <cstddef>. Nie należy zakładać konkretnej szerokości ani używać go do wartości ujemnych.

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

Składnia

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

std::size_t jest nazwą typu całkowitego bez znaku, zdefiniowanego przez implementację i wystarczająco dużego, aby pomieścić rozmiar dowolnego obiektu w bajtach. Dołącz <cstddef>, gdy używasz tej nazwy. Nie jest to odrębny typ klasowy; nie zakładaj, że zawsze oznacza unsigned long albo ma 64 bity.

Operatory sizeof i sizeof... zwracają std::size_t. sizeof podaje rozmiar w bajtach, a nie liczbę elementów. Dla rzeczywistej tablicy sizeof(values) / sizeof(values[0]) daje liczbę elementów, ponieważ rozmiar tablicy jest iloczynem liczby elementów i rozmiaru elementu. Ten wzór nie działa dla wskaźnika: sizeof wskaźnika mierzy sam wskaźnik.

Używaj std::size_t do nieujemnych rozmiarów i odpowiednich indeksów, nie do wartości oznaczających ujemną różnicę. Konwersja -1 do std::size_t daje największą wartość tego typu, a nie ujemny znacznik błędu. Przed konwersją danych ze znakiem sprawdzaj ich zakres; mieszanie typów ze znakiem i bez znaku wymaga uwagi.

Przykład oblicza liczbę elementów tablicy, a następnie sumuje je, używając indeksu typu std::size_t. Wynik nie zależy od liczby bajtów zajmowanych przez int. Podane źródło jest rozwijanym szkicem standardu, a nie zamrożonym wydaniem C++23; przykład jest przeznaczony do lokalnej weryfikacji w trybie C++23.

Przykłady

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

Wynik

count=3, total=20

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła