This topic has not yet been rated - Rate this topic

CObList::Find

Visual Studio 2008

Searches the list sequentially to find the first CObject pointer matching the specified CObject pointer.

POSITION Find( 
   CObject* searchValue, 
   POSITION startAfter = NULL  
) const;

Parameters

searchValue: The object pointer to be found in this list.
startAfter: The start position for the search.

Return Value

A POSITION value that can be used for iteration or object pointer retrieval; NULL if the object is not found.

Remarks

Note that the pointer values are compared, not the contents of the objects.

The following table shows other member functions that are similar to CObList::Find.

Class	Member Function
CPtrList	POSITION Find( void* searchValue, POSITION startAfter = NULL ) const;
CStringList	POSITION Find( LPCTSTR searchValue, POSITION startAfter = NULL ) const;

Example

See CObList::CObList for a listing of the CAge class.

C++

CObList list;
CAge* pa1;
CAge* pa2;
POSITION pos;
list.AddHead(pa1 = new CAge(21));
list.AddHead(pa2 = new CAge(40));    // List now contains (40, 21). 
if ((pos = list.Find(pa1)) != NULL) // Hunt for pa1
{                                  // starting at head by default.
    ASSERT(*(CAge*) list.GetAt(pos) == CAge(21));
}

Requirements

Header: afxcoll.h

Reference

Other Resources

CObList Members

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD