max_size.md

max_size

• memory[meta header]
• std[meta namespace]
• allocator_traits[meta class]
• function[meta id-type]
• cpp11[meta cpp]

static size_type max_size(Alloc& a);                            // C++11
static size_type max_size(const Alloc& a) noexcept;             // C++14 から C++ 17 まで
static constexpr size_type max_size(const Alloc& a) noexcept;    // C++20 から

概要

一度に確保可能なメモリの最大サイズを取得する。

戻り値

a.max_size()という式が有効ならその戻り値を返し、そうでなければデフォルト実装として以下を返す：

std::numeric_limits<size_type>::max() / sizeof(value_type)

• max()[link /reference/limits/numeric_limits/max.md]

例

#include <iostream>
#include <memory>

int main()
{
  std::allocator<int> alloc;
  using traits = std::allocator_traits<decltype(alloc)>;

  std::cout << traits::max_size(alloc) << std::endl;
}

• max_size[color ff0000]

出力例

4611686018427387903

バージョン

言語

• C++11

処理系

• Clang: 3.0 [mark verified]
• GCC: 4.7.3 [mark verified]
• ICC: ??
• Visual C++: 2012 [mark verified], 2013 [mark verified]

参照

• LWG Issue 2162. allocator_traits::max_size missing noexcept
• LWG Issue 2284. Inconsistency in allocator_traits::max_size
• LWG Issue 2466. allocator_traits::max_size() default behavior is incorrect

参照

• P0784R7 More constexpr containers