std:: begin (std::valarray)
|
template
<
class
T
>
/* см. ниже */ begin ( valarray < T > & v ) ; |
(1) | (начиная с C++11) |
|
template
<
class
T
>
/* см. ниже */ begin ( const valarray < T > & v ) ; |
(2) | (начиная с C++11) |
Перегрузка
std::begin
для
valarray
возвращает итератор неопределенного типа, ссылающийся на первый элемент числового массива.
- удовлетворять требованиям mutable LegacyRandomAccessIterator ,
|
(since C++20) |
-
иметь тип-член
value_type, который являетсяT, и -
иметь тип-член
reference, который являетсяT&.
- удовлетворять требованиям константного LegacyRandomAccessIterator ,
|
(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. указано |
Смотрите также
|
(C++11)
|
специализирует
std::end
(шаблон функции) |