Архитектурная акустика/Реализация/IteratorAdapterForStep::operator-: различия между версиями
Перейти к навигации
Перейти к поиску
Параметры
Возвращаемое значение: Перегрузка 1 возвращает копию итератора, сдвинутую относительно
Возможные исключения
(Новая страница: «{{function_begin |IteratorAdapterForStep operator-(difference_type n) const; //1 difference_type operator-(const IteratorAdapterForStep& right) const; //2|{{{{wik…») |
|||
| Строка 5: | Строка 5: | ||
{{function paramlist begin}} | {{function paramlist begin}} | ||
{{function paramlist add|n|Значение, на которое необходимо выполнить сдвиг копии итератора относительно <source lang="cpp" inline>*this</source>. Отрицательные значения эквивалентны вызову <source lang="cpp" inline>*this + -n;</source>.}} | {{function paramlist add|n|Значение, на которое необходимо выполнить сдвиг копии итератора относительно <source lang="cpp" inline>*this</source>. Отрицательные значения эквивалентны вызову <source lang="cpp" inline>*this + -n;</source>.}} | ||
{{function paramlist add|right|Ссылка на экземпляр {{arch_ac_ref|IteratorAdapterForStep}}, из позиции которого вычитается текущая позиция.}} | {{function paramlist add|right|Ссылка на экземпляр {{arch_ac_ref|IteratorAdapterForStep}}, из позиции которого вычитается текущая позиция. Оба экземпляра {{arch_ac_ref|IteratorAdapterForStep}} (<source lang="cpp" inline>*this</source> и <source lang="cpp" inline>right</source>) должны быть определены с одним шагом.}} | ||
{{function paramlist end}} | {{function paramlist end}} | ||
{{function return_value|Перегрузка 1 возвращает копию итератора, сдвинутую относительно <source lang="cpp" inline>*this</source> к началу контейтера на значение <tt>n</tt>. Перегрузка 2 возвращает разницу между позициями <source lang="cpp" inline>*this</source> и <tt>right</tt>. Если <source lang="cpp" inline>*this</source> отстоит дальше от начала, чем <tt>right</tt>, возвращается положительное значение, иначе - неположительное.}} | {{function return_value|Перегрузка 1 возвращает копию итератора, сдвинутую относительно <source lang="cpp" inline>*this</source> к началу контейтера на значение <tt>n</tt>. Перегрузка 2 возвращает разницу между позициями <source lang="cpp" inline>*this</source> и <tt>right</tt>. Если <source lang="cpp" inline>*this</source> отстоит дальше от начала, чем <tt>right</tt>, возвращается положительное значение, иначе - неположительное.}} | ||
{{function exceptionlist begin}} | |||
{{function exceptionlist add|[https://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_invalid_parameter_exception.html Chusov::Exceptions::InvalidParameterException]|Итераторы <source lang="cpp" inline>*this</source> и <tt>right</tt> заданы с разными шагами.}} | |||
{{function exceptionlist end}} | |||
{{function_end}} | {{function_end}} | ||
Текущая версия на 22:14, 8 января 2018
IteratorAdapterForStep operator-(difference_type n) const; //1
difference_type operator-(const IteratorAdapterForStep& right) const; //2
Возвращает итератор, сдвинутый к началу относительно текущего на заданное число позиций, либо расстояние между двумя итераторами.
- Создает и возвращает итератор на заданном расстоянии от
*this. - Возвращает расстояние между итераторами.
| n | Значение, на которое необходимо выполнить сдвиг копии итератора относительно *this. Отрицательные значения эквивалентны вызову *this + -n;. | |
| right | Ссылка на экземпляр IteratorAdapterForStep, из позиции которого вычитается текущая позиция. Оба экземпляра IteratorAdapterForStep (*this и right) должны быть определены с одним шагом. |
*this к началу контейтера на значение n. Перегрузка 2 возвращает разницу между позициями *this и right. Если *this отстоит дальше от начала, чем right, возвращается положительное значение, иначе - неположительное.| Chusov::Exceptions::InvalidParameterException | Итераторы *this и right заданы с разными шагами. |