forward_list 類別

描述控制項目變更長度序列的物件。 序列儲存為節點的單一連結清單，每個包含型別 Type 的成員。

template<
    class Type, 
    class Allocator = allocator<Type> 
>
class forward_list 

參數

參數	說明
Type	要存放在 forward_list 中的項目資料類型。
Allocator	儲存的配置器物件，其封裝記憶體的 forward_list 配置和解除配置的詳細資料。 這個參數是一個選擇性項目。 預設值為配置器<Type>。

備註

forward_list 物件，為它控制透過以 allocator 類別 為基礎的類別 Allocator 所儲存的物件之序列 ( 通常稱為 std::allocator) 配置並釋放記憶體區域。 如需詳細資訊，請參閱配置器。 配置器物件必須具有外部介面和樣板類別相同的 allocator 物件。

注意事項
如果容器物件是指定時，儲存的配置器物件不會複製。

在受控制序列的項目透過 forward_list 被清除時，迭代器、指標和參考可能會變成無效。 在受控制序列上透過 forward_list 執行的插入及接合，不會使迭代器無效。

對受控制序列的添加可能由呼叫 forward_list::insert_after 時發生，是唯一呼叫建構函式 Type(const _Type&) 的成員函式。 forward_list 也可以呼叫移動建構函式。 如果這類運算式擲回例外狀況，容器物件不會插入新項目和重新擲回例外狀況。 因此，當這類例外狀況發生時，樣板類別 forward_list 物件會處於已知狀態被保留。

建構函式

forward_list

建構屬於 forward_list 類型的物件。

Typedef

allocator_type	表示轉接清單物件的配置器類別之型別。
const_iterator	提供轉接清單的常數迭代器之型別。
const_pointer	提供轉接清單中 const 項目之指標的型別。
const_reference	提供常數參考給轉接清單中的項目之型別。
difference_type	可以用來表示轉接清單之項目的數目在某個範圍的項目之間帶正負號的整數類資料型別指向迭代器。
Iterator	提供轉接清單的迭代器之型別。
指標	提供轉接清單中的項目之指標的型別。
參照	提供轉接清單中項目之參考的型別。
size_type	表示兩個項目之間的不帶正負號的距離之型別。
value_type	表示轉接清單中儲存之項目的類型。

成員函式

assign	清除轉接清單上的項目，並複製一組新的項目至目標轉接清單。
before_begin	傳回迭代器，在轉接清單的第一個項目之前的位置定址。
begin	傳回迭代器，在轉接清單中的第一個項目定址。
cbefore_begin	傳回常數迭代器，在轉接清單的第一個項目之前的位置定址。
cbegin	傳回常數迭代器，在轉接清單中的第一個項目定址。
cend	傳回常數迭代器，在轉接清單中最後一個項目的下一個位置定址。
clear	清除轉接清單中的所有項目。
emplace_after	移動建構新的項目，在指定的位置之後。
emplace_front	將已建置的項目加入至清單的開頭。
empty	測試轉接清單是否是空的。
end	傳回迭代器，在轉接清單中最後一個項目的下一個位置定址。
erase_after	從這個轉接清單的指定位置之後移除項目。
front	傳回轉接清單中第一個項目的參考。
get_allocator	傳回用於建構轉接清單的配置器物件之複本，。
insert_after	將項目新增至轉接清單的指定位置之後。
max_size	傳回轉接清單的最大長度。
merge	從引數清單移除項目、插入到目標轉接清單，以及以遞增順序或按其他指定的順序排序新的、合併的項目。
pop_front	刪除轉接清單開頭的項目。
push_front	將項目新增至轉接清單的開頭。
remove	清除在轉接清單符合指定值的項目。
remove_if	從轉接清單中清除滿足指定述詞的項目。
resize	指定轉接清單的新大小。
reverse	反轉項目在轉接清單中出現的順序。
sort	以遞增或述詞指定的順序排列項目。
splice_after	Restitches 節點之間的連結。
交換	交換兩個轉接清單的項目。
unique	移除通過指定測試的相鄰項目。

運算子

operator=

用另一個轉接清單複本來取代這個轉接清單的項目。

需求

標題: <forward_list>

命名空間: std

請參閱

參考

<forward_list>

其他資源

<forward_list> 成員