Classe CComSafeArray

Artigo
08/25/2010

Essa classe é um wrapper para o SAFEARRAY estrutura.

template <
   typename T,
   VARTYPE _vartype = _ATL_AutomationType< T >::type
>
class CComSafeArray

Parâmetros

T
O tipo de dados sejam armazenados na matriz.

Comentários

CComSafeArray Fornece um wrapper para o SAFEARRAY Data Type classe, tornando uma questão simples para criar e gerenciar único e matrizes multidimensionais de quase qualquer um dos tipos com suporte VARIANT.

CComSafeArray simplifica a passar matrizes entre processos e também fornece segurança extra, verificando os limites inferior e valores de índice de matriz em relação a superior.

O limite inferior de um CComSafeArray pode iniciar com qualquer valor definido pelo usuário; no entanto, matrizes que são acessados por meio de C++ devem usar um limite inferior de 0. Outras linguagens sistema autônomo o Visual Basic podem usar outros valores de limite (por exemplo, -10 a 10).

Use CComSafeArray::Create para criar um CComSafeArray objeto, e CComSafeArray::Destroy para excluí-lo.

A CComSafeArray pode conter o seguinte subconjunto de tipos de dados VARIANT:

VARTYPE	Descrição
VT_I1	char
VT_I2	short
VT_I4	int
VT_I4	long
VT_I8	longlong
VT_UI1	Byte
VT_UI2	ushort
VT_UI4	uint
VT_UI4	ulong
VT_UI8	ULONGLONG
VT_R4	float
VT_R8	double
VT_DECIMAL	ponteiro decimal
VT_VARIANT	variante do ponteiro
VT_CY	Tipo de dados Currency

Requisitos

Cabeçalho: atlsafe.h

Exemplo

// Create a multidimensional array, 
// then write and read elements

// Define an array of character pointers
CComSafeArray<char> *pSar;

char cElement;
char cTable[2][3] = {'A','B','C','D','E','F'};

// Declare the variable used to store the
// array indexes
LONG aIndex[2];

// Define the array bound structure
CComSafeArrayBound bound[2];
bound[0].SetCount(3);
bound[0].SetLowerBound(0);
bound[1].SetCount(3);
bound[1].SetLowerBound(0);   

// Create a new 2 dimensional array
// each dimension size is 3
pSar = new CComSafeArray<char>(bound,2); 

// Use MultiDimSetAt to store characters in the array
for (int x = 0; x < 2; x++)
{
   for (int y = 0; y < 3; y++)
   {
      aIndex[0] = x;
      aIndex[1] = y;
      HRESULT hr = pSar->MultiDimSetAt(aIndex,cTable[x][y]);
      ATLASSERT(hr == S_OK);
   }
}
// Use MultiDimGetAt to retrieve characters in the array
for (int x = 0; x < 2; x++)
{
   for (int y = 0; y < 3; y++)
   {
      aIndex[0]=x;
      aIndex[1]=y;
      HRESULT hr = pSar->MultiDimGetAt(aIndex,cElement);
      ATLASSERT(hr == S_OK);
      ATLASSERT(cElement == cTable[x][y]);
   }   
}