C++ Forward_list::cbefore_begin() 函式

---

---

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

這個forward_list的元素充當佔位符，嘗試訪問它會導致未定義行為。返回的迭代器可以與emplace_after()、erase_after()、insert_after()和splice_after()函式一起使用，以在返回的迭代器位置插入、刪除和拼接元素。

cbefore_begin()函式類似於C++ std::forward_list中的before_begin()函式。

語法

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

const_iterator cbefore_begin();

引數

• 它不接受任何引數。

返回值

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

示例1

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

在下面的程式中，我們使用C++ std::forward_list::cbefore_begin()函式來獲取此forward_list {1, 2, 3, 4, 5}第一個元素之前元素的常量迭代器。

#include<iostream>
#include<forward_list>
using namespace std;
int main() {
   //create a forward_list
   forward_list<int> num_list = {1, 2, 3, 4, 5};
   cout<<"The num_list contents are: "<<endl;
   for(int n : num_list){
      cout<<n<<endl;
   }
   //using the cbefore_begin() function
   auto it = num_list.cbefore_begin();
   cout<<"The constant iterator to the element before the first element is: "<<*it;
}

輸出

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

The num_list contents are: 
1
2
3
4
5
The constant iterator to the element before the first element is: 0

示例2

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

以下是C++ std::forward_list::cbefore_begin()函式的另一個示例。在這裡，我們建立一個名為char_list的forward_list（char型別），內容為{'B', 'C', 'E', 'F'}。然後，我們使用cbefore_begin()函式獲取指向此容器第一個元素之前元素的常量迭代器，並使用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 cbefore_begin() function
   auto it = char_list.cbefore_begin();
   cout<<"The constant 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
The constant iterator is: �
The char_list contents after inserting new element: 
A
B
C
D
E

示例3

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

在這個例子中，我們建立一個名為fruits的forward_list（string型別），內容為{"Apple", "Banana", "Orange", "Grapes", "Guava"}。然後，使用cbefore_begin()函式，我們嘗試獲取指向此容器第一個元素之前元素的常量迭代器，並使用insert_after()函式，我們嘗試在返回的迭代器位置插入一個新元素"Pear"。

#include<iostream>
#include<forward_list>
using namespace std;
int main() {
   //create a forward_list
   forward_list<string> fruits = {"Apple", "Banana", "Orange", "Grapes", "Guava"};
   cout<<"The fruits forward_list contents are: "<<endl;
   for(string n : fruits){
      cout<<n<<endl;
   }
   //using the cbefore_begin() function
   auto it = fruits.cbefore_begin();
   cout<<"The constant iterator is: "<<*it<<endl;
   //using the insert_after()function
   fruits.insert_after(it, "Pear");
   cout<<"The fruits forward_list contents after inserting new element: "<<endl;
   for(string s : fruits){
      cout<<s<<endl;
   }
}

輸出

以下是上述程式的輸出：

The fruits forward_list contents are: 
Apple
Banana
Orange
Grapes
Guava
The constant iterator is: 
The fruits forward_list contents after inserting new element: 
Pear
Apple
Banana
Orange
Grapes
Guava