Struct iterator_traits
Uma estrutura de auxiliar do modelo usado para especificar todas as definições de tipo críticos que um iterador deve ter.
template<class Iterator>
struct iterator_traits {
typedef typename Iterator::iterator_category iterator_category;
typedef typename Iterator::value_type value_type;
typedef typename Iterator::difference_type difference_type;
typedef difference_type distance_type;
typedef typename Iterator::pointer pointer;
typedef typename Iterator::reference reference;
};
template<class Type>
struct iterator_traits<Type*> {
typedef random_access_iterator_tag iterator_category;
typedef Type value_type;
typedef ptrdiff_t difference_type;
typedef difference_type distance_type;
typedef Type *pointer;
typedef Type& reference;
};
template<class Type>
struct iterator_traits<const Type*> {
typedef random_access_iterator_tag iterator_category;
typedef Type value_type;
typedef ptrdiff_t difference_type;
typedef difference_type distance_type;
typedef const Type *pointer;
typedef const Type& reference;
};
Comentários
O struct do modelo define os tipos de membro
iterator_category: um sinônimo para Iterator::iterator_category.
value_type: um sinônimo para Iterator::value_type.
difference_type: um sinônimo para Iterator::difference_type.
distance_type: um sinônimo para Iterator::difference_type.
pointer: um sinônimo para Iterator::pointer.
reference: um sinônimo para Iterator::reference.
As especializações parciais determinam os tipos importantes associados a um ponteiro de objeto do tipo Type * ou de const Type *.
Nessa implementação você também pode usar várias funções de modelo que não utilizam a especialização parcial:
template<class Category, class Type, class Diff>
C _Iter_cat(const iterator<Category, Ty, Diff>&);
template<class Ty>
random_access_iterator_tag _Iter_cat(const Ty *);
template<class Category, class Ty, class Diff>
Ty *_Val_type(const iterator<Category, Ty, Diff>&);
template<class Ty>
Ty *_Val_type(const Ty *);
template<class Category, class Ty, class Diff>
Diff *_Dist_type(const iterator<Category, Ty, Diff>&);
template<class Ty>
ptrdiff_t *_Dist_type(const Ty *);
determinam quais vários tipos dos mesmos mais indiretamente. Você usa estas funções como argumentos em uma chamada de função. Seu único propósito é fornecer um parâmetro de classe útil do modelo para a função chamada.
Exemplo
// iterator_traits.cpp
// compile with: /EHsc
#include <iostream>
#include <iterator>
#include <vector>
#include <list>
using namespace std;
template< class it >
void
function( it i1, it i2 )
{
iterator_traits<it>::iterator_category cat;
cout << typeid( cat ).name( ) << endl;
while ( i1 != i2 )
{
iterator_traits<it>::value_type x;
x = *i1;
cout << x << " ";
i1++;
};
cout << endl;
};
int main( )
{
vector<char> vc( 10,'a' );
list<int> li( 10 );
function( vc.begin( ), vc.end( ) );
function( li.begin( ), li.end( ) );
}
Requisitos
Cabeçalho: <iterator>
Namespace: std