Share via


CStringList Members

Base Class Members

CObject Members

CStringList Members

Nota

The member functions of CStringList are similar to the member functions of class CObList. Because of this similarity, you can use the CObList reference documentation for member function specifics. Wherever you see a CObject pointer as a return value, substitute a CString (not a CString pointer). Wherever you see a CObject pointer as a function parameter, substitute an LPCTSTR.

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

Concepts

CStringList Class

Hierarchy Chart