C++ List::emplace_front() 函式

---

---

C++ 的 std::list::emplace_front() 函式用於在列表開頭插入新元素。

它將指定的值插入到當前列表的開頭，並將列表大小增加一。emplace_front() 函式的返回型別為 void，這意味著它不返回值。

emplace_front() 函式類似於 push_front() 函式，push_front() 函式插入給定元素並在列表開頭新增物件的副本，而 emplace_front() 函式插入元素並在列表開頭就地構造物件，透過避免複製操作，可能會提高效能。

語法

以下是 std::list::emplace_front() 函式的語法：

void emplace_front (val);

引數

• val − 要插入到列表中的新元素值。

返回值

此函式不返回值。

示例 1

在下面的程式中，我們使用 C++ std::list::emplace_front() 函式在當前列表 {2, 3, 4, 5} 的開頭插入新元素值 1。

#include<iostream>
#include<list>
using namespace std;

int main() {
   //create a list
   list<int> num_list = {2, 3, 4, 5};
   cout<<"List elements before emplace_front operation: ";
   for(int n : num_list) {
      cout<<n<<" ";
   }
   //element value
   int val = 1;
   //using emplace_front() function
   num_list.emplace_front(val);
   cout<<"\nList elements after emplace_front() operation: "<<endl;
   for(int n : num_list) {
      cout<<n<<" ";
   }
   return 0;
}

輸出

以上程式產生以下輸出：

List elements before emplace_front operation: 2 3 4 5 
List elements after emplace_front() operation: 
1 2 3 4 5

示例 2

除了 int 元素之外，您還可以將 char 元素插入列表（char 型別）。

以下是 C++ std::list::emplace_front() 函式的另一個示例。在這裡，我們建立一個名為 vowels 的列表（char 型別），其值為 {'e', 'i', 'o', 'u'}。然後，使用 emplace_front() 函式，我們嘗試在這個列表的開頭插入一個新的 char 元素 'a'。

#include<iostream>
#include<list>
using namespace std;

int main() {
   //create a list
   list<char> vowels = {'e', 'i', 'o', 'u'};
   cout<<"List elements before emplace_front operation: ";
   for(char v : vowels) {
      cout<<v<<" ";
   }
   //element value
   char val = 'a';
   //using emplace_front() function
   vowels.emplace_front(val);
   cout<<"\nList elements after emplace_front() operation: "<<endl;
   for(char v : vowels) {
      cout<<v<<" ";
   }
   return 0;
}

輸出

執行上述程式後，將生成以下輸出：

List elements before emplace_front operation: e i o u 
List elements after emplace_front() operation: 
a e i o u

示例 3

在列表（string 型別）中插入字串元素。

在這個例子中，我們建立一個名為 fruits 的列表（string 型別），其值為 {"Orange", "Banana", "Grapes", "Apple"}。然後，使用 emplace_front() 函式，我們嘗試在這個列表的開頭插入字串元素 "Papaya"。

#include<iostream>
#include<list>
using namespace std;

int main() {
   //create a list
   list<string> fruits = {"Orange", "Banana", "Grapes", "Apple"};
   cout<<"List elements before emplace_front operation: ";
   for(string f : fruits) {
      cout<<f<<" ";
   }
   //element value
   string val = "Papaya";
   //using emplace_front() function
   fruits.emplace_front(val);
   cout<<"\nList elements after emplace_front() operation: "<<endl;
   for(string f : fruits) {
      cout<<f<<" ";
   }
   return 0;
}

輸出

這將生成以下輸出：

List elements before emplace_front operation: Orange Banana Grapes Apple 
List elements after emplace_front() operation: 
Papaya Orange Banana Grapes Apple 

示例 4

在下面的示例中，我們建立一個名為 numbers 的列表（int 型別），其值為 {5,6,7,8,9,10}。然後，我們在 for 迴圈內使用 emplace_front() 函式動態地在當前列表的開頭插入數字。

#include<iostream>
#include<list>
using namespace std;

int main() {
   //create a list
   list<int> numbers  = {5,6,7,8,9,10};
   cout<<"List elements before emplace_front operation: ";
   for(int n : numbers ) {
      cout<<n<<" ";
   }
   //using emplace_front() function
   for(int i = 5; i>=1; i--) {
      numbers.emplace_front(i);
   }
   cout<<"\nList elements after emplace_front operation: "<<endl;
   for(int n : numbers ) {
      cout<<n<<" ";
   }
   return 0;
}

輸出

以下是上述程式的輸出：

List elements before emplace_front operation: 5 6 7 8 9 10 
List elements after emplace_front operation: 
1 2 3 4 5 5 6 7 8 9 10