public member function
<vector>
const_iterator cend() const noexcept;
Return const_iterator to end
Returns a const_iterator pointing to the past-the-end element in the container.
A const_iterator is an iterator that points to const content. This iterator can be increased and decreased (unless it is itself also const), just like the iterator returned by vector::begin, but it cannot be used to modify the contents it points to.
Unlike vector::end, this function returns a const_iterator even if the vector object is not itself const.
The value returned shall not be dereferenced.
Return Value
A const_iterator to the element past the end of the sequence.
Member type const_iterator is a random access iterator type.
Example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
|
// vector::cbegin/cend
#include <iostream>
#include <vector>
int main ()
{
std::vector<int> myvector = {10,20,30,40,50};
std::cout << "myvector contains:";
for (auto it = myvector.cbegin(); it != myvector.cend(); ++it)
std::cout << ' ' << *it;
std::cout << '\n';
return 0;
}
|
Output:
myvector contains: 10 20 30 40 50
|
Iterator validity
No changes.
Data races
The container is accessed.
No contained elements are accessed by the call: concurrently accessing or modifying them is safe.
See also
- vector::end
- Return iterator to end (public member function
)
- vector::cbegin
- Return const_iterator to beginning (public member function
)