C++

參考

<string>

basic_string

public member function
<string>

std::basic_string::front

      charT& front();const charT& front() const;
訪問第一個字元
返回對 basic_string 的第一個字元的引用。

與成員 basic_string::begin 不同，後者返回指向同一字元的迭代器，此函式返回直接引用。

不應在 空字串 上呼叫此函式。

引數

無

返回值

對 basic_string 中的第一個字元的引用。

如果 basic_string 物件是常量限定的，則該函式返回const charT&。否則，它返回一個charT&.

charT是 basic_string 的字元型別（即，它的第一個模板引數）。

示例

1
2
3
4
5
6
7
8
9
10
11
 
// string::front
#include <iostream>
#include <string>

int main ()
{
  std::string str ("test string");
  str.front() = 'T';
  std::cout << str << '\n';
  return 0;
}

輸出
Test string


複雜度

常量。

迭代器有效性

沒有變化。

資料競爭

訪問容器（const 和非 const 版本都不會修改容器）。
返回的引用可用於訪問或修改字元。併發訪問或修改不同的字元是安全的。

異常安全

如果 basic_string 不是 空的，則該函式永遠不會丟擲異常（無丟擲保證）。
否則，將導致未定義行為。

另見

basic_string::back
訪問最後一個字元 (公共成員函式)
basic_string::at
獲取字串的字元 (public member function)
basic_string::operator[]
獲取字串的字元 (public member function)