最終更新日時: 2025年07月09日 00時33分39秒 (JST)
Akira Takahashi が更新

履歴 編集

function
<iterator>

# std::counted_iterator::operator-(C++20)

    constexpr counted_iterator operator-(iter_difference_t<I> n) const
      requires random_access_iterator<I>;

## 概要

イテレータを`n`回逆に進める。

## 効果

現在のイテレータとカウントの値をそれぞれ、`current`、`length`メンバ変数に保持するとして、以下と等価。

    return counted_iterator(current - n, length + n);

## 戻り値

現在位置から`n`戻したイテレータのコピーを返す。

## 例

    #include <iostream>
    #include <iterator>
    #include <ranges>
    #include <vector>

    int main() {
      std::vector<int> vec = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};

      std::counted_iterator ci{std::ranges::begin(vec), 5};
      ci += 3;

      auto ci2 = ci - 2;

      std::cout << *ci2 << '\n';
    }

### 出力

    2

## バージョン

### 言語

- C++20

### 処理系

- Clang: ??
- GCC: 10.1 ✅
- Visual C++: 2019 Update 9 ✅

## 参照

- P0896R4 The One Ranges Proposal (was Merging the Ranges TS)