Udostępnij za pośrednictwem


<iterator>

Definiuje wstępnie zdefiniowane iteratory i iteratory strumienia, iteratory pierwotne i szablony pomocnicze.

Wymagania

Nagłówek: <iterator>

Przestrzeń nazw: std

Uwagi

Iteratory to uogólnianie wskaźników, które umożliwiają programowi języka C++ pracę z różnymi strukturami danych w jednolity sposób. Zamiast działać na określonych typach danych, algorytmy działają na zakresie wartości określonych przez rodzaj iteratora. Algorytmy mogą działać na dowolnej strukturze danych, która spełnia wymagania iteratora.

W języku C++20 istnieją sześć kategorii iteratorów. Iteratory są rozmieszczane w hierarchii możliwości. Ich możliwości są określane przez koncepcje języka C++20. Opis różnych iteratorów i ich możliwości można znaleźć w temacie Iterator concepts (Pojęcia iteratora)

Program Visual Studio dodał rozszerzenia do iteratorów biblioteki standardowej języka C++ w celu obsługi debugowania dla zaznaczonych i niezaznaczonej iteratorów. Aby uzyskać więcej informacji, zobacz Bezpieczne biblioteki: Standardowa biblioteka języka C++.

Elementy członkowskie

Funkcje

Nazwa/nazwisko opis
advance Inkrementuje iterator o określoną liczbę pozycji.
back_inserter Tworzy iterator, który może wstawiać elementy z tyłu określonego kontenera.
begin Pobiera iterator do pierwszego elementu w określonym kontenerze.
cbegin Pobiera iterator tylko do odczytu do pierwszego elementu w określonym kontenerze.
cend Pobiera iterator tylko do odczytu do elementu, który jest zgodny z ostatnim elementem w określonym kontenerze.
crbegin Pobierz iterator tylko do odczytu odwrotnego na początku określonego kontenera.
crend Pobierz sentinel na końcu zwracanych crbegin() wartości.
data Pobierz wskaźnik do pierwszego elementu w określonym kontenerze.
distance Określa liczbę przyrostów między położeniami, do których odnoszą się dwa iteratory.
end Pobiera iterator do elementu, który następuje po ostatnim elemencie w określonym kontenerze.
empty Przetestuj, czy określony kontener jest pusty.
front_inserter Tworzy iterator, która może wstawiać elementy z przodu określonego kontenera.
inserter Adapter iteratora, który dodaje nowy element do kontenera w określonym punkcie wstawiania.
make_checked_array_iterator Tworzy obiekt checked_array_iterator , który może być używany przez inne algorytmy. Uwaga: Ta funkcja jest rozszerzeniem firmy Microsoft standardowej biblioteki C++. Kod implementowany przy użyciu tej funkcji nie jest przenośny do standardowych środowisk kompilacji języka C++, które nie obsługują tego rozszerzenia firmy Microsoft.
make_move_iterator Zwraca iterator przenoszenia, zawierający podany iterator taki, jak jego przechowywany iterator podstawowy.
make_unchecked_array_iterator Tworzy obiekt unchecked_array_iterator , który może być używany przez inne algorytmy. Uwaga: Ta funkcja jest rozszerzeniem firmy Microsoft standardowej biblioteki C++. Kod implementowany przy użyciu tej funkcji nie jest przenośny do standardowych środowisk kompilacji języka C++, które nie obsługują tego rozszerzenia firmy Microsoft.
next Dokonuje iteracji określoną liczbę razy i zwraca nową pozycję iteratora.
prev Dokonuje iteracji odwrotnej określoną liczbę razy i zwraca nową pozycję iteratora.
rbegin Pobierz iterator odwrotny na początek określonego kontenera.
rend Pobierz iterator odwrotny do sentinel na końcu określonego kontenera.
size Pobierz liczbę elementów.

Operatory

Nazwa/nazwisko opis
operator!= Sprawdza, czy obiekt iteratora po lewej stronie operatora nie jest równy obiektowi iteratora po prawej stronie.
operator== Testuje, czy obiekt iteratora po lewej stronie operatora jest równy obiektowi iteratora po prawej stronie.
operator< Testuje, czy obiekt iteratora po lewej stronie operatora jest mniejszy niż obiekt iteratora po prawej stronie.
operator<= Testuje, czy obiekt iteratora po lewej stronie operatora jest mniejszy niż lub równy obiektowi iteratora po prawej stronie.
operator> Testuje, czy obiekt iteratora po lewej stronie operatora jest większy niż obiekt iteratora po prawej stronie.
operator>= Testuje, czy obiekt iteratora po lewej stronie operatora jest większy niż lub równy obiektowi iteratora po prawej stronie.
operator+ Dodaje przesunięcie do iteratora i zwraca nowe reverse_iterator adresowanie wstawionego elementu w nowej pozycji przesunięcia.
operator- Odejmuje jeden iterator od innego i zwraca różnicę.

Klasy

Nazwa/nazwisko opis
back_insert_iterator Szablon klasy opisuje obiekt iteratora wyjściowego. Wstawia elementy do kontenera typu Container, do którego uzyskuje dostęp za pośrednictwem chronionego pointer obiektu, który przechowuje nazywany kontenerem.
bidirectional_iterator_tag Klasa udostępniająca typ zwracany dla iterator_category funkcji reprezentującej iterator dwukierunkowy.
checked_array_iterator Klasa, która uzyskuje dostęp do tablicy przy użyciu sprawdzonego iteratora dostępu swobodnego. Uwaga: ta klasa jest rozszerzeniem firmy Microsoft standardowej biblioteki C++. Kod implementowany przy użyciu tej funkcji nie jest przenośny do standardowych środowisk kompilacji języka C++, które nie obsługują tego rozszerzenia firmy Microsoft.
forward_iterator_tag Klasa, która udostępnia typ zwracany dla iterator_category funkcji reprezentującej iterator przesyłania dalej.
front_insert_iterator Szablon klasy opisuje obiekt iteratora wyjściowego. Wstawia elementy do kontenera typu Container, do którego uzyskuje dostęp za pośrednictwem chronionego pointer obiektu, który przechowuje nazywany kontenerem.
input_iterator_tag Klasa, która udostępnia typ zwracany dla iterator_category funkcji reprezentującej iterator wejściowy.
insert_iterator Szablon klasy opisuje obiekt iteratora wyjściowego. Wstawia elementy do kontenera typu Container, do którego uzyskuje dostęp za pośrednictwem chronionego pointer obiektu, który przechowuje nazywany kontenerem. Przechowuje również chroniony iterator obiekt klasy Container::iteratoro nazwie iter.
istream_iterator Szablon klasy opisuje obiekt iteratora wejściowego. Wyodrębnia obiekty klasy Ty ze strumienia wejściowego, do którego uzyskuje dostęp za pośrednictwem obiektu, który przechowuje, wskaźnika typu na basic_istream<Elem, Tr>wartość .
istreambuf_iterator Szablon klasy opisuje obiekt iteratora wejściowego. Wstawia elementy klasy Elem do buforu strumienia wyjściowego, do którego uzyskuje dostęp za pośrednictwem obiektu, który przechowuje, typu pointer na basic_streambuf<Elem, Tr>wartość .
iterator Szablon klasy jest używany jako typ podstawowy dla wszystkich iteratorów.
iterator_traits Klasa pomocnika szablonu udostępnia typy krytyczne, które są skojarzone z innymi typami iteratora, tak że można się do nich odwoływać w taki sam sposób.
move_iterator Obiekt move_iterator przechowuje iterator dostępu losowego typu RandomIterator. Zachowuje się jak iterator dostępu swobodnego, z wyjątkiem przypadków wyłuskania. Wynik operator* funkcji jest niejawnie rzutowy w celu value_type&&: utworzenia elementu rvalue reference.
ostream_iterator Szablon klasy opisuje obiekt iteratora wyjściowego. Wstawia obiekty klasy Type do strumienia wyjściowego, do którego uzyskuje dostęp za pośrednictwem obiektu, który przechowuje, typu pointer .basic_ostream<Elem, Tr>
ostreambuf_iterator Szablon klasy opisuje obiekt iteratora wyjściowego. Wstawia elementy klasy Elem do buforu strumienia wyjściowego, do którego uzyskuje dostęp za pośrednictwem obiektu, który przechowuje, wskaźnika typu na basic_streambuf<Elem, Tr>.
output_iterator_tag Klasa, która udostępnia typ zwracany dla iterator_category funkcji, która reprezentuje iterator danych wyjściowych.
random_access_iterator_tag Klasa, która udostępnia typ zwracany dla iterator_category funkcji, która reprezentuje iterator dostępu losowego.
reverse_iterator Szablon klasy opisuje obiekt, który zachowuje się jak iterator dostępu losowego, tylko odwrotnie.
unchecked_array_iterator Klasa, która uzyskuje dostęp do tablicy przy użyciu niesprawdzonego iteratora dostępu swobodnego. Uwaga: ta klasa jest rozszerzeniem firmy Microsoft standardowej biblioteki C++. Kod implementowany przy użyciu tej funkcji nie jest przenośny do standardowych środowisk kompilacji języka C++, które nie obsługują tego rozszerzenia firmy Microsoft.

Pojęcia

Następujące pojęcia są zdefiniowane w std przestrzeni nazw. Mają zastosowanie do iteratorów i są również związane z kategoriami iteratora dla zakresów opisanych w <ranges> pojęciach.

Koncepcja iteratora opis
bidirectional_iteratorC++20 Określa iterator, który może odczytywać i zapisywać zarówno do przodu, jak i do tyłu.
contiguous_iteratorC++20 Określa iterator, którego elementy są sekwencyjne w pamięci, ten sam rozmiar i można uzyskać do niego dostęp przy użyciu arytmetyki wskaźnika.
forward_iteratorC++20 Określa iterator, który może odczytywać (i ewentualnie zapisywać) wiele razy.
input_iteratorC++20 Określa iterator, który można odczytać z co najmniej raz.
input_or_output_iteratorC++20 Podstawa taksonomii koncepcji iteratora.
output_iterator Określa iterator, do którego można napisać.
random_access_iteratorC++20 Określa iterator, który można odczytywać i zapisywać według indeksu.
sentinel_forC++20 Określa sentinel dla typu iteratora.
sized_sentinel_forC++20 Określa, że iterator i jego sentinel można odjąć (przy użyciu ) -w celu znalezienia różnicy w stałym czasie.

Zobacz też

Odwołanie do plików nagłówka
Bezpieczeństwo wątku w standardowej bibliotece C++
Dokumentacja standardowej biblioteki C++