public member function


move_iterator operator- (difference_type n) const;
Subtraction operator
Returns a move iterator pointing to the element located n positions before the element the iterator currently points to.

Internally, the function reflects the operation onto the base iterator and returns a move iterator constructed with the resulting value.

Note that this function requires the base iterator to be a random-access iterator.

This operator is also overloaded as a non-member function to return the difference of subtracting iterators: see operator-).


Number of elements to offset backwards.
Member type difference_type is an alias of the base iterator's own difference type.

Return value

A move iterator pointing to the element n positions before the currently pointed one.

Data races

The object is accessed.
The iterator returned can be used to access or modify elements.

Exception safety

Provides the same level of guarantee as the operations internally applied to the base iterator.

See also