CObArray::GetData

Artigo
02/25/2013

Use esta função de membro para obter acesso direto aos elementos na matriz.

const CObject** GetData( ) const;  
CObject** GetData( );

Valor de retorno

Um ponteiro para a matriz de ponteiros de CObject .

Comentários

Se nenhum elemento estiver disponível, GetData retorna um valor nulo.

Quando o acesso direto aos elementos de uma matriz pode ajudá-lo a trabalhar mais rapidamente, use cuidados ao chamar GetData; todos os erros você faz alterações afetam diretamente aos elementos da matriz.

A tabela a seguir mostra outras funções de membro que são semelhantes a CObArray::GetData.

Classe	Função de membro
CByteArray	*const const BYTE GetData (;)BYTE* GetData (;)**
CDWordArray	*const const DWORD GetData (;)DWORD* GetData (;)**
CPtrArray	const vago const GetData (;)vácuo GetData (;)
CStringArray	*const de CString GetData const (;)CString* GetData (;)**
CUIntArray	*const const UINT GetData (;)UINT* GetData (;)**
CWordArray	*const const WORD GetData (;)WORD* GetData (;)**

Exemplo

Consulte CObList::CObList para uma listagem da classe de CAge usada em todos os exemplos de coleção.

CObArray myArray;

// Allocate memory for at least 32 elements.
myArray.SetSize(32, 128);

// Add elements to the array.
CAge** ppAge = (CAge**) myArray.GetData();
for (int i = 0; i < 32; i++, ppAge++)
   *ppAge = new CAge(i);

// Only keep first 5 elements and free extra (unused) bytes.
for (int i = 5; i < myArray.GetCount(); i++)
{
   delete myArray[i]; // free objects before resetting array size.         
}
myArray.SetSize(5, 128);
myArray.FreeExtra(); // only frees pointers.

#ifdef _DEBUG
    afxDump.SetDepth(1);
    afxDump << _T("myArray: ") << &myArray << _T("\n");
#endif