- C++ Library - Home
- C++ Library - <fstream>
- C++ Library - <iomanip>
- C++ Library - <ios>
- C++ Library - <iosfwd>
- C++ Library - <iostream>
- C++ Library - <istream>
- C++ Library - <ostream>
- C++ Library - <sstream>
- C++ Library - <streambuf>
- C++ Library - <atomic>
- C++ Library - <complex>
- C++ Library - <exception>
- C++ Library - <functional>
- C++ Library - <limits>
- C++ Library - <locale>
- C++ Library - <memory>
- C++ Library - <new>
- C++ Library - <numeric>
- C++ Library - <regex>
- C++ Library - <stdexcept>
- C++ Library - <string>
- C++ Library - <thread>
- C++ Library - <tuple>
- C++ Library - <typeinfo>
- C++ Library - <utility>
- C++ Library - <valarray>
- The C++ STL Library
- C++ Library - <array>
- C++ Library - <bitset>
- C++ Library - <deque>
- C++ Library - <forward_list>
- C++ Library - <list>
- C++ Library - <map>
- C++ Library - <multimap>
- C++ Library - <queue>
- C++ Library - <priority_queue>
- C++ Library - <set>
- C++ Library - <multiset >
- C++ Library - <stack>
- C++ Library - <unordered_map>
- C++ Library - <unordered_set>
- C++ Library - <unordered_multiset>
- C++ Library - <vector>
- C++ Library - <algorithm>
- C++ Library - <iterator>
- The C++ Advanced Library
- C++ Library - <any>
- C++ Library - <barrier>
- C++ Library - <bit>
- C++ Library - <chrono>
- C++ Library - <cinttypes>
- C++ Library - <clocale>
- C++ Library - <condition_variable>
- C++ Library - <coroutine>
- C++ Library - <cstdlib>
- C++ Library - <cstring>
- C++ Library - <cuchar>
- C++ Library - <charconv>
- C++ Library - <cfenv>
- C++ Library - <cmath>
- C++ Library - <ccomplex>
- C++ Library - <expected>
- C++ Library - <format>
- C++ Library - <future>
- C++ Library - <flat_set>
- C++ Library - <flat_map>
- C++ Library - <filesystem>
- C++ Library - <generator>
- C++ Library - <initializer_list>
- C++ Library - <latch>
- C++ Library - <memory_resource>
- C++ Library - <mutex>
- C++ Library - <mdspan>
- C++ Library - <optional>
- C++ Library - <print>
- C++ Library - <ratio>
- C++ Library - <scoped_allocator>
- C++ Library - <semaphore>
- C++ Library - <source_location>
- C++ Library - <span>
- C++ Library - <spanstream>
- C++ Library - <stacktrace>
- C++ Library - <stop_token>
- C++ Library - <syncstream>
- C++ Library - <system_error>
- C++ Library - <string_view>
- C++ Library - <stdatomic>
- C++ Library - <variant>
- C++ STL Library Cheat Sheet
- C++ STL - Cheat Sheet
- C++ Programming Resources
- C++ Programming Tutorial
- C++ Useful Resources
- C++ Discussion
C++ Iterator Library - random_access_iterator_tag
Description
It used to identify the category of an iterator and a random-access iterator support at least one of the following operations.
C++98
| property | valid expressions |
|---|---|
| It is a default-constructible, copy-constructible, copy-assignable and destructible |
X b(a); b = a; |
It can be compared for equivalence using the equality/inequality operators (meaningful when both iterator values iterate over the same underlying sequence). |
a != b |
| It can be dereferenced as an rvalue (if in a dereferenceable state). |
a->m |
For mutable iterators (non-constant iterators): Can be dereferenced as an lvalue (if in a dereferenceable state). |
*a = t |
It can be incremented (if in a dereferenceable state). The result is either also dereferenceable or a past-the-end iterator. Two iterators that compare equal, keep comparing equal after being both increased. |
a++ *a++ |
It can be decremented (if a dereferenceable iterator value precedes it). |
--a a-- *a-- |
Supports the arithmetic operators + and - between an iterator and an integer value, or subtracting an iterator from another. |
n + a a - n a - b |
Can be compared with inequality relational operators (<, >, <= and >=). |
a > b a <= b a >= b |
Supports compound assignment operations += and -= |
a -= n |
Supports the offset dereference operator ([]) |
a[n] |
C++11
| property | valid expressions |
|---|---|
| It is a default-constructible ,copy-constructible ,copy-assignable and destructible |
X b(a); b = a; |
It can be compared for equivalence using the equality/inequality operators (meaningful when both iterator values iterate over the same underlying sequence). |
a != b |
| It can be dereferenced as an rvalue (if in a dereferenceable state). |
a->m |
For mutable iterators (non-constant iterators): Can be dereferenced as an lvalue (if in a dereferenceable state). |
*a = t |
It can be incremented (if in a dereferenceable state). The result is either also dereferenceable or a past-the-end iterator. Two iterators that compare equal, keep comparing equal after being both increased. |
a++ *a++ |
It can be decremented (if a dereferenceable iterator value precedes it). |
--a a-- *a-- |
It supports the arithmetic operators + and - between an iterator and an integer value, or subtracting an iterator from another. |
n + a a - n a - b |
It can be compared with inequality relational operators (<, >, <= and >=). |
a > b a <= b a >= b |
It supports compound assignment operations += and -= |
a -= n |
It supports the offset dereference operator ([]) |
a[n] |
| Lvalues are swappable. | swap(a,b) |
Declaration
Following is the declaration for std::random_access_iterator_tag.
C++11
struct random_access_iterator_tag {};