Compartilhar via

Classe CElementTraitsBase

  • Artigo

Essa classe fornece métodos de cópia e movimentação padrão para uma classe de coleção.

Sintaxe

template<typename T>
class CElementTraitsBase

Parâmetros

T
O tipo de dados a serem armazenados na coleção.

Membros

Typedefs públicos

Nome Descrição
CElementTraitsBase::INARGTYPE O tipo de dados a ser usado para adicionar elementos ao objeto da classe de coleção.
CElementTraitsBase::OUTARGTYPE O tipo de dados a ser usado para recuperar elementos do objeto de classe de coleção.

Métodos públicos

Nome Descrição
CElementTraitsBase::CopyElements Chame esse método para copiar elementos armazenados em um objeto de classe de coleção.
CElementTraitsBase::RelocateElements Chame esse método para realocar elementos armazenados em um objeto de classe de coleção.

Comentários

Essa classe base define métodos para copiar e realocar elementos em uma classe de coleção. Ela é utilizada pelas classes CDefaultElementTraits, CStringRefElementTraits e CStringElementTraitsI.

Para obter mais informações, confira Classes de Coleção da ATL.

Requisitos

Cabeçalho: atlcoll.h

CElementTraitsBase::CopyElements

Chame esse método para copiar elementos armazenados em um objeto de classe de coleção.

static void CopyElements(
    T* pDest,
    const T* pSrc,
    size_t nElements);

Parâmetros

pDest
Ponteiro para o primeiro elemento que receberá os dados copiados.

pSrc
Ponteiro para o primeiro elemento a ser copiado.

nElements
O número de elementos a serem copiados.

Comentários

Os elementos de origem e destino não devem se sobrepor.

CElementTraitsBase::INARGTYPE

O tipo de dados a ser usado para adicionar elementos à coleção.

typedef const T& INARGTYPE;

CElementTraitsBase::OUTARGTYPE

O tipo de dados a ser usado para recuperar elementos da coleção.

typedef T& OUTARGTYPE;

CElementTraitsBase::RelocateElements

Chame esse método para realocar elementos armazenados em um objeto de classe de coleção.

static void RelocateElements(
    T* pDest,
    T* pSrc,
    size_t nElements);

Parâmetros

pDest
Ponteiro para o primeiro elemento que receberá os dados realocados.

pSrc
Ponteiro para o primeiro elemento a ser realocado.

nElements
O número de elementos a ser realocado.

Comentários

Esse método chama memmove, que é suficiente para a maioria dos tipos de dados. Se os objetos que estão sendo movidos contiverem ponteiros para seus próprios membros, esse método precisará ser substituído.

Confira também

Visão geral da aula