std::distance – cppreference.com

Aus cppreference.com

definiert in Header `<iterator>`

`template< class InputIt > typename std::iterator_traits<InputIt>::difference_type distance( InputIt first, InputIt last );`

Gibt die Anzahl der Elemente zwischen first und last zurück.

Das Verhalten ist undefiniert, falls last nicht durch (eventuell mehrmaliges) Inkrementieren von first erreichbar ist.

Parameter

first	-	Iterator, der auf das erste Element zeigt
last	-	Iterator, der hinter das letzte Element zeigt
Type requirements
-`InputIt` must meet the requirements of `InputIterator`. Die Operation ist effizienter, falls `InputIt` zusätzlich die Anforderungen an `RandomAccessIterator` erfüllt.

Rückgabewert

Die Anzahl der Elemente zwischen first und last.

Komplexität

Linear.

Falls InputIt jedoch zusätzlich die Anforderungen des Konzepts RandomAccessIterator erfüllt, ist die Komplexität konstant.

Beispiel

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

int main() 
{
    std::vector<int> v{ 3, 1, 4 };

    auto distance = std::distance(v.begin(), v.end());

    std::cout << distance << '\n';
}

Output:

Siehe auch


	Fortschritte einen Iterator gegeben durch Distanz Original: advances an iterator by given distance The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (Funktion) [edit]