Clase de CStringList

Artículo
03/15/2013

admite listas de objetos de CString .

class CStringList : public CObject

Miembros

Las funciones miembro de CStringList son similares a las funciones miembro de clases CObList.Debido a esta similitud, puede utilizar la documentación de referencia de CObList 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*& CObList::GetHead() const;

por ejemplo, convierte a

CString& CStringList::GetHead() const;

POSITION AddHead( CObject* <newElement> );

convierte a

POSITION AddHead( LPCTSTR <newElement> );

Constructores públicos

Name	Descripción
CObList::CObList	Crea una lista vacía.

Métodos públicos

Name	Descripción
CObList::AddHead	Agrega un elemento (o todos los elementos de otros enumerados) al principio de la lista (crea un nuevo encabezado).
CObList::AddTail	Agrega un elemento (o todos los elementos de otros enumerados) a la cola de la lista (crea una nueva cola).
CObList::Find	Obtiene la posición de un elemento especificado por valor de puntero.
CObList::FindIndex	Obtiene la posición de un elemento especificado por un índice de base cero.
CObList::GetAt	Obtiene el elemento en una posición determinada.
CObList::GetCount	devuelve el número de elementos en esta lista.
CObList::GetHead	Devuelve el elemento principal de la lista (no puede estar vacía).
CObList::GetHeadPosition	Devuelve la posición del elemento head de la lista.
CObList::GetNext	Obtiene el elemento siguiente para recorrer.
CObList::GetPrev	Obtiene el elemento anterior para recorrer.
CObList::GetSize	devuelve el número de elementos en esta lista.
CObList::GetTail	Devuelve el elemento de cola de la lista (no puede estar vacía).
CObList::GetTailPosition	Devuelve la posición del elemento de cola de la lista.
CObList::InsertAfter	Inserta un nuevo elemento después de una posición determinada.
CObList::InsertBefore	Inserta un nuevo elemento antes de una posición determinada.
CObList::IsEmpty	Comprueba la condición vacía de lista (ningún elemento).
CObList::RemoveAll	quita todos los elementos de esta lista.
CObList::RemoveAt	Quita un elemento de esta lista, especificada por posición.
CObList::RemoveHead	Quita el elemento del encabezado de la lista.
CObList::RemoveTail	Quita el elemento de cola de la lista.
CObList::SetAt	Establece el elemento en una posición determinada.

Comentarios

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

CStringList escribe la macro de IMPLEMENT_SERIAL para admitir la serialización y volcar de sus elementos.Si una lista de 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 de CString se serializa en su lugar.

Si necesita un volcado de memoria de los elementos individuales de CString , debe establecer el nivel de contexto de volcado de memoria en 1 o posterior.

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