WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::advance: einen Iterator um eine Distanz verschieben

std::advance verändert einen per Referenz übergebenen Iterator um n Positionen. Die Funktion prüft keine Grenzen und gibt void zurück.

Version: C++23

Syntax

template<class InputIt, class Distance>
constexpr void advance(InputIt& it, Distance n);

std::advance aus <iterator> verändert it um n Schritte. Random Access erlaubt it += n in konstanter Zeit; schwächere Kategorien benötigen wiederholte Inkremente, ein bidirektionaler Iterator bei negativem n Dekremente.

Verwende die Funktion, wenn das Iteratorobjekt selbst verschoben werden soll. Soll das Original bleiben, gibt std::next klarer einen neuen Iterator zurück. Die Komplexität ist außer bei Random Access linear.

Containergrenzen sind unbekannt. Eine Position vor dem Anfang oder hinter dem gültigen end() ist undefiniert. Negative Distanzen erfordern einen bidirektionalen Iterator. Nach Containeränderungen ist auch die Iteratorgültigkeit zu prüfen.

Beispiele

#include <array>
#include <iostream>
#include <iterator>

int main() {
    const std::array values{2, 5, 9};
    auto iterator = values.begin();
    std::advance(iterator, 2);
    std::cout << *iterator << '\n';
}

Ergebnis

9

std::advance → 9

Quellen