C++ forward_list::before_begin() 函式

C++ 的 std::forward_list::before_begin() 函式用於獲取指向 forward_list 容器第一個元素之前元素的迭代器。

此 forward_list 的元素充當佔位符。此函式返回的迭代器可與 emplace_after()、erase_after()、insert_after() 和 splice_after() 函式一起使用，以在返回的迭代器位置插入、刪除和替換元素。before_begin() 函式類似於 C++ std::forward_list 中的 cbefore_begin() 函式。

語法

以下是 C++ std::forward_list::before_begin() 函式的語法：

iterator before_begin();

引數

它不接受任何引數。

返回值

此函式返回指向第一個元素之前元素的迭代器。

示例 1

如果 forward_list 為 int 型別，則 before_begin() 函式返回指向第一個元素之前元素的迭代器。

在下面的程式中，我們使用 C++ std::forward_list::before_begin() 函式來檢索指向此 forward_list {10, 20, 30, 40, 50} 的第一個元素之前元素的迭代器。

#include<iostream>
#include<forward_list>
using namespace std;
int main() {
   //create a forward_list
   forward_list<int> num_list = {10, 20, 30, 40, 50};
   cout<<"The num_list contents are: "<<endl;
   for(int n : num_list){
      cout<<n<<endl;
   }
   //using the before_begin() function
   auto it = num_list.before_begin();
   cout<<"An iterator which points to the position before the first element is: "<<*it;
}

輸出

讓我們編譯並執行上述程式，這將產生以下結果：

The num_list contents are:
10
20
30
40
50
An iterator which points to the position before the first element is: 0

示例 2

如果 forward_list 為 char 型別，則此函式返回指向第一個元素之前元素的迭代器。

以下是 C++ std::forward_list::before_begin() 函式的另一個示例。在這裡，我們建立一個名為 char_list 的 forward_list（char 型別），其內容為 {'b', 'c', 'd', 'e'}。然後，我們使用 before_begin() 函式來檢索指向此 forward_list 的第一個元素之前元素的迭代器，並使用 emplace_after() 函式在返回的迭代器位置插入一個新元素 'a'。

#include<iostream>
#include<forward_list>
using namespace std;
int main() {
   //create a forward_list
   forward_list<char> char_list = {'b', 'c', 'd', 'e'};
   cout<<"The char_list contents are: "<<endl;
   for(char c : char_list){
      cout<<c<<endl;
   }
   //using the before_begin() function
   auto it = char_list.before_begin();
   cout<<"An iterator is: "<<*it<<endl;
   //using emplace_after() function
   char_list.emplace_after(it, 'a');
   cout<<"The char_list contents after inserting new element: "<<endl;
   for(char c: char_list){
      cout<<c<<endl;
   }
}

輸出

這將生成以下輸出：

The char_list contents are: 
b
c
d
e
An iterator is: 0
The char_list contents after inserting new element: 
a
b
c
d
e

示例 3

除了 int 型別和 char 型別的 forward_list 之外，我們還可以檢索 string 型別 forward_list 元素的迭代器。

在這個例子中，我們建立了一個名為 names 的 forward_list（string 型別），其內容為 {"Raju", "Aman", "Rahul", "Ganesh"}。然後，使用 before_begin() 函式，我們嘗試檢索指向第一個元素之前元素的迭代器，並使用 insert_after() 函式在返回的迭代器位置插入一個新元素 "Ramesh"。

#include<iostream>
#include<forward_list>
using namespace std;
int main() {
   //create a forward_list
   forward_list<string> names = {"Raju", "Aman", "Rahul", "Ganesh"};
   cout<<"The names forward_list contents are: "<<endl;
   for(string n : names){
      cout<<n<<endl;
   }
   //using the before_begin() function
   auto it = names.before_begin();
   cout<<"An iterator is: "<<*it<<endl;
   //using the insert_after()function
   names.insert_after(it, "Ramesh");
   cout<<"The names forward_list contents after inserting new element: "<<endl;
   for(string s : names){
      cout<<s<<endl;
   }
}

輸出

以下是上述程式的輸出：

The names forward_list contents are: 
Raju
Aman
Rahul
Ganesh
An iterator is: 
The names forward_list contents after inserting new element: 
Ramesh
Raju
Aman
Rahul
Ganesh

列印頁面