std::allocator_traits

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ(C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ(C++17)

正規表現ライブラリ(C++11)

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

動的メモリ管理

スマートポインタ unique_ptr (C++11) shared_ptr (C++11) weak_ptr (C++11) auto_ptr (C++17未満) owner_less (C++11) enable_shared_from_this (C++11) bad_weak_ptr (C++11) default_delete (C++11) アロケータ allocator allocator_traits (C++11) allocator_arg_t (C++11) allocator_arg (C++11) uses_allocator (C++11) uses_allocator_construction_args (C++20) make_obj_using_allocator (C++20) uninitialized_construct_using_allocator (C++20) scoped_allocator_adaptor (C++11) pmr::polymorphic_allocator (C++17) メモリリソース pmr::memory_resource (C++17) pmr::get_default_resource (C++17) pmr::set_default_resource (C++17) pmr::new_delete_resource (C++17) pmr::null_memory_resource (C++17) pmr::synchronized_pool_resource (C++17) pmr::unsynchronized_pool_resource (C++17) pmr::monotonic_buffer_resource (C++17) pmr::pool_options (C++17)

未初期化記憶域 uninitialized_copy uninitialized_fill uninitialized_move (C++17) uninitialized_default_construct (C++17) uninitialized_value_construct (C++17) destroy (C++17) destroy_at (C++17) uninitialized_copy_n (C++11) uninitialized_fill_n uninitialized_move_n (C++17) uninitialized_default_construct_n (C++17) uninitialized_value_construct_n (C++17) destroy_n (C++17) construct_at (C++20) raw_storage_iterator (C++20未満) get_temporary_buffer (C++20未満) return_temporary_buffer (C++20未満) ガベージコレクションサポート declare_reachable (C++11) undeclare_reachable (C++11) declare_no_pointers (C++11) undeclare_no_pointers (C++11) pointer_safety (C++11) get_pointer_safety (C++11) その他 pointer_traits (C++11) to_address (C++20) addressof (C++11) align (C++11) assume_aligned (C++20) C のライブラリ malloc aligned_alloc (C++17) calloc realloc free 低水準のメモリ管理

 

std::allocator_traits

メンバ関数

allocator_traits::allocate

allocator_traits::deallocate

allocator_traits::construct

allocator_traits::destroy

allocator_traits::max_size

allocator_traits::select_on_container_copy_construction

 

ヘッダ <memory> で定義
template<class Alloc > struct allocator_traits;		(C++11以上)

allocator_traits クラステンプレートは Allocator の様々な性質にアクセスするための標準的な方法を提供します。 標準のコンテナおよびその他の標準ライブラリのコンポーネントはこのテンプレートを通してアロケータにアクセスします。 これにより、 allocator_traits のユーザ提供の特殊化が必要な機能をすべて実装している限り、任意のクラス型をアロケータとして使用することができます。

デフォルトの特殊化されていない allocator_traits は以下のメンバを持ちます。

メンバ型

型	定義
allocator_type	Alloc
value_type	Alloc::value_type
pointer	存在すれば Alloc::pointer、そうでなければ value_type*
const_pointer	存在すれば Alloc::const_pointer、そうでなければ std::pointer_traits<pointer>::rebind<const value_type>
void_pointer	存在すれば Alloc::void_pointer、そうでなければ std::pointer_traits<pointer>::rebind<void>
const_void_pointer	存在すれば Alloc::const_void_pointer、そうでなければ std::pointer_traits<pointer>::rebind<constvoid>
difference_type	存在すれば Alloc::difference_type、そうでなければ std::pointer_traits<pointer>::difference_type
size_type	存在すれば Alloc::size_type、そうでなければ std::make_unsigned<difference_type>::type
propagate_on_container_copy_assignment	存在すれば Alloc::propagate_on_container_copy_assignment、そうでなければ std::false_type
propagate_on_container_move_assignment	存在すれば Alloc::propagate_on_container_move_assignment、そうでなければ std::false_type
propagate_on_container_swap	存在すれば Alloc::propagate_on_container_swap、そうでなければ std::false_type
is_always_equal(C++17以上)	存在すれば Alloc::is_always_equal、そうでなければ std::is_empty<Alloc>::type

メンバエイリアステンプレート

型	定義
rebind_alloc<T>	存在すれば Alloc::rebind<T>::other、そうでなくこの Alloc が Alloc<U, Args> であれば Alloc<T, Args>
rebind_traits<T>	std::allocator_traits<rebind_alloc<T>>

メンバ関数

allocate [静的]	アロケータを使用して未初期化記憶域を確保します (パブリック静的メンバ関数)
deallocate [静的]	アロケータを使用して記憶域を解放します (パブリック静的メンバ関数)
construct [静的]	確保された記憶域にオブジェクトを構築します (関数テンプレート)
destroy [静的]	確保された記憶域に格納されているオブジェクトを破棄します (関数テンプレート)
max_size [静的]	アロケータでサポートされている最大オブジェクトサイズを返します (パブリック静的メンバ関数)
select_on_container_copy_construction [静的]	標準コンテナをコピーした後で使用するためのアロケータを取得します (パブリック静的メンバ関数)

関連項目

allocator	デフォルトのアロケータ (クラステンプレート)
scoped_allocator_adaptor (C++11)	多段コンテナのための多段アロケータを実装します (クラステンプレート)
pointer_traits (C++11)	ポインタライクな型に関する情報を提供します (クラステンプレート)