Clase CStringArray

Admite matrices de objetos CString .

Sintaxis

class CStringArray : public CObject

Miembros

Las funciones miembro de CStringArray son similares a las funciones miembro de la clase CObArray. Debido a esta similitud, puede utilizar la documentación de referencia de CObArray para obtener información específica de la función miembro. Siempre que vea un puntero CObject como valor devuelto, sustituya un objeto CString (no un puntero CString). Siempre que vea un puntero CObject como un parámetro de función, use un LPCTSTR.

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

por ejemplo, se traduce en

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

y

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

se traduce en

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

Constructores públicos

Nombre	Descripción
CStringArray::CStringArray	Construye una matriz vacía.

Métodos públicos

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

Operadores públicos

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

Comentarios

CStringArray incorpora la macro IMPLEMENT_SERIAL para admitir la serialización y el volcado de sus elementos. Si una matriz de objetos CString se almacena en un archivo, bien con un operador de inserción sobrecargado, o bien con la función miembro Serialize, cada elemento se serializa a su vez.

Nota:

Antes de usar una matriz, use SetSize para establecer su tamaño y asignarle memoria. Si no usa SetSize, al agregar elementos a la matriz, esta se reasigna y se copia con frecuencia. La reasignación y copia frecuentes son ineficaces y pueden fragmentar la memoria.

Si se necesita un volcado de elementos de cadena individuales en la matriz, se debe establecer la profundidad del contexto de volcado en 1 o un valor superior.

Cuando se elimina una matriz CString o cuando se quitan sus elementos, se libera memoria de cadenas según corresponda.

Para más información sobre cómo usar CStringArray, consulte el artículo Colecciones.

Jerarquía de herencia

CObject

CStringArray

Requisitos

Encabezado: afxcoll.h

Consulte también

CObject (clase)
Gráfico de jerarquías