std::end(std::valarray) - cppreference.com (original) (raw)

The overload of std::end for valarray returns an iterator of unspecified type referring to the one past the last element in the numeric array.

1. The return type must

• meet the requirements of mutable LegacyRandomAccessIterator,
• have a member type value_type, which is T, and
• have a member type reference, which is T&.

1. The return type must

• meet the requirements of constant LegacyRandomAccessIterator,
• have a member type value_type, which is T, and
• have a member type reference, which is const T&.

The iterator returned from this function is invalidated when the member function resize() is called on v or when the lifetime of v ends, whichever comes first.

Contents

• 1 Parameters
• 2 Return value
• 3 Exceptions
• 4 Notes
• 5 Example
• 6 Defect reports
• 7 See also

[edit] Parameters

[edit] Return value

Iterator to one past the last value in the numeric array.

[edit] Exceptions

May throw implementation-defined exceptions.

[edit] Notes

Unlike other functions that take std::valarray arguments, end() cannot accept the replacement types (such as the types produced by expression templates) that may be returned from expressions involving valarrays: std::end(v1 + v2) is not portable, std::end(std::valarray<T>(v1 + v2)) has to be used instead.

The intent of this function is to allow range for loops to work with valarrays, not to provide container semantics.

[edit] Example

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

Output:

[edit] Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

[edit] See also