home | help
std::array::front(3)	       C++ Standard Libary	    std::array::front(3)

NAME
     std::array::front - std::array::front

Synopsis
	reference front();	       (1) (since C++11)
					   (constexpr since C++17)
	const_reference front() const; (2) (since C++11)
					   (constexpr since C++14)

	Returns a reference to the first element in the container.

	Calling front on an empty container causes 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
	The following code uses front to display the first element of a std::ar-
     ray<char, 6>:

     // Run this code

      #include <array>
      #include <iostream>

      int main()
      {
	  std::array<char, 6> letters{'a', 'b', 'c', 'd', 'e', 'f'};

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

Output:
      The first character is 'a'.

See also
	back access the last element
	     (public member function)

http://cppreference.com 	   2024.06.10		    std::array::front(3)

home | help