\hypertarget{group__hwlocality__traversal}{\section{Retrieve Objects}
\label{group__hwlocality__traversal}\index{Retrieve Objects@{Retrieve Objects}}
}


Be sure to see the figure in termsanddefs that shows a complete topology tree, including depths, child/sibling/cousin relationships, and an example of an asymmetric topology where one socket has fewer caches than its peers.  


\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
\hypertarget{group__hwlocality__traversal_gaedd78240b0c1108355586a268ec5a697}{H\+W\+L\+O\+C\+\_\+\+D\+E\+C\+L\+S\+P\+E\+C \hyperlink{group__hwlocality__objects_ga79b8ab56877ef99ac59b833203391c7d}{hwloc\+\_\+obj\+\_\+t} \hyperlink{group__hwlocality__traversal_gaedd78240b0c1108355586a268ec5a697}{hwloc\+\_\+get\+\_\+obj\+\_\+by\+\_\+depth} (\hyperlink{group__hwlocality__topology_ga9d1e76ee15a7dee158b786c30b6a6e38}{hwloc\+\_\+topology\+\_\+t} topology, unsigned depth, unsigned idx) \+\_\+\+\_\+hwloc\+\_\+attribute\+\_\+pure}\label{group__hwlocality__traversal_gaedd78240b0c1108355586a268ec5a697}

\begin{DoxyCompactList}\small\item\em Returns the topology object at logical index {\ttfamily idx} from depth {\ttfamily depth}. \end{DoxyCompactList}\item 
static \+\_\+\+\_\+hwloc\+\_\+inline \\*
\hyperlink{group__hwlocality__objects_ga79b8ab56877ef99ac59b833203391c7d}{hwloc\+\_\+obj\+\_\+t} \\*
\+\_\+\+\_\+hwloc\+\_\+attribute\+\_\+pure \hyperlink{group__hwlocality__traversal_ga701f83b2cf0cb8e0acd58cd2dc1c67a2}{hwloc\+\_\+get\+\_\+obj\+\_\+by\+\_\+type} (\hyperlink{group__hwlocality__topology_ga9d1e76ee15a7dee158b786c30b6a6e38}{hwloc\+\_\+topology\+\_\+t} topology, \hyperlink{group__hwlocality__types_gacd37bb612667dc437d66bfb175a8dc55}{hwloc\+\_\+obj\+\_\+type\+\_\+t} type, unsigned idx)
\begin{DoxyCompactList}\small\item\em Returns the topology object at logical index {\ttfamily idx} with type {\ttfamily type}. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
Be sure to see the figure in termsanddefs that shows a complete topology tree, including depths, child/sibling/cousin relationships, and an example of an asymmetric topology where one socket has fewer caches than its peers. 



\subsection{Function Documentation}
\hypertarget{group__hwlocality__traversal_ga701f83b2cf0cb8e0acd58cd2dc1c67a2}{\index{Retrieve Objects@{Retrieve Objects}!hwloc\+\_\+get\+\_\+obj\+\_\+by\+\_\+type@{hwloc\+\_\+get\+\_\+obj\+\_\+by\+\_\+type}}
\index{hwloc\+\_\+get\+\_\+obj\+\_\+by\+\_\+type@{hwloc\+\_\+get\+\_\+obj\+\_\+by\+\_\+type}!Retrieve Objects@{Retrieve Objects}}
\subsubsection[{hwloc\+\_\+get\+\_\+obj\+\_\+by\+\_\+type}]{\setlength{\rightskip}{0pt plus 5cm}static \+\_\+\+\_\+hwloc\+\_\+inline {\bf hwloc\+\_\+obj\+\_\+t} \+\_\+\+\_\+hwloc\+\_\+attribute\+\_\+pure hwloc\+\_\+get\+\_\+obj\+\_\+by\+\_\+type (
\begin{DoxyParamCaption}
\item[{{\bf hwloc\+\_\+topology\+\_\+t}}]{topology, }
\item[{{\bf hwloc\+\_\+obj\+\_\+type\+\_\+t}}]{type, }
\item[{unsigned}]{idx}
\end{DoxyParamCaption}
)\hspace{0.3cm}{\ttfamily [static]}}}\label{group__hwlocality__traversal_ga701f83b2cf0cb8e0acd58cd2dc1c67a2}


Returns the topology object at logical index {\ttfamily idx} with type {\ttfamily type}. 

If no object for that type exists, {\ttfamily N\+U\+L\+L} is returned. If there are several levels with objects of that type, {\ttfamily N\+U\+L\+L} is returned and ther caller may fallback to \hyperlink{group__hwlocality__traversal_gaedd78240b0c1108355586a268ec5a697}{hwloc\+\_\+get\+\_\+obj\+\_\+by\+\_\+depth()}. 

References hwloc\+\_\+get\+\_\+obj\+\_\+by\+\_\+depth(), hwloc\+\_\+get\+\_\+type\+\_\+depth(), H\+W\+L\+O\+C\+\_\+\+T\+Y\+P\+E\+\_\+\+D\+E\+P\+T\+H\+\_\+\+M\+U\+L\+T\+I\+P\+L\+E, and H\+W\+L\+O\+C\+\_\+\+T\+Y\+P\+E\+\_\+\+D\+E\+P\+T\+H\+\_\+\+U\+N\+K\+N\+O\+W\+N.



Referenced by hwloc\+\_\+get\+\_\+obj\+\_\+below\+\_\+by\+\_\+type().

