# std::forward_list<T,Allocator>::front

< cpp‎ | container‎ | forward list

reference front(); |  | (C++11 起)
const_reference front() const; |  | (C++11 起)

返回到容器首元素的引用。

在空容器上对 `front` 的调用是未定义的。

### 参数

（无）

### 返回值

到首元素的引用

### 复杂度

常数

### 注解

对于容器 `c` ，表达式 c.front() 等价于 *c.begin() 。

### 示例

下列代码用 `front` 显示 std::forward_list<char> 的首元素：

    #include <forward_list>
    #include <iostream>

    int main()
    {
        std::forward_list<char> letters {'o', 'm', 'g', 'w', 't', 'f'};

        if (!letters.empty()) {
            std::cout << "The first character is: " << letters.front() << '\n';
        }
    }

输出：

    The first character is o