Clase CStringList

Admite listas de objetos CString .

Sintaxis

class CStringList : public CObject

Miembros

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

CObject*& CObList::GetHead() const;

por ejemplo, se traduce en

CString& CStringList::GetHead() const;

y

POSITION AddHead( CObject* <newElement> );

se traduce en

POSITION AddHead( LPCTSTR <newElement> );

Constructores públicos

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

Métodos públicos

Nombre	Descripción
CStringList::AddHead	Agrega un elemento (o todos los elementos de otra lista) al principio de la lista (crea un principio nuevo).
CStringList::AddTail	Agrega un elemento (o todos los elementos de otra lista) al final de la lista (crea un final nuevo).
CStringList::Find	Obtiene la posición de un elemento especificado por el valor de puntero.
CStringList::FindIndex	Obtiene la posición de un elemento especificado por un índice basado en cero.
CStringList::GetAt	Obtiene el elemento en una posición determinada.
CStringList::GetCount	Devuelve el número de elementos en esta lista.
CStringList::GetHead	Devuelve el elemento principal de la lista (no puede estar vacío).
CStringList::GetHeadPosition	Devuelve la posición del elemento de encabezado de la lista.
CStringList::GetNext	Obtiene el siguiente elemento para iterar.
CStringList::GetPrev	Obtiene el elemento anterior para su iteración.
CStringList::GetSize	Devuelve el número de elementos en esta lista.
CStringList::GetTail	Devuelve el elemento de cola de la lista (no puede estar vacío).
CStringList::GetTailPosition	Devuelve la posición del elemento del final de la lista.
CStringList::InsertAfter	Inserta un elemento nuevo después de una posición determinada.
CStringList::InsertBefore	Inserta un elemento nuevo antes de una posición determinada.
CStringList::IsEmpty	Comprueba la condición de lista vacía (sin elementos).
CStringList::RemoveAll	Quita todos los elementos de esta lista.
CStringList::RemoveAt	Quita un elemento de esta lista, especificado por posición.
CStringList::RemoveHead	Quita el elemento del principio de la lista.
CStringList::RemoveTail	Quita el elemento del final de la lista.
CStringList::SetAt	Establece el elemento en una posición determinada.

Comentarios

Todas las comparaciones se realizan por valor, lo que significa que los caracteres de la cadena se comparan en lugar de las direcciones de las cadenas.

CStringList incorpora la macro IMPLEMENT_SERIAL para admitir la serialización y el volcado de sus elementos. Si una lista 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 CString se serializa a su vez.

Si se necesita un volcado de elementos CString de asignación individuales, se debe establecer la profundidad del contexto de volcado en 1 o un valor superior.

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

Jerarquía de herencia

CObject

CStringList

Requisitos

Encabezadoafxcoll.h:

Consulte también

Ejemplo de MFCCOLLECT
CObject (clase)
Gráfico de jerarquías