\hypertarget{group__drmaa__viter}{\subsection{Vector iteration functions.}
\label{group__drmaa__viter}\index{Vector iteration functions.@{Vector iteration functions.}}
}


The drmaa\-\_\-get\-\_\-next\-\_\-{\itshape X}() functions S\-H\-A\-L\-L store up to {\itshape value\-\_\-len} bytes of the next attribute name / attribute value / job identifier from the {\itshape values} opaque string vector in the {\itshape value} buffer.  


Collaboration diagram for Vector iteration functions.\-:
\nopagebreak
\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=342pt]{group__drmaa__viter}
\end{center}
\end{figure}
The drmaa\-\_\-get\-\_\-next\-\_\-{\itshape X}() functions S\-H\-A\-L\-L store up to {\itshape value\-\_\-len} bytes of the next attribute name / attribute value / job identifier from the {\itshape values} opaque string vector in the {\itshape value} buffer. The opaque string vector's internal iterator S\-H\-A\-L\-L then be moved forward to the next entry. If there are no more values those functions return D\-R\-M\-A\-A\-\_\-\-E\-R\-R\-N\-O\-\_\-\-I\-N\-V\-A\-L\-I\-D\-\_\-\-A\-R\-G\-U\-M\-E\-N\-T (but this is outside D\-R\-M\-A\-A specification).

The drmaa\-\_\-get\-\_\-num\-\_\-{\itshape X}() functions S\-H\-A\-L\-L store the number of elements in the space provided by {\itshape size}.

The drmaa\-\_\-release\-\_\-{\itshape X}() functions free the memory used by the {\itshape values} opaque string vector. All memory used by strings contained therein is also freed.