list (STL/CLR)

このテンプレート クラスは、オブジェクトをコントロールと双方向アクセスできる要素の可変長シーケンスを記述します。 ノードの双方向リンク リスト、保存の 1 要素として要素のシーケンスを管理するために list コンテナーを使用します。

以下の説明では GValue は Value な型が Value^場合、後者は ref 型である同じです。

template<typename Value>
    ref class list
        :   public
        System::ICloneable,
        System::Collections::IEnumerable,
        System::Collections::ICollection,
        System::Collections::Generic::IEnumerable<GValue>,
        System::Collections::Generic::ICollection<GValue>,
        Microsoft::VisualC::StlClr::IList<GValue>
    { ..... };

パラメーター


  • 被制御シーケンス内の要素の型。

メンバー

型定義

説明

list::const_iterator (STL/CLR)

被制御シーケンスの定数反復子の型です。

list::const_reference (STL/CLR)

要素への定数参照の型です。

list::const_reverse_iterator (STL/CLR)

被制御シーケンスの定数反転反復子の型です。

list::difference_type (STL/CLR)

2 つの要素間の距離を表す、符号付きの型です。

list::generic_container (STL/CLR)

コンテナーのジェネリック インターフェイスの種類。

list::generic_iterator (STL/CLR)

コンテナーのジェネリック インターフェイスの反復子の型。

list::generic_reverse_iterator (STL/CLR)

コンテナーのジェネリック インターフェイスの反転反復子の型。

list::generic_value (STL/CLR)

コンテナーのジェネリック インターフェイスの要素の型。

list::iterator (STL/CLR)

被制御シーケンスの反復子の型です。

list::reference (STL/CLR)

要素への参照の型です。

list::reverse_iterator (STL/CLR)

被制御シーケンスの反転反復子の型です。

list::size_type (STL/CLR)

2 つの要素間の距離を表す、符号付きの型です。

list::value_type (STL/CLR)

要素の型。

メンバー関数

説明

list::assign (STL/CLR)

すべての要素を置き換えます。

list::back (STL/CLR)

最後の要素にアクセスします。

list::begin (STL/CLR)

被制御シーケンスの先頭を指定します。

list::clear (STL/CLR)

すべての要素を削除します。

list::empty (STL/CLR)

要素が存在しないかどうかをテストします。

list::end (STL/CLR)

被制御シーケンスの末尾を指定します。

list::erase (STL/CLR)

指定した位置にある要素を削除します。

list::front (STL/CLR)

最初の要素にアクセスします。

list::insert (STL/CLR)

指定した位置の要素を追加します。

list::list (STL/CLR)

コンテナー オブジェクトを構築します。

list::merge (STL/CLR)

2 つの順序付けされた被制御シーケンスをマージします。

list::pop_back (STL/CLR)

最後の要素を削除します。

list::pop_front (STL/CLR)

最初の要素を削除します。

list::push_back (STL/CLR)

新しい最後の要素を追加します。

list::push_front (STL/CLR)

新しい先頭要素を追加します。

list::rbegin (STL/CLR)

反転被制御シーケンスの先頭を指定します。

list::remove (STL/CLR)

指定された値に要素を削除します。

list::remove_if (STL/CLR)

指定したテストに合格する要素を削除します。

list::rend (STL/CLR)

反転被制御シーケンスの末尾を指定します。

list::resize (STL/CLR)

要素の数を変更します。

list::reverse (STL/CLR)

被制御シーケンスを反転させます。

list::size (STL/CLR)

要素の数をカウントします。

list::sort (STL/CLR)

被制御シーケンスを順序付けます。

list::splice (STL/CLR)

ノード間のリンクを再接合します。

list::swap (STL/CLR)

2 つのコンテナーのコンテンツを交換します。

list::to_array (STL/CLR)

新しい配列に被制御シーケンスをコピーします。

list::unique (STL/CLR)

指定されたテストに合格した隣接する要素を削除します。

プロパティ

説明

list::back_item (STL/CLR)

最後の要素にアクセスします。

list::front_item (STL/CLR)

最初の要素にアクセスします。

演算子

説明

list::operator= (STL/CLR)

被制御シーケンスを置き換えます。

operator!= (list) (STL/CLR)

list オブジェクトが list の別のオブジェクトと等しくないかどうかを判定します。

operator< (list) (STL/CLR)

list オブジェクトが list の別のオブジェクトより小さいかどうかを判定します。

operator<= (list) (STL/CLR)

list オブジェクトが list の別のオブジェクト以下かどうかを判定します。

operator== (list) (STL/CLR)

list オブジェクトが list の別のオブジェクトと等しいかどうかを判定します。

operator> (list) (STL/CLR)

list オブジェクトが list の別のオブジェクトより大きいかどうかを判定します。

operator>= (list) (STL/CLR)

list オブジェクトが list の別のオブジェクト以上かどうかを判定します。

インターフェイス

インターフェイス

説明

ICloneable

オブジェクトを複製します。

IEnumerable

要素によるシーケンス。

ICollection

要素のグループを保持します。

IEnumerable

指定された要素を通じてシーケンス。

ICollection

指定された要素のグループを保持します。

IListValue<>

一般的なコンテナーを保持します。

解説

オブジェクトは、双方向リンクの個々のノードに追加したときに被制御シーケンスに対するストレージの割り当て。 これにより、ノード間のリンクを変更して、別の場所に 1 ノードの内容をコピーして、要素を再配置されません。 これはブロックの最初の要素を除いた要素を自由に挿入および削除できることを意味します。 したがって、リストは queue (STL/CLR) テンプレート クラス stack (STL/CLR)の基になるコンテナーにすることをお勧めします。

つまり、被制御シーケンスの要素を指定する反復子を持つ隣接する要素にステップ インできる list のオブジェクトが双方向の反復子。 特別なヘッド ノードは list::end (STL/CLR)()が返す反復子に対応します。 存在する場合、被制御シーケンスの最後の要素にアクセスするためにこの反復子をデクリメントすることができます。 ヘッド ノードに到達するリストの反復子をインクリメントすることができます end()と等号を比較します。 ただし、end()が返す反復子を逆参照できません。

直接数値位置が、リストの要素を参照できない点に注意してください。。これはランダム アクセス反復子を必要とします。 このリストは、テンプレート クラス priority_queue (STL/CLR)の根本的なコンテナーとして使用可能な not です。

リストの反復子は、関連するコンテナーにハンドルを格納する関連付けられたリスト ノードへのハンドルを格納します。 関連するコンテナー オブジェクトでのみ反復子を使用できます。 リストの反復子は、関連付けられたリスト ノードをリストに関連付けられている限り有効です。 また、有効な反復子は dereferencable です。指定した要素の値にアクセスするか、または変更するために使用できます。。これは end()と等しくない場合。

要素に設定するか、削除して、格納されている値のデストラクターを呼び出します。 コンテナーが破棄されると、すべての要素を消去します。 したがって、要素の型が ref クラスにあるコンテナー要素がコンテナーを重視されることを確認します。 ただし、Handles のコンテナーが not の要素を破棄されます。

必要条件

ヘッダー: の <cliext/リスト>

名前空間: の cliext

参照

関連項目

deque (STL/CLR)

priority_queue (STL/CLR)

queue (STL/CLR)

stack (STL/CLR)

vector (STL/CLR)

その他の技術情報

STL/CLR ライブラリ リファレンス