Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::iterator_traits — typy spojené s iterátorem

std::iterator_traits<I> z hlavičky <iterator> zpřístupňuje typy popisující iterátor, včetně běžného ukazatele. Umožňuje psát algoritmy nezávislé na konkrétním kontejneru a rozlišit typ hodnoty od typu výsledku dereference.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <iterator>
std::iterator_traits<I>
typename std::iterator_traits<I>::value_type

std::iterator_traits<I> je šablona třídy z <iterator>, která umožňuje získat informace o typu iterátoru při překladu. Mezi obvyklé členy patří value_type (typ hodnoty), difference_type (typ rozdílu), reference (typ výsledku dereference), pointer (typ ukazatele) a iterator_category (kategorie pro klasické algoritmy).

Pro const int* je value_type typ int, zatímco reference je const int& a pointer je const int*. Specializace pro ukazatele na objekty zpřístupňuje také iterator_concept: je to std::contiguous_iterator_tag, přestože iterator_category zůstává std::random_access_iterator_tag. Tyto značky nejsou zaměnitelné.

Primární šablona používá vnořené typy iterátoru nebo, jsou-li splněny určité požadavky, odvodí chybějící informace. Ne každý typ má všechny členy; některé typy výstupních iterátorů mohou mít členy typu void. Nepředpokládejte také, že reference vždy označuje běžnou referenci — může jít o proxy typ.

V šablonách zápis typename std::iterator_traits<I>::value_type označuje závislé jméno jako typ. V kódu založeném na konceptech a ranges zvažte také std::iter_value_t<I>, std::iter_difference_t<I> a std::iter_reference_t<I>; poslední alias vychází přímo z výrazu dereference, nikoli z členu reference.

Příklady

#include <iostream>
#include <iterator>
#include <type_traits>

int main() {
    const int values[] = {2, 4, 6};
    using Traits = std::iterator_traits<const int*>;

    static_assert(std::is_same_v<Traits::value_type, int>);
    static_assert(std::is_same_v<Traits::reference, const int&>);
    static_assert(std::is_same_v<Traits::pointer, const int*>);
    static_assert(std::is_same_v<Traits::iterator_category,
                                 std::random_access_iterator_tag>);
    static_assert(std::is_same_v<Traits::iterator_concept,
                                 std::contiguous_iterator_tag>);

    Traits::value_type sum = 0;
    Traits::difference_type count = (values + 3) - values;
    for (const int* it = values; it != values + 3; ++it) {
        sum += *it;
    }
    std::cout << sum << ' ' << count << '\n';
}

Výsledek

12 3

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje