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&.

charTbasic_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 不是 空的,则该函数永远不会抛出异常(无抛出保证)。
否则,将导致未定义行为

另见