std::array front() method

since C++17

// Non const version
constexpr reference front();

// Const version
constexpr const_reference front() const;

since C++14

// Non const version
reference front();

// Const version
constexpr const_reference front() const;

until C++14

// Non const version
reference front();

// Const version
const_reference front() const;

Returns a reference

to the first element in the container.

Calling front on an empty container results in an undefined behavior.

Parameters

(none)

Return value

Reference to the first element.

Complexity

Constant.

Notes

For a container c, the expression c.front() is equivalent to *c.begin().

Example

Main.cpp

#include <array>
#include <iostream>
 
int main()
{
    std::array<char, 6> letters {'o', 'm', 'g', 'w', 't', 'f'};
 
    if (!letters.empty()) {
        std::cout << "The first character is '" << letters.front() << "'.\n";
    }  
}

Possible output

The first character is 'o'.