Compartir a través de


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

Encabezado: afxcoll.h

Consulte también

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