std::size_t

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

工具庫

語言支援 型別支援（基本型別、RTTI） 庫特性測試宏 (C++20) 程式工具 變參函式 initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) 協程支援 (C++20) 契約支援 (C++26) 三路比較 three_way_comparablethree_way_comparable_with (C++20起)(C++20起) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20起)   is_eqis_ltis_lteq (C++20起)(C++20起)(C++20起)   is_neqis_gtis_gteq (C++20起)(C++20起)(C++20起)

通用工具 函式物件 位操作 (C++20) bitset hash (C++11) 關係運算符 (C++20 中棄用) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= 整數比較函式 cmp_equalcmp_lesscmp_less_than (C++20起)(C++20起)(C++20起)   cmp_not_equalcmp_greatercmp_greater_than (C++20起)(C++20起)(C++20起) in_range (C++20) 交換與型別操作 swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) 常用詞彙型別 pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

型別支援

基本型別
定寬整數型別 (C++11)
定寬浮點型別 (C++23)
ptrdiff_t size_t max_align_t (C++11)     byte (C++17)	nullptr_t (C++11) offsetof NULL
數值極限
numeric_limits
C 數值極限介面
執行時型別資訊
type_info type_index (C++11)	bad_typeid bad_cast

 

定義於標頭檔案 <cstddef>
定義於標頭檔案 <cstdio>
定義於標頭檔案 <cstdlib>
在標頭檔案 <cstring> 中定義
定義於標頭檔案 <ctime>
定義於標頭檔案 <cuchar>		(C++17 起)
在標頭檔案 <cwchar> 中定義
typedef /* implementation-defined */ size_t;

std::size_t 是下列運算子結果的無符號整數型別：

• sizeof

sizeof... alignof

(C++11 起)

如果程式試圖形成一個過大的型別（即，其物件表示中的位元組數超過 std::size_t 中可表示的最大值），則程式格式錯誤。

std::size_t 的位寬不小於 16。

(C++11 起)

注意

std::size_t 可以儲存任何型別（包括陣列）理論上可能的最大物件大小。在許多平臺上（分段地址系統除外），std::size_t 可以安全地儲存任何非成員指標的值，在這種情況下，它與 std::uintptr_t 是同義詞。

std::size_t 通常用於陣列索引和迴圈計數。使用其他型別（例如 unsigned int）進行陣列索引的程式可能會在例如 64 位系統上失敗，如果索引超過 UINT_MAX 或依賴於 32 位模運算。

在索引 C++ 容器（例如 std::string、std::vector 等）時，適當的型別是這些容器提供的巢狀型別 size_type。它通常被定義為 std::size_t 的同義詞。

std::size_t 的宣告是否在任何其他標準庫標頭檔案中可用是未指定的。即使標準要求使用 std::size_t，實現也可以避免引入此名稱。

std::size_t 的整數字面量字尾是 z 或 Z 與 u 或 U 的任意組合（即 zu、zU、Zu、ZU、uz、uZ、Uz 或 UZ）。

(C++23 起)

示例

執行此程式碼

#include <array>
#include <cstddef>
#include <iostream>
 
int main()
{
    std::array<std::size_t, 10> a;
 
    // Example with C++23 std::size_t literal
    for (auto i = 0uz; i != a.size(); ++i)
        std::cout << (a[i] = i) << ' ';
    std::cout << '\n';
 
    // Example of decrementing loop
    for (std::size_t i = a.size(); i--;)
        std::cout << a[i] << ' ';
    std::cout << '\n';
 
    // Note the naive decrementing loop:
    //  for (std::size_t i = a.size() - 1; i >= 0; --i) ...
    // is an infinite loop, because unsigned numbers are always non-negative
}

輸出

0 1 2 3 4 5 6 7 8 9
9 8 7 6 5 4 3 2 1 0

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
CWG 1122	C++98	std::size_t 被迴圈定義	它是實現定義的
CWG 1464	C++98	物件大小可能無法在 std::size_t 中表示	此類型別格式錯誤

參考資料

• C++23 標準 (ISO/IEC 14882:2024)

• 6.8.4 複合型別 [basic.compound] (p: 79-80)

• 7.6.2.5 Sizeof [expr.sizeof] (p: 136)

• 7.6.2.6 Alignof [expr.alignof] (p: 136)

• 17.2.4 大小、對齊和偏移 [support.types.layout] (p: 504-505)

• C++20 標準 (ISO/IEC 14882:2020)

• 6.8.3 複合型別 [basic.compound] (p: 75-76)

• 7.6.2.5 Sizeof [expr.sizeof] (p: 129-130)

• 7.6.2.6 Alignof [expr.alignof] (p: 130)

• 17.2.4 大小、對齊和偏移 [support.types.layout] (p: 507-508)

• C++17 標準 (ISO/IEC 14882:2017)

• 6.9.2 複合型別 [basic.compound] (p: 81-82)

• 8.3.3 Sizeof [expr.sizeof] (p: 121-122)

• 8.3.6 Alignof [expr.alignof] (p: 129)

• 21.2.4 大小、對齊和偏移 [support.types.layout] (p: 479)

• C++14 標準 (ISO/IEC 14882:2014)

• 3.9.2 複合型別 [basic.compound] (p: 73-74)

• 5.3.3 Sizeof [expr.sizeof] (p: 109-110)

• 5.3.6 Alignof [expr.alignof] (p: 116)

• 18.2 型別 [support.types] (p: 443-444)

• C++11 標準 (ISO/IEC 14882:2011)

• 5.3.3 Sizeof [expr.sizeof] (p: 111)

• 5.3.6 Alignof [expr.alignof] (p: 116)

• 18.2 型別 [support.types] (p: 454-455)

• C++03 標準 (ISO/IEC 14882:2003)

• 5.3.3 Sizeof [expr.sizeof] (p: 79)

• C++98 標準 (ISO/IEC 14882:1998)

• 5.3.3 Sizeof [expr.sizeof] (p: 77)

另請參閱

ptrdiff_t	減去兩個指標時返回的有符號整型 (typedef)
offsetof	標準佈局型別到指定成員的位元組偏移量 (函式宏)
整數字面量	二進位制，(C++14起) 十進位制、八進位制或十六進位制的整數型別數字
C 文件 for size_t