CStringList Members

CStringList methods implement ways to add, remove, find, move, and count CString objects in a double-linked list that is contained by CStringList.

CObject Members is a list of methods from CObject, the base class for CStringList.

Note

The methods of CStringList resemble the methods of class CObList.

Construction

CStringList

Constructs an empty list for CString objects.

Head/Tail Access

GetHead	Returns the head element of the list (cannot be empty).
GetTail	Returns the tail element of the list (cannot be empty).

Operations

AddHead	Adds an element (or all the elements in another list) to the head of the list (makes a new head).
AddTail	Adds an element (or all the elements in another list) to the tail of the list (makes a new tail).
RemoveAll	Removes all the elements from this list.
RemoveHead	Removes the element from the head of the list.
RemoveTail	Removes the element from the tail of the list.

Iteration

GetHeadPosition	Returns the position of the head element of the list.
GetNext	Gets the next element for iterating.
GetPrev	Gets the previous element for iterating.
GetTailPosition	Returns the position of the tail element of the list.

Retrieval/Modification

GetAt	Gets the element at a given position.
RemoveAt	Removes an element from this list as specified by position.
SetAt	Sets the element at a given position.

Insertion

InsertAfter	Inserts a new element after a given position.
InsertBefore	Inserts a new element before a given position.

Searching

Find	Gets the position of an element specified by string value.
FindIndex	Gets the position of an element specified by a zero-based index.

Status

GetSize	Returns the number of elements in this list.
GetCount	Returns the number of elements in this list.
IsEmpty	Tests for the empty list condition (no elements).

See Also

Reference

CStringList Class

CStringT Class

Hierarchy Chart

Other Resources

Using CString

Change History

Date	History	Reason
October 2009	Added a link to the CString topic.	Customer feedback.