std::span<T,Extent>::end, std::span<T,Extent>::cend - cppreference.com (original) (raw)

Returns an iterator past the last element of *this.

This returned iterator only acts as a sentinel. It is not guaranteed to be dereferenceable.

[edit] Return value

Iterator past the last element.

[edit] Complexity

Constant.

[edit] Example

#include #include   void print(std::span array) { std::cout << "array = "; for (auto it = array.begin(); it != array.end(); ++it) std::cout << *it << ' '; std::cout << '\n'; }   void set_first_element(std::span sp, int new_value) { if (!sp.empty()) { std::cout << "old *begin = " << *sp.begin() << '\n'; *sp.begin() = new_value; std::cout << "new *begin = " << *sp.begin() << '\n'; } }   int main() { int array[]{1, 3, 4, 5}; print(array); set_first_element(array, 2); print(array); }

Output:

array = 1 3 4 5 old *begin = 1 new *begin = 2 array = 2 3 4 5

[edit] See also

| | returns an iterator to the beginning (public member function) [edit] | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | returns an iterator to the end of a container or array (function template) [edit] |