std::distance

 

C++

Sprache

Concepts

Utilities-Bibliothek

Strings Bibliothek

Container-Bibliothek

Algorithmen-Bibliothek

Iteratoren Bibliothek

Numerik-Bibliothek

Input / Output-Bibliothek

Lokalisierungen Bibliothek

Reguläre Ausdrücke Bibliothek (C++11)

Atomare Operationen Bibliothek (C++11)

Thread Support-Bibliothek (C++11)

 

Iterator Bibliothek

Iterator Primitiven Original: Iterator primitives The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
iterator_traits
input_iterator_tag output_iterator_tag forward_iterator_tag bidirectional_iterator_tag random_access_iterator_tag
iterator
Iterator Adaptern Original: Iterator adaptors The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
reverse_iterator
move_iterator (C++11) back_insert_iterator front_insert_iterator insert_iterator	make_move_iterator (C++11) back_inserter front_inserter inserter
Stream-Iteratoren Original: Stream iterators The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
istream_iterator
ostream_iterator
istreambuf_iterator
ostreambuf_iterator
Iterator Operationen Original: Iterator operations The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
advance
distance
prev (C++11)
next (C++11)
Reichen Zugang Original: Range access The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
begin (C++11)
end (C++11)

 

Defined 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:

3

Siehe auch

advance	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)