Clase de CStringArray

Admite las matrices de objetos de CString .

class CStringArray : public CObject

Miembros

Las funciones miembro de CStringArray son similares a las funciones miembro de clases CObArray.Debido a esta similitud, puede utilizar la documentación de referencia de CObArray para las características de la función miembro.Siempre que aparezca un puntero de CObject como valor devuelto, sustituya CString (no un puntero de CString ).Siempre que aparezca un puntero de CObject como parámetro de la función, sustituya LPCTSTR.

CObject* CObArray::GetAt( int <nIndex> ) const;

por ejemplo, convierte a

CString CStringArray::GetAt( int <nIndex> ) const;

y

void SetAt( int <nIndex>, CObject* <newElement> )

convierte a

void SetAt( int <nIndex>, LPCTSTR <newElement> )

Constructores públicos

Name	Descripción
CObArray::CObArray	Crea una matriz vacía.

Métodos públicos

Name	Descripción
CObArray::Add	Agrega un elemento al final de la matriz; aumenta la matriz en caso necesario.
CObArray::Append	Anexa otra matriz a la matriz; aumenta la matriz en caso necesario.
CObArray::Copy	Copia otra matriz a la matriz; aumenta la matriz en caso necesario.
CObArray::ElementAt	Devuelve una referencia temporal a puntero de elemento dentro de la matriz.
CObArray::FreeExtra	Libera toda la memoria no utilizada sobre el límite superior actual.
CObArray::GetAt	Devuelve el valor en el índice especificado.
CObArray::GetCount	Obtiene el número de elementos en esta matriz.
CObArray::GetData	Permite el acceso a los elementos de la matriz.puede ser NULL.
CObArray::GetSize	Obtiene el número de elementos en esta matriz.
CObArray::GetUpperBound	Devuelve el índice válido mayor.
CObArray::InsertAt	Inserta un elemento (o todos los elementos en otra matriz) en el índice especificado.
CObArray::IsEmpty	Determina si la matriz está vacía.
CObArray::RemoveAll	Quita todos los elementos de esta matriz.
CObArray::RemoveAt	quita un elemento en un índice específico.
CObArray::SetAt	Establece el valor en el índice especificado; matriz no permitido crecer.
CObArray::SetAtGrow	Establece el valor en el índice especificado; aumenta la matriz en caso necesario.
CObArray::SetSize	Establece el número de elementos que se contendrán en esta matriz.

Operadores públicos

Name	Descripción
CObArray::operator [ ]	Establece u obtiene el elemento en el índice especificado.

Comentarios

CStringArray escribe la macro de IMPLEMENT_SERIAL para admitir la serialización y volcar de sus elementos.Si una matriz de los objetos de CString se almacena en un archivo, con un operador sobrecargado de inserción o con la función miembro de Serialize , cada elemento es serializado a su vez.

[!NOTA]

Antes de utilizar una matriz, utilice SetSize para establecer su tamaño y para asignar memoria para ella.Si no utiliza SetSize, agregar elementos a la matriz hace con frecuencia que se reasignara y copiar.La reasignación frecuente y la copia son ineficaces y pueden fragmentar la memoria.

Si necesita un volcado de los elementos individuales de la cadena de la matriz, debe establecer el nivel de contexto de volcado en 1 o posterior.

Cuando se elimina una matriz de CString , o cuando se quitan los elementos, memoria de la cadena se libera según corresponda.

Para obtener más información sobre cómo utilizar CStringArray, vea el artículo colecciones.

Jerarquía de herencia

CObject

CStringArray

Requisitos

encabezado: afxcoll.h

Vea también

Referencia

Clase de CObject

Gráfico de jerarquía