CStringList Members
Base Class Members
CStringList Members
Note
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
Constructs an empty list for CString objects. |
Head/Tail Access
Returns the head element of the list (cannot be empty). |
|
Returns the tail element of the list (cannot be empty). |
Operations
Adds an element (or all the elements in another list) to the head of the list (makes a new head). |
|
Adds an element (or all the elements in another list) to the tail of the list (makes a new tail). |
|
Removes all the elements from this list. |
|
Removes the element from the head of the list. |
|
Removes the element from the tail of the list. |
Iteration
Returns the position of the head element of the list. |
|
Gets the next element for iterating. |
|
Gets the previous element for iterating. |
|
Returns the position of the tail element of the list. |
Retrieval/Modification
Gets the element at a given position. |
|
Removes an element from this list as specified by position. |
|
Sets the element at a given position. |
Insertion
Inserts a new element after a given position. |
|
Inserts a new element before a given position. |
Searching
Gets the position of an element specified by string value. |
|
Gets the position of an element specified by a zero-based index. |
Status
Returns the number of elements in this list. |
|
Returns the number of elements in this list. |
|
Tests for the empty list condition (no elements). |