CMapStringToOb::GetNextAssoc

void GetNextAssoc ( POSITIONamp; rNextPosition, CString & rKey, CObject * & rValue ) const;

Parámetros

rNextPosition

Especifica una referencia a un valor de posición devuelta por una anterior llamada GetNextAssoc o GetStartPosition.

rKey

Especifica la clave devuelta el elemento recuperado (una cadena).

rValue

Especifica el valor devuelto del elemento consultado (un puntero de CObject ). Vea la sección Comentarios para obtener más información acerca de este parámetro.

Observaciones

Recupera el elemento map en rNextPositiony, a continuación, actualiza rNextPosition para referirse al siguiente elemento en el mapa. Esta función es muy útil para recorrer en iteración todos los elementos en el mapa. Tenga en cuenta que la secuencia de posición no es necesariamente la misma que la secuencia de valor de la clave.

Si el elemento recuperado es la última en el mapa, el nuevo valor de rNextPosition se establece en NULL.

P&ara el parámetro rValue , asegúrese de convertir el tipo de objeto CObject * amp;, que es lo que el compilador requiere, como se muestra en el ejemplo siguiente:

CMyObject * ob;
mapa.GetNext&Assoc (pos, clave, (CObject * amp;) ob)

Esto no es cierto GetNextAssoc de mapas basados en plantillas.

Ejemplo

Consulte CObList::CObList para obtener una lista de los CAge clase utilizada en todos los ejemplos de colección.

/ / por ejemplo CMapStringToOb::GetNextAssoc y CMapStringToOb::GetStartPosition
   Mapa de CMapStringToOb;
   POSICIÓN pos;
   CString clave;
   Jaula * pa;
   
   mapa.SetAt ("Bart", Nueva jaula (13));
   mapa.SetAt ("Lisa", Nueva jaula (11));
   mapa.SetAt ("Homer", Nueva jaula (36));
   mapa.SetAt ("Marge", Nueva jaula (35));
   / / Recorrer el mapa completo, dumping nombre y edad.
   para (pos = mapa.GetStartPosition(); pos! = NULL; )
   {
   mapa.GetNextAssoc (pos, clave, (CObject * amp;) pa);
# ifdef _DEBUG
      afxDump << clave << ":" << pa << "\n";
# endif
   }

Los resultados de este programa son los siguientes:

Lisa: una jaula en $4724 11
Marge: una jaula en $47A8 35
Homer: una jaula en $4766 36
Bart: una jaula en $45 4 13

Visión General de CMapStringToOb |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CMapStringToOb::GetStartPosition

Index