std::end(std::valarray)

template< class T > 
/* see below */ end( valarray<T>& v );

template< class T > 
/* see below */ end( const valarray<T>& v );

Перегрузка std::end для valarray возвращает итератор неопределённого типа, ссылающийся на элемент, следующий за последним элементом числового массива.

• удовлетворять требованиям изменяемого LegacyRandomAccessIterator,

• иметь член-тип value_type, который является T, и
• иметь член-тип reference, который является T&.

• удовлетворять требованиям постоянного LegacyRandomAccessIterator,

• иметь член-тип value_type, который является T, и
• иметь член-тип reference, который является const T&.

Итератор, возвращаемый этой функцией, становится недействительным при вызове метода resize() для v или при завершении жизненного цикла v, в зависимости от того, что произойдёт раньше.

Параметры

Возвращаемое значение

Итератор на элемент, следующий за последним элементом числового массива.

Исключения

Может выбросить исключение с определением, зависящим от реализации.

Примечания

В отличие от других функций, принимающих аргументы std::valarray, end() не может принимать типы замещения (например, типы, производимые шаблонами выражений), которые могут быть возвращены выражениями, включающими valarray: std::end(v1 + v2) не является переносимым, вместо него следует использовать std::end(std::valarray<T>(v1 + v2)).

Цель этой функции — позволить циклам range for работать с valarray, а не предоставлять семантику контейнера.

Пример

#include <algorithm>
#include <iostream>
#include <valarray>
 
int main()
{
    const std::valarray<char> va
    {
        'H', 'e', 'l', 'l', 'o', 
        ',', ' ', 
        'C', '+', '+', '!', '\n'
    };
 
    std::for_each(std::begin(va), std::end(va),
                  [](char c){ std::cout << c; });
}

Hello, C++!

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также