<iterator>

  • Makale

Önceden tanımlanmış yineleyicileri ve akış yineleyicilerini, yineleyici temel öğelerini ve destekleyici şablonları tanımlar.

Gereksinimler

Üstbilgi: <iterator>

Ad alanı: std

Açıklamalar

Yineleyiciler, bir C++ programının farklı veri yapılarıyla tekdüzen bir şekilde çalışmasını sağlayan işaretçilerin genelleştirilmesidir. Algoritmalar, belirli veri türleri üzerinde çalışmak yerine bir tür yineleyici tarafından belirtilen değer aralığı üzerinde çalışır. Algoritmalar, yineleyicinin gereksinimlerini karşılayan herhangi bir veri yapısı üzerinde çalışabilir.

C++20'de altı yineleyici kategorisi vardır. Yineleyiciler bir yetenek hiyerarşisi içinde düzenlenir. Özellikleri C++20 kavramları tarafından belirtilir. Çeşitli yineleyicilerin ve bunların özelliklerinin açıklaması için bkz . Yineleyici kavramları

Visual Studio, işaretli ve işaretsiz yineleyicilerde hata ayıklamayı desteklemek için C++ Standart Kitaplığı yineleyicilerine uzantılar ekledi. Daha fazla bilgi için bkz . Güvenli Kitaplıklar: C++ Standart Kitaplığı.

Üyeler

İşlevler

Veri Akışı Adı Açıklama
advance Belirtilen bir konum sayısıyla yineleyiciyi artırır.
back_inserter Belirtilen kapsayıcının arkasında öğeler ekleyebilen bir yineleyici oluşturur.
begin Belirtilen bir kapsayıcıdaki ilk öğe için bir yineleyici alır.
cbegin Belirtilen kapsayıcıdaki ilk öğeye salt okunur bir yineleyici alır.
cend Belirtilen kapsayıcıdaki son öğeyi izleyen öğeye salt okunur bir yineleyici alır.
crbegin Belirtilen kapsayıcının başına ters salt okunur bir yineleyici alın.
crend Dönüşlerin sonunda sentinel'i crbegin() alın.
data Belirtilen kapsayıcıdaki ilk öğeye bir işaretçi alın.
distance İki yineleyici tarafından ele alınan konumlar arasındaki artış sayısını belirler.
end Belirtilen kapsayıcıdaki son öğeyi izleyen öğeye bir yineleyici alır.
empty Belirtilen kapsayıcının boş olup olmadığını test edin.
front_inserter Belirtilen kapsayıcının önünde öğeler ekleyebilen bir yineleyici oluşturur.
inserter Bir kapsayıcıya belirli bir ekleme noktasında yeni bir öğe ekleyen bir yineleyici bağdaştırıcısı.
make_checked_array_iterator Diğer algoritmalar tarafından kullanılabilecek bir checked_array_iterator oluşturur. Not: Bu işlev, C++ Standart Kitaplığı'nın Bir Microsoft uzantısıdır. Bu işlev kullanılarak uygulanan kod, bu Microsoft uzantısını desteklemeyen C++ Standart derleme ortamlarına taşınabilir değildir.
make_move_iterator Sağlanan yineleyiciyi depolanmış temel yineleyicisi olarak içeren bir taşıma yineleyicisi döndürür.
make_unchecked_array_iterator Diğer algoritmalar tarafından kullanılabilecek bir unchecked_array_iterator oluşturur. Not: Bu işlev, C++ Standart Kitaplığı'nın Bir Microsoft uzantısıdır. Bu işlev kullanılarak uygulanan kod, bu Microsoft uzantısını desteklemeyen C++ Standart derleme ortamlarına taşınabilir değildir.
next Belirtilen sayıda yineler ve yeni yineleyici konumunu döndürür.
prev Belirtilen sayıda geri yineler ve yeni yineleyici konumunu döndürür.
rbegin Belirtilen kapsayıcının başına ters yineleyici alın.
rend Belirtilen kapsayıcının sonunda sentinel için ters yineleyici alın.
size Öğe sayısını alın.

İşleçler

Veri Akışı Adı Açıklama
operator!= İşlecin sol tarafındaki yineleyici nesnesinin sağ taraftaki yineleyici nesnesine eşit olup olmadığını test eder.
operator== İşlecin sol tarafındaki yineleyici nesnesinin işlecin sağ tarafındaki yineleyici nesnesine eşit olup olmadığını sınar.
operator< İşlecin sol tarafındaki yineleyici nesnesinin işlecin sağ tarafındaki yineleyici nesnesinden küçük olup olmadığını sınar.
operator<= İşlecin sol tarafındaki yineleyici nesnesinin işlecin sağ tarafındaki yineleyici nesnesine eşit veya ondan küçük olup olmadığını sınar.
operator> İşlecin sol tarafındaki yineleyici nesnesinin işlecin sağ tarafındaki yineleyici nesnesinden büyük olup olmadığını sınar.
operator>= İşlecin sol tarafındaki yineleyici nesnesinin işlecin sağ tarafındaki yineleyici nesnesine eşit veya ondan büyük olup olmadığını sınar.
operator+ Yineleyiciye bir uzaklık ekler ve eklenen öğeyi yeni reverse_iterator uzaklık konumunda adresleyen yeni öğesini döndürür.
operator- Bir yineleyiciyi bir başkasından çıkarır ve farkı döndürür.

Sınıflar

Veri Akışı Adı Açıklama
back_insert_iterator Sınıf şablonu bir çıkış yineleyici nesnesi açıklar. Öğeleri türündeki Containerbir kapsayıcıya ekler ve kapsayıcı olarak adlandırılan depoladığı korumalı pointer nesne üzerinden erişir.
bidirectional_iterator_tag Çift yönlü yineleyiciyi temsil eden bir iterator_category işlev için dönüş türü sağlayan sınıf.
checked_array_iterator Bir rastgele erişim, denetlenmiş yineleyici kullanarak bir diziye erişen sınıf. Not: Bu sınıf, C++ Standart Kitaplığı'nın bir Microsoft uzantısıdır. Bu işlev kullanılarak uygulanan kod, bu Microsoft uzantısını desteklemeyen C++ Standart derleme ortamlarına taşınabilir değildir.
forward_iterator_tag İleri yineleyiciyi temsil eden bir iterator_category işlev için dönüş türü sağlayan sınıf.
front_insert_iterator Sınıf şablonu bir çıkış yineleyici nesnesi açıklar. Öğeleri türündeki Containerbir kapsayıcıya ekler ve kapsayıcı olarak adlandırılan depoladığı korumalı pointer nesne üzerinden erişir.
input_iterator_tag Giriş yineleyicisini temsil eden bir iterator_category işlev için dönüş türü sağlayan sınıf.
insert_iterator Sınıf şablonu bir çıkış yineleyici nesnesi açıklar. Öğeleri türündeki Containerbir kapsayıcıya ekler ve kapsayıcı olarak adlandırılan depoladığı korumalı pointer nesne üzerinden erişir. Ayrıca adlı itersınıfının Container::iteratorkorumalı iterator nesnesini de depolar.
istream_iterator Sınıf şablonu bir giriş yineleyici nesnesi açıklar. Sınıfın Ty nesnelerini depoladığı bir nesne aracılığıyla eriştiği bir giriş akışından, işaretçi türündeki öğesinden basic_istream<Elem, Tr>ayıklar.
istreambuf_iterator Sınıf şablonu bir giriş yineleyici nesnesi açıklar. Sınıfın Elem öğelerini depoladığı bir nesne pointer aracılığıyla eriştiği bir çıkış akışı arabelleğine basic_streambuf<Elem, Tr>ekler.
iterator Sınıf şablonu, tüm yineleyiciler için temel tür olarak kullanılır.
iterator_traits Aynı şekilde başvurulabilsinler diye farklı yineleyici türleriyle ilişkilendirilen kritik türleri sağlayan şablon yardımcı sınıfı.
move_iterator Nesne move_iterator türündeki RandomIteratorrastgele erişim yineleyicisini depolar. Başvurunun kaldırıldığı durum dışında, rastgele erişimli yineleyici gibi davranır. sonucuoperator*, bir yapmak rvalue referenceiçin örtük olarak öğesine value_type&&: atılır.
ostream_iterator Sınıf şablonu bir çıkış yineleyici nesnesi açıklar. Sınıfın Type nesnelerini depoladığı bir nesne pointer aracılığıyla eriştiği bir çıkış akışına basic_ostream<Elem, Tr>ekler.
ostreambuf_iterator Sınıf şablonu bir çıkış yineleyici nesnesi açıklar. Sınıfın Elem öğelerini, depoladığı bir nesne aracılığıyla eriştiği bir çıkış akışı arabelleğine, işaretçi türündeki öğesine basic_streambuf<Elem, Tr>ekler.
output_iterator_tag Çıkış yineleyicisini temsil eden işlev için iterator_category bir dönüş türü sağlayan sınıf.
random_access_iterator_tag Rastgele erişim yineleyicisini temsil eden işlev için iterator_category bir dönüş türü sağlayan sınıf.
reverse_iterator Sınıf şablonu, rastgele erişim yineleyicisi gibi davranan bir nesneyi yalnızca tersten açıklar.
unchecked_array_iterator Bir rastgele erişim, denetlenmemiş yineleyici kullanarak bir diziye erişen sınıf. Not: Bu sınıf, C++ Standart Kitaplığı'nın bir Microsoft uzantısıdır. Bu işlev kullanılarak uygulanan kod, bu Microsoft uzantısını desteklemeyen C++ Standart derleme ortamlarına taşınabilir değildir.

Kavramlar

Aşağıdaki kavramlar ad alanında std tanımlanır. Yineleyicilere uygulanır ve kavramlarda <ranges>açıklanan aralıklar için yineleyici kategorileriyle de ilişkilidir.

Yineleyici kavramı Açıklama
bidirectional_iteratorC++20 Hem ileri hem de geri okuyabilen ve yazabilen bir yineleyici belirtir.
contiguous_iteratorC++20 Öğeleri bellekte sıralı, aynı boyutta olan ve işaretçi aritmetiği kullanılarak erişilebilen bir yineleyici belirtir.
forward_iteratorC++20 Birden çok kez okuyabilen (ve büyük olasılıkla yazabilen) bir yineleyici belirtir.
input_iteratorC++20 En az bir kez okuyabileceğiniz bir yineleyici belirtir.
input_or_output_iteratorC++20 Yineleyici kavramı taksonomisinin temeli.
output_iterator Yazabileceğiniz bir yineleyici belirtir.
random_access_iteratorC++20 Dizine göre okuyabileceğiniz ve yazabileceğiniz bir yineleyici belirtir.
sentinel_forC++20 Yineleyici türü için bir sentinel belirtir.
sized_sentinel_forC++20 Bir yineleyicinin ve sentinel değerinin, sabit süredeki farklarını bulmak için çıkarılabildiğini (kullanılarak -) belirtir.

Ayrıca bkz.

Üst Bilgi Dosyaları Başvurusu
C++ Standart Kitaplığında İş Parçacığı Güvenliği
C++ Standart Kitaplığı Başvurusu