\doxysection{Str\+\_\+\+Offsets section details }
\hypertarget{group__str__offsets}{}\label{group__str__offsets}\index{Str\_Offsets section details@{Str\_Offsets section details}}
\doxysubsubsection*{Functions}
\begin{DoxyCompactItemize}
\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__str__offsets_ga27a2da2e2208aff754ed4b0fa9df1553}{dwarf\+\_\+open\+\_\+str\+\_\+offsets\+\_\+table\+\_\+access}} (\doxymbox{\hyperlink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}} dw\+\_\+dbg, \doxymbox{\hyperlink{group__allstructs_ga750da042cfbd9fba5d46f9df5078c526}{Dwarf\+\_\+\+Str\+\_\+\+Offsets\+\_\+\+Table}} \texorpdfstring{$\ast$}{*}dw\+\_\+table\+\_\+data, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Creates access to a .debug\+\_\+str\+\_\+offsets table. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__str__offsets_ga8302eadecab879ad879d69c04e33ad0a}{dwarf\+\_\+close\+\_\+str\+\_\+offsets\+\_\+table\+\_\+access}} (\doxymbox{\hyperlink{group__allstructs_ga750da042cfbd9fba5d46f9df5078c526}{Dwarf\+\_\+\+Str\+\_\+\+Offsets\+\_\+\+Table}} dw\+\_\+table\+\_\+data, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Close str\+\_\+offsets access, free table\+\_\+data. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__str__offsets_ga1d2c9cc9621b6745f2cdd98eeca94f6c}{dwarf\+\_\+next\+\_\+str\+\_\+offsets\+\_\+table}} (\doxymbox{\hyperlink{group__allstructs_ga750da042cfbd9fba5d46f9df5078c526}{Dwarf\+\_\+\+Str\+\_\+\+Offsets\+\_\+\+Table}} dw\+\_\+table\+\_\+data, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+unit\+\_\+length, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+unit\+\_\+length\+\_\+offset, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+table\+\_\+start\+\_\+offset, \doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} \texorpdfstring{$\ast$}{*}dw\+\_\+entry\+\_\+size, \doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} \texorpdfstring{$\ast$}{*}dw\+\_\+version, \doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} \texorpdfstring{$\ast$}{*}dw\+\_\+padding, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+table\+\_\+value\+\_\+count, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Iterate through the offsets tables. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__str__offsets_ga89920c09f2b1cc1e1fc16fe85b6ce962}{dwarf\+\_\+str\+\_\+offsets\+\_\+value\+\_\+by\+\_\+index}} (\doxymbox{\hyperlink{group__allstructs_ga750da042cfbd9fba5d46f9df5078c526}{Dwarf\+\_\+\+Str\+\_\+\+Offsets\+\_\+\+Table}} dw\+\_\+table\+\_\+data, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} dw\+\_\+index\+\_\+to\+\_\+entry, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+entry\+\_\+value, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Access to an individual str offsets table entry. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__str__offsets_ga421602c290bc2782bb128264683f0ed7}{dwarf\+\_\+str\+\_\+offsets\+\_\+statistics}} (\doxymbox{\hyperlink{group__allstructs_ga750da042cfbd9fba5d46f9df5078c526}{Dwarf\+\_\+\+Str\+\_\+\+Offsets\+\_\+\+Table}} dw\+\_\+table\+\_\+data, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+wasted\+\_\+byte\+\_\+count, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+table\+\_\+count, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Reports final wasted-\/bytes count. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsection{Detailed Description}
Shows just the section content in detail. Most library users will never call these, as references to this is handled by the code accessing some \doxylink{group__allstructs_ga3b8f8b4e43653647a2face222040a915}{Dwarf\+\_\+\+Attribute}. \doxylink{index_dwsec_independentsec}{Reading The Str\+\_\+\+Offsets } 

\label{doc-func-members}
\Hypertarget{group__str__offsets_doc-func-members}
\doxysubsection{Function Documentation}
\Hypertarget{group__str__offsets_ga8302eadecab879ad879d69c04e33ad0a}\index{Str\_Offsets section details@{Str\_Offsets section details}!dwarf\_close\_str\_offsets\_table\_access@{dwarf\_close\_str\_offsets\_table\_access}}
\index{dwarf\_close\_str\_offsets\_table\_access@{dwarf\_close\_str\_offsets\_table\_access}!Str\_Offsets section details@{Str\_Offsets section details}}
\doxysubsubsection{\texorpdfstring{dwarf\_close\_str\_offsets\_table\_access()}{dwarf\_close\_str\_offsets\_table\_access()}}
{\footnotesize\ttfamily \label{group__str__offsets_ga8302eadecab879ad879d69c04e33ad0a} 
DW\+\_\+\+API int dwarf\+\_\+close\+\_\+str\+\_\+offsets\+\_\+table\+\_\+access (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_ga750da042cfbd9fba5d46f9df5078c526}{Dwarf\+\_\+\+Str\+\_\+\+Offsets\+\_\+\+Table}}}]{dw\+\_\+table\+\_\+data}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Close str\+\_\+offsets access, free table\+\_\+data. 

\begin{DoxySeeAlso}{See also}
\doxylink{group__examplestrngoffsets}{Reading string offsets section data}
\end{DoxySeeAlso}

\begin{DoxyParams}{Parameters}
{\em dw\+\_\+table\+\_\+data} & \\
\hline
{\em dw\+\_\+error} & On error dw\+\_\+error is set to point to the error details. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
DW\+\_\+\+DLV\+\_\+\+OK etc. If there is no .debug\+\_\+str\+\_\+offsets section it returns DW\+\_\+\+DLV\+\_\+\+NO\+\_\+\+ENTRY If it returns DW\+\_\+\+DLV\+\_\+\+ERROR there is nothing you can do except report the error and, optionally, call dwarf\+\_\+dealloc\+\_\+error to dealloc the error content (and then set the dw\+\_\+error to NULL as after the dealloc the pointer is stale).. 
\end{DoxyReturn}
\Hypertarget{group__str__offsets_ga1d2c9cc9621b6745f2cdd98eeca94f6c}\index{Str\_Offsets section details@{Str\_Offsets section details}!dwarf\_next\_str\_offsets\_table@{dwarf\_next\_str\_offsets\_table}}
\index{dwarf\_next\_str\_offsets\_table@{dwarf\_next\_str\_offsets\_table}!Str\_Offsets section details@{Str\_Offsets section details}}
\doxysubsubsection{\texorpdfstring{dwarf\_next\_str\_offsets\_table()}{dwarf\_next\_str\_offsets\_table()}}
{\footnotesize\ttfamily \label{group__str__offsets_ga1d2c9cc9621b6745f2cdd98eeca94f6c} 
DW\+\_\+\+API int dwarf\+\_\+next\+\_\+str\+\_\+offsets\+\_\+table (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_ga750da042cfbd9fba5d46f9df5078c526}{Dwarf\+\_\+\+Str\+\_\+\+Offsets\+\_\+\+Table}}}]{dw\+\_\+table\+\_\+data}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+unit\+\_\+length}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+unit\+\_\+length\+\_\+offset}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+table\+\_\+start\+\_\+offset}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+entry\+\_\+size}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+version}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+padding}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+table\+\_\+value\+\_\+count}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Iterate through the offsets tables. 

\begin{DoxySeeAlso}{See also}
\doxylink{group__examplestrngoffsets}{Reading string offsets section data}
\end{DoxySeeAlso}
Access to the tables starts at offset zero. The library progresses through the next table automatically, keeping track internally to know where it is.


\begin{DoxyParams}{Parameters}
{\em dw\+\_\+table\+\_\+data} & Pass in an open \doxylink{group__allstructs_ga750da042cfbd9fba5d46f9df5078c526}{Dwarf\+\_\+\+Str\+\_\+\+Offsets\+\_\+\+Table}. \\
\hline
{\em dw\+\_\+unit\+\_\+length} & On success returns a table unit\+\_\+length field \\
\hline
{\em dw\+\_\+unit\+\_\+length\+\_\+offset} & On success returns the section offset of the unit\+\_\+length field. \\
\hline
{\em dw\+\_\+table\+\_\+start\+\_\+offset} & On success returns the section offset of the array of table entries. \\
\hline
{\em dw\+\_\+entry\+\_\+size} & On success returns the entry size (4 or 8) \\
\hline
{\em dw\+\_\+version} & On success returns the value in the version field 5. \\
\hline
{\em dw\+\_\+padding} & On success returns the zero value in the padding field. \\
\hline
{\em dw\+\_\+table\+\_\+value\+\_\+count} & On success returns the number of table entries, each of size dw\+\_\+entry\+\_\+size, in the table. \\
\hline
{\em dw\+\_\+error} & On error dw\+\_\+error is set to point to the error details. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
DW\+\_\+\+DLV\+\_\+\+OK Returns DW\+\_\+\+DLV\+\_\+\+NO\+\_\+\+ENTRY if there are no more entries. 
\end{DoxyReturn}
\Hypertarget{group__str__offsets_ga27a2da2e2208aff754ed4b0fa9df1553}\index{Str\_Offsets section details@{Str\_Offsets section details}!dwarf\_open\_str\_offsets\_table\_access@{dwarf\_open\_str\_offsets\_table\_access}}
\index{dwarf\_open\_str\_offsets\_table\_access@{dwarf\_open\_str\_offsets\_table\_access}!Str\_Offsets section details@{Str\_Offsets section details}}
\doxysubsubsection{\texorpdfstring{dwarf\_open\_str\_offsets\_table\_access()}{dwarf\_open\_str\_offsets\_table\_access()}}
{\footnotesize\ttfamily \label{group__str__offsets_ga27a2da2e2208aff754ed4b0fa9df1553} 
DW\+\_\+\+API int dwarf\+\_\+open\+\_\+str\+\_\+offsets\+\_\+table\+\_\+access (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}}}]{dw\+\_\+dbg}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga750da042cfbd9fba5d46f9df5078c526}{Dwarf\+\_\+\+Str\+\_\+\+Offsets\+\_\+\+Table}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+table\+\_\+data}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Creates access to a .debug\+\_\+str\+\_\+offsets table. 

\begin{DoxySeeAlso}{See also}
\doxylink{group__examplestrngoffsets}{Reading string offsets section data}
\end{DoxySeeAlso}

\begin{DoxyParams}{Parameters}
{\em dw\+\_\+dbg} & Pass in the \doxylink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug} of interest. \\
\hline
{\em dw\+\_\+table\+\_\+data} & On success returns a pointer to an opaque structure for use in further calls. \\
\hline
{\em dw\+\_\+error} & On error dw\+\_\+error is set to point to the error details. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
DW\+\_\+\+DLV\+\_\+\+OK etc. If there is no .debug\+\_\+str\+\_\+offsets section it returns DW\+\_\+\+DLV\+\_\+\+NO\+\_\+\+ENTRY 
\end{DoxyReturn}
\Hypertarget{group__str__offsets_ga421602c290bc2782bb128264683f0ed7}\index{Str\_Offsets section details@{Str\_Offsets section details}!dwarf\_str\_offsets\_statistics@{dwarf\_str\_offsets\_statistics}}
\index{dwarf\_str\_offsets\_statistics@{dwarf\_str\_offsets\_statistics}!Str\_Offsets section details@{Str\_Offsets section details}}
\doxysubsubsection{\texorpdfstring{dwarf\_str\_offsets\_statistics()}{dwarf\_str\_offsets\_statistics()}}
{\footnotesize\ttfamily \label{group__str__offsets_ga421602c290bc2782bb128264683f0ed7} 
DW\+\_\+\+API int dwarf\+\_\+str\+\_\+offsets\+\_\+statistics (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_ga750da042cfbd9fba5d46f9df5078c526}{Dwarf\+\_\+\+Str\+\_\+\+Offsets\+\_\+\+Table}}}]{dw\+\_\+table\+\_\+data}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+wasted\+\_\+byte\+\_\+count}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+table\+\_\+count}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Reports final wasted-\/bytes count. 

Reports the number of tables seen so far. Not very interesting.


\begin{DoxyParams}{Parameters}
{\em dw\+\_\+table\+\_\+data} & Pass in the open table pointer. \\
\hline
{\em dw\+\_\+wasted\+\_\+byte\+\_\+count} & Always returns 0 at present. \\
\hline
{\em dw\+\_\+table\+\_\+count} & On success returns the total number of tables seen so far in the section. \\
\hline
{\em dw\+\_\+error} & On error dw\+\_\+error is set to point to the error details. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
DW\+\_\+\+DLV\+\_\+\+OK etc. 
\end{DoxyReturn}
\Hypertarget{group__str__offsets_ga89920c09f2b1cc1e1fc16fe85b6ce962}\index{Str\_Offsets section details@{Str\_Offsets section details}!dwarf\_str\_offsets\_value\_by\_index@{dwarf\_str\_offsets\_value\_by\_index}}
\index{dwarf\_str\_offsets\_value\_by\_index@{dwarf\_str\_offsets\_value\_by\_index}!Str\_Offsets section details@{Str\_Offsets section details}}
\doxysubsubsection{\texorpdfstring{dwarf\_str\_offsets\_value\_by\_index()}{dwarf\_str\_offsets\_value\_by\_index()}}
{\footnotesize\ttfamily \label{group__str__offsets_ga89920c09f2b1cc1e1fc16fe85b6ce962} 
DW\+\_\+\+API int dwarf\+\_\+str\+\_\+offsets\+\_\+value\+\_\+by\+\_\+index (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_ga750da042cfbd9fba5d46f9df5078c526}{Dwarf\+\_\+\+Str\+\_\+\+Offsets\+\_\+\+Table}}}]{dw\+\_\+table\+\_\+data}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}}}]{dw\+\_\+index\+\_\+to\+\_\+entry}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+entry\+\_\+value}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Access to an individual str offsets table entry. 

\begin{DoxySeeAlso}{See also}
\doxylink{group__examplestrngoffsets}{Reading string offsets section data}
\end{DoxySeeAlso}

\begin{DoxyParams}{Parameters}
{\em dw\+\_\+table\+\_\+data} & Pass in the open table pointer. \\
\hline
{\em dw\+\_\+index\+\_\+to\+\_\+entry} & Pass in the entry number, 0 through dw\+\_\+table\+\_\+value\+\_\+count-\/1 for the active table \\
\hline
{\em dw\+\_\+entry\+\_\+value} & On success returns the value in that table entry, an offset into a string table. \\
\hline
{\em dw\+\_\+error} & On error dw\+\_\+error is set to point to the error details. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
DW\+\_\+\+DLV\+\_\+\+OK Returns DW\+\_\+\+DLV\+\_\+\+ERROR if dw\+\_\+index\+\_\+to\+\_\+entry is out of the correct range. 
\end{DoxyReturn}
