Home » C++ STL

valarray end() Function in C++ with Examples

C++ valarray end() Function: Here, we will learn about the end() function, its usages, syntax and examples.
Submitted by Shivang Yadav, on May 07, 2022

std::end (valarray) Function

The valarray class in C++ is a special container that is used for holding elements like an array and performing operations on them. The end() function in valarray is used to return an iterator which points to the element next to the element at the last index position.

Syntax:

template <class T> /*unspecified1*/ end (valarray<T>& x);
template <class T> /*unspecified2*/ end (const valarray<T>& x);

// or
end(valarrayName)

Parameter(s): The function accepts the valarray whose iterator is to be returned.

Return Value: The method returns an iterator of the element of valarray.

C++ valarray end() Function Example 1:

#include <iostream>
#include <valarray>
using namespace std;

int main()
{
    // Declaring valarray
    valarray<int> myvalarr = { 1, 92, 13, 24, 55, 61, 7 };

    // Printing the elements of valarray
    cout << "The elements stored in valarray are : ";
    for (int& ele : myvalarr)
        cout << ele << " ";

    cout << "\nThe value returned by end() function is " << end(myvalarr);
    return 0;
}

Output:

The elements stored in valarray are : 1 92 13 24 55 61 7 
The value returned by end() function is 0x55a21c4bdecc

You can extract the value from iterator using * operator. The below program display the working.

C++ valarray end() Function Example 2:

#include <iostream>
#include <valarray>
using namespace std;

int main()
{
    // Declaring valarray
    valarray<int> myvalarr = { 1, 92, 13, 24, 55, 61, 7 };

    // Printing the elements of valarray
    cout << "The elements stored in valarray are : ";
    for (int& ele : myvalarr)
        cout << ele << " ";

    cout << "\nThe value returned by end() function is " << *(end(myvalarr) - 1);
    return 0;
}

Output:

The elements stored in valarray are : 1 92 13 24 55 61 7 
The value returned by end() function is 7

Here, we have added "-1" so that the last element can be returned denoting the function functionality. The value with -1 would be 0.

The end() method can also be used to iterate over the elements of the valarray along with begin() method.

C++ valarray end() Function Example 3:

#include <iostream>
#include <valarray>
using namespace std;

int main()
{
    // Declaring valarray
    valarray<int> myvalarr = { 1, 92, 13, 24, 55, 61, 7 };

    // Printing the elements of valarray
    cout << "The elements stored in valarray are : ";
    for (auto it = begin(myvalarr); it != end(myvalarr); it++) {
        cout << ' ' << *it;
    }
    
    return 0;
}

Output:

The elements stored in valarray are :  1 92 13 24 55 61 7

---