最終更新日時(UTC): 2025年07月08日 15時33分39秒
Akira Takahashi が更新

履歴 編集

function
<iterator>

# std::basic_const_iterator::operator- (非メンバ関数)(C++23)

    friend constexpr basic_const_iterator operator-(const basic_const_iterator& i, difference_type n)
      requires random_access_iterator<Iterator>;

## 概要

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

## 効果

ラップしているイテレータを`current_`メンバ変数に保持するとして、以下と等価

    return basic_const_iterator(i.current_ - n);

## 戻り値

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

## 備考

この関数はHidden friendsとして定義される。

## 例

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

    int main() {
      std::vector vec = {1, 2, 3, 4, 5};

      std::basic_const_iterator cit = vec.end();

      auto cit2 = cit - 3;

      std::cout << *cit << '\n';
      std::cout << *cit2 << '\n';
    }

### 出力

    0
    3

## バージョン

### 言語

- C++23

### 処理系

- Clang: ??
- GCC: 13.1 ✅
- Visual C++: 2022 Update 6 ✅

## 参照

- P2278R4 `cbegin` should always return a constant iterator