C++ Array Library - begin() Function

---

Description

The C++ function std::array::begin() returns an iterator which points to the start of the array.

Declaration

Following is the declaration for std::array::begin() function form std::array header.

iterator begin() noexcept;
const_iterator begin() const noexcept;

Parameters

None

Return Value

If array object is const-qualified, method returns const random access iterator otherwise random access iterator.

Exceptions

This member function never throws exception.

Time complexity

Constant i.e. O(1)

Example

The following example shows the usage of std::array::begin() function.

#include <iostream>
#include <array>

using namespace std;

int main(void) {

   array <int, 5> arr = {1, 2, 3, 4, 5};

   /* iterator pointing at the start of the array */
   auto itr = arr.begin();

   /* traverse complete container */
   while (itr != arr.end()) {
      cout << *itr << " ";
      ++itr;   /* increment iterator */
   }

   cout << endl;

   return 0;
}

Let us compile and run the above program, this will produce the following result −

1 2 3 4 5