std::valarray<T>::begin
iterator begin();
|
(1) | (desde C++11) |
const_iterator begin() const;
|
(2) | (desde C++11) |
Devuelve un iterador que se refiere al primer elemento del array numérico.
El iterador devuelto por esta función se invalida cuando la función miembro resize() es llamada en v o cuando la vida útil de v termina, lo que ocurra primero.
Parámetros
| v | - | un array numérico |
Valor de retorno
Iterador al primer elemento del array numérico.
Excepciones
Puede lanzar excepciones definidas por la implementación.
Notas
A diferencia de otras funciones que toman argumentos std::valarray, begin() no puede aceptar los tipos de reemplazo (como los tipos producidos por plantillas de expresión) que pueden ser devueltos por expresiones que involucran valarrays: (v1 + v2).begin() no es portátil, std::valarray<T>(v1 + v2).begin() debe ser usado en su lugar.
La intención de esta función es permitir que los bucles for basados en rango funcionen con valarrays, no proporcionar semántica de contenedor.
Ejemplo
#include <algorithm>
#include <iostream>
#include <valarray>
void show(const std::valarray<int>& v)
{
std::for_each(v.begin(), v.end(), [](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;
}
Salida:
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++!
Informes de defectos
Los siguientes informes de defectos que cambian el comportamiento fueron aplicados retroactivamente a estándares C++ previamente publicados.
| DR | Aplicado a | Comportamiento según lo publicado | Comportamiento corregido |
|---|---|---|---|
| LWG 2058 | C++11 | 1. begin() se requería para soportar tipos de reemplazo2. no se especificaba cuándo se invalidarían los iteradores devueltos |
1. no requerido 2. especificado |
| P3016R6 | C++11 | las funciones no miembro begin() introdujeron inconsistencia en el acceso a rangos
|
se cambió begin() a funciones miembro
|
Véase también
(C++11) |
obtiene el iterador al final de valarray (función miembro pública) |