Namespaces
Variants

std:: begin (std::valarray)

From cppreference.net
template < class T >
/* см. ниже */ begin ( valarray < T > & v ) ;
(1) (начиная с C++11)
template < class T >
/* см. ниже */ begin ( const valarray < T > & v ) ;
(2) (начиная с C++11)

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

1) Возвращаемый тип должен
(since C++20)
  • иметь тип-член value_type , который является T , и
  • иметь тип-член reference , который является T& .
2) Возвращаемый тип должен
(since C++20)
  • иметь тип-член value_type , который является T , и
  • иметь тип-член reference , который является const T& .

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

Содержание

Параметры

v - числовой массив

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

Итератор на первое значение в числовом массиве.

Исключения

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

Примечания

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

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

Пример

#include <algorithm>
#include <iostream>
#include <valarray>
void show(const std::valarray<int>& v)
{
    std::for_each(std::begin(v), std::end(v), [](int c)
    {
        std::cout << c << ' ';
    });
    std::cout << '\n';
};
int main()
{
    const std::valarray<int> x{47, 70, 37, 52, 90, 23, 17, 33, 22, 16, 21, 4};
    const std::valarray<int> y{25, 31, 71, 56, 21, 21, 15, 34, 21, 27, 12, 6};
    show(x); 
    show(y); 
    const std::valarray<int> z{x + y};
    for (char c : z)
        std::cout << c;
}

Вывод:

47 70 37 52 90 23 17 33 22 16 21 4 
25 31 71 56 21 21 15 34 21 27 12 6 
Hello, C++!

Отчёты о дефектах

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

DR Применяется к Поведение как опубликовано Корректное поведение
LWG 2058 C++11 1. begin() требовал поддержки типов замены
2. не было указано, когда возвращенные итераторы будут инвалидированы
1. не требуется
2. указано

Смотрите также

специализирует std::end
(шаблон функции)