<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>rpm: Generalized Iterator API.</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.4 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">rpm <span id="projectnumber">4.8.1</span></div>
</td>
</tr>
</tbody>
</table>
</div>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#define-members">Defines</a> |
<a href="#typedef-members">Typedefs</a> |
<a href="#enum-members">Enumerations</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Generalized Iterator API.</div> </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="define-members"></a>
Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#ga4370a28af3ebc05faed3ad98b9447d26">RPMGI_COMFOLLOW</a>   0x0001</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">rpmgi FTS-flags <a href="#ga4370a28af3ebc05faed3ad98b9447d26"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__rpmgi.html#ga373f508bb7ad8a735c234c156d380c14">rpmgiFlags_e</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#ga688c3ed6d85e55e3780de7d027e04f30">rpmgiFlags</a></td></tr>
<tr><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#ga373f508bb7ad8a735c234c156d380c14">rpmgiFlags_e</a> { <br/>
  <a class="el" href="group__rpmgi.html#gga373f508bb7ad8a735c234c156d380c14a8f0be273feb852cb0149cbbb6bba8d18">RPMGI_NONE</a> = 0,
<a class="el" href="group__rpmgi.html#gga373f508bb7ad8a735c234c156d380c14aec4ec5c6f80bf46c8a6938076ebc5647">RPMGI_TSADD</a> = (1 << 0),
<a class="el" href="group__rpmgi.html#gga373f508bb7ad8a735c234c156d380c14a4198ed415e6bfc7ee5324acfe4e3c956">RPMGI_TSORDER</a> = (1 << 1),
<a class="el" href="group__rpmgi.html#gga373f508bb7ad8a735c234c156d380c14a9b542ecc09717b04f71e99246258adfe">RPMGI_NOGLOB</a> = (1 << 2),
<br/>
  <a class="el" href="group__rpmgi.html#gga373f508bb7ad8a735c234c156d380c14a9181e63b42dc14dd5ffa2add2c4565ef">RPMGI_NOMANIFEST</a> = (1 << 3),
<a class="el" href="group__rpmgi.html#gga373f508bb7ad8a735c234c156d380c14af5ecf420a4d73929d956fa7e538c1492">RPMGI_NOHEADER</a> = (1 << 4)
<br/>
}</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#ga865aed9737d5c285eed0734129cb106f">rpmgiUnlink</a> (<a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> gi, const char *msg)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Unreference a generalized iterator instance. <a href="#ga865aed9737d5c285eed0734129cb106f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#gace1f1e65a68f23b0f7318cbfb3262f43">rpmgiLink</a> (<a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> gi, const char *msg)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Reference a generalized iterator instance. <a href="#gace1f1e65a68f23b0f7318cbfb3262f43"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#ga8ae48841e93140a66648037e1de0c72e">rpmgiFree</a> (<a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> gi)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destroy a generalized iterator. <a href="#ga8ae48841e93140a66648037e1de0c72e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#ga58173561221ac65b4c0831b468d7f956">rpmgiNew</a> (<a class="el" href="group__rpmtypes.html#ga1a512138316a227059ca128597dbd464">rpmts</a> ts, <a class="el" href="group__rpmtag.html#gad0da081a8aa5491edae4ad732d03c2f3">rpmTag</a> tag, const void *keyp, size_t keylen)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return a generalized iterator. <a href="#ga58173561221ac65b4c0831b468d7f956"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__rpmtypes.html#ga06da857c39457bfb6ea9049643fdb706">rpmRC</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#ga40811dde6c14945c407f63aa1eaad940">rpmgiNext</a> (<a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> gi)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Perform next iteration step. <a href="#ga40811dde6c14945c407f63aa1eaad940"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#gac3379f4073b5603d1c5cef745ebf1edb">rpmgiHdrPath</a> (<a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> gi)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return current header path. <a href="#gac3379f4073b5603d1c5cef745ebf1edb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__rpmtypes.html#gacb1ffe4e2d96b8277f9f46ecc0c7b8a6">Header</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#gac418661ff0c54f8a0ed4b20b78dc8588">rpmgiHeader</a> (<a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> gi)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return current iteration header. <a href="#gac418661ff0c54f8a0ed4b20b78dc8588"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__rpmtypes.html#ga1a512138316a227059ca128597dbd464">rpmts</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#gacbf9f852f0ff7b46245693250894f5db">rpmgiTs</a> (<a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> gi)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return current iteration transaction set. <a href="#gacbf9f852f0ff7b46245693250894f5db"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__rpmtypes.html#ga06da857c39457bfb6ea9049643fdb706">rpmRC</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#ga713917dbc171db424793db4751586e8e">rpmgiSetArgs</a> (<a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> gi, <a class="el" href="argv_8h.html#a6c416352f01820f9a95d3d9cc21e93e9">ARGV_const_t</a> argv, int <a class="el" href="rpmcli_8h.html#ac61e4b233ea63d390fb8e8de45cf91fd">ftsOpts</a>, <a class="el" href="group__rpmgi.html#ga688c3ed6d85e55e3780de7d027e04f30">rpmgiFlags</a> flags)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Load iterator args. <a href="#ga713917dbc171db424793db4751586e8e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__rpmgi.html#ga688c3ed6d85e55e3780de7d027e04f30">rpmgiFlags</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#gad339aa93766fdd3326df862aed1b4489">rpmgiGetFlags</a> (<a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> gi)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieve iterator flags. <a href="#gad339aa93766fdd3326df862aed1b4489"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rpmgi.html#ga984f318cf84d27e9a789ff40ee4488cb">rpmgiNumErrors</a> (<a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> gi)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return number of errors (file not found etc) encountered during iteration. <a href="#ga984f318cf84d27e9a789ff40ee4488cb"></a><br/></td></tr>
</table>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="ga4370a28af3ebc05faed3ad98b9447d26"></a><!-- doxytag: member="rpmgi.h::RPMGI_COMFOLLOW" ref="ga4370a28af3ebc05faed3ad98b9447d26" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define RPMGI_COMFOLLOW   0x0001</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>rpmgi FTS-flags </p>
<p>Definition at line <a class="el" href="rpmgi_8h_source.html#l00033">33</a> of file <a class="el" href="rpmgi_8h_source.html">rpmgi.h</a>.</p>
</div>
</div>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="ga688c3ed6d85e55e3780de7d027e04f30"></a><!-- doxytag: member="rpmgi.h::rpmgiFlags" ref="ga688c3ed6d85e55e3780de7d027e04f30" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef enum <a class="el" href="group__rpmgi.html#ga373f508bb7ad8a735c234c156d380c14">rpmgiFlags_e</a> <a class="el" href="group__rpmgi.html#ga688c3ed6d85e55e3780de7d027e04f30">rpmgiFlags</a></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Enumeration Type Documentation</h2>
<a class="anchor" id="ga373f508bb7ad8a735c234c156d380c14"></a><!-- doxytag: member="rpmgi.h::rpmgiFlags_e" ref="ga373f508bb7ad8a735c234c156d380c14" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="group__rpmgi.html#ga373f508bb7ad8a735c234c156d380c14">rpmgiFlags_e</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga373f508bb7ad8a735c234c156d380c14a8f0be273feb852cb0149cbbb6bba8d18"></a><!-- doxytag: member="RPMGI_NONE" ref="gga373f508bb7ad8a735c234c156d380c14a8f0be273feb852cb0149cbbb6bba8d18" args="" -->RPMGI_NONE</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga373f508bb7ad8a735c234c156d380c14aec4ec5c6f80bf46c8a6938076ebc5647"></a><!-- doxytag: member="RPMGI_TSADD" ref="gga373f508bb7ad8a735c234c156d380c14aec4ec5c6f80bf46c8a6938076ebc5647" args="" -->RPMGI_TSADD</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga373f508bb7ad8a735c234c156d380c14a4198ed415e6bfc7ee5324acfe4e3c956"></a><!-- doxytag: member="RPMGI_TSORDER" ref="gga373f508bb7ad8a735c234c156d380c14a4198ed415e6bfc7ee5324acfe4e3c956" args="" -->RPMGI_TSORDER</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga373f508bb7ad8a735c234c156d380c14a9b542ecc09717b04f71e99246258adfe"></a><!-- doxytag: member="RPMGI_NOGLOB" ref="gga373f508bb7ad8a735c234c156d380c14a9b542ecc09717b04f71e99246258adfe" args="" -->RPMGI_NOGLOB</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga373f508bb7ad8a735c234c156d380c14a9181e63b42dc14dd5ffa2add2c4565ef"></a><!-- doxytag: member="RPMGI_NOMANIFEST" ref="gga373f508bb7ad8a735c234c156d380c14a9181e63b42dc14dd5ffa2add2c4565ef" args="" -->RPMGI_NOMANIFEST</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga373f508bb7ad8a735c234c156d380c14af5ecf420a4d73929d956fa7e538c1492"></a><!-- doxytag: member="RPMGI_NOHEADER" ref="gga373f508bb7ad8a735c234c156d380c14af5ecf420a4d73929d956fa7e538c1492" args="" -->RPMGI_NOHEADER</em> </td><td>
</td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="rpmgi_8h_source.html#l00021">21</a> of file <a class="el" href="rpmgi_8h_source.html">rpmgi.h</a>.</p>
</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga8ae48841e93140a66648037e1de0c72e"></a><!-- doxytag: member="rpmgi.h::rpmgiFree" ref="ga8ae48841e93140a66648037e1de0c72e" args="(rpmgi gi)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> rpmgiFree </td>
<td>(</td>
<td class="paramtype"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td>
<td class="paramname"><em>gi</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Destroy a generalized iterator. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">gi</td><td>generalized iterator </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>NULL always </dd></dl>
</div>
</div>
<a class="anchor" id="gad339aa93766fdd3326df862aed1b4489"></a><!-- doxytag: member="rpmgi.h::rpmgiGetFlags" ref="gad339aa93766fdd3326df862aed1b4489" args="(rpmgi gi)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__rpmgi.html#ga688c3ed6d85e55e3780de7d027e04f30">rpmgiFlags</a> rpmgiGetFlags </td>
<td>(</td>
<td class="paramtype"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td>
<td class="paramname"><em>gi</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieve iterator flags. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">gi</td><td>generalized iterator </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>iterator flags </dd></dl>
</div>
</div>
<a class="anchor" id="gac3379f4073b5603d1c5cef745ebf1edb"></a><!-- doxytag: member="rpmgi.h::rpmgiHdrPath" ref="gac3379f4073b5603d1c5cef745ebf1edb" args="(rpmgi gi)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* rpmgiHdrPath </td>
<td>(</td>
<td class="paramtype"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td>
<td class="paramname"><em>gi</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return current header path. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">gi</td><td>generalized iterator </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>header path </dd></dl>
</div>
</div>
<a class="anchor" id="gac418661ff0c54f8a0ed4b20b78dc8588"></a><!-- doxytag: member="rpmgi.h::rpmgiHeader" ref="gac418661ff0c54f8a0ed4b20b78dc8588" args="(rpmgi gi)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__rpmtypes.html#gacb1ffe4e2d96b8277f9f46ecc0c7b8a6">Header</a> rpmgiHeader </td>
<td>(</td>
<td class="paramtype"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td>
<td class="paramname"><em>gi</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return current iteration header. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">gi</td><td>generalized iterator </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>header </dd></dl>
</div>
</div>
<a class="anchor" id="gace1f1e65a68f23b0f7318cbfb3262f43"></a><!-- doxytag: member="rpmgi.h::rpmgiLink" ref="gace1f1e65a68f23b0f7318cbfb3262f43" args="(rpmgi gi, const char *msg)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> rpmgiLink </td>
<td>(</td>
<td class="paramtype"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td>
<td class="paramname"><em>gi</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>msg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Reference a generalized iterator instance. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">gi</td><td>generalized iterator </td></tr>
<tr><td class="paramname">msg</td><td></td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>new generalized iterator reference </dd></dl>
</div>
</div>
<a class="anchor" id="ga58173561221ac65b4c0831b468d7f956"></a><!-- doxytag: member="rpmgi.h::rpmgiNew" ref="ga58173561221ac65b4c0831b468d7f956" args="(rpmts ts, rpmTag tag, const void *keyp, size_t keylen)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> rpmgiNew </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__rpmtypes.html#ga1a512138316a227059ca128597dbd464">rpmts</a> </td>
<td class="paramname"><em>ts</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__rpmtag.html#gad0da081a8aa5491edae4ad732d03c2f3">rpmTag</a> </td>
<td class="paramname"><em>tag</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void * </td>
<td class="paramname"><em>keyp</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"><em>keylen</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return a generalized iterator. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">ts</td><td>transaction set </td></tr>
<tr><td class="paramname">tag</td><td>rpm tag </td></tr>
<tr><td class="paramname">keyp</td><td>key data (NULL for sequential access) </td></tr>
<tr><td class="paramname">keylen</td><td>key data length (0 will use strlen(keyp)) </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>new iterator </dd></dl>
</div>
</div>
<a class="anchor" id="ga40811dde6c14945c407f63aa1eaad940"></a><!-- doxytag: member="rpmgi.h::rpmgiNext" ref="ga40811dde6c14945c407f63aa1eaad940" args="(rpmgi gi)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__rpmtypes.html#ga06da857c39457bfb6ea9049643fdb706">rpmRC</a> rpmgiNext </td>
<td>(</td>
<td class="paramtype"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td>
<td class="paramname"><em>gi</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Perform next iteration step. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">gi</td><td>generalized iterator </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>RPMRC_OK on success, RPMRC_NOTFOUND on EOI </dd></dl>
</div>
</div>
<a class="anchor" id="ga984f318cf84d27e9a789ff40ee4488cb"></a><!-- doxytag: member="rpmgi.h::rpmgiNumErrors" ref="ga984f318cf84d27e9a789ff40ee4488cb" args="(rpmgi gi)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int rpmgiNumErrors </td>
<td>(</td>
<td class="paramtype"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td>
<td class="paramname"><em>gi</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return number of errors (file not found etc) encountered during iteration. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">gi</td><td>generalized iterator </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>number of errors </dd></dl>
</div>
</div>
<a class="anchor" id="ga713917dbc171db424793db4751586e8e"></a><!-- doxytag: member="rpmgi.h::rpmgiSetArgs" ref="ga713917dbc171db424793db4751586e8e" args="(rpmgi gi, ARGV_const_t argv, int ftsOpts, rpmgiFlags flags)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__rpmtypes.html#ga06da857c39457bfb6ea9049643fdb706">rpmRC</a> rpmgiSetArgs </td>
<td>(</td>
<td class="paramtype"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td>
<td class="paramname"><em>gi</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="argv_8h.html#a6c416352f01820f9a95d3d9cc21e93e9">ARGV_const_t</a> </td>
<td class="paramname"><em>argv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>ftsOpts</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__rpmgi.html#ga688c3ed6d85e55e3780de7d027e04f30">rpmgiFlags</a> </td>
<td class="paramname"><em>flags</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Load iterator args. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">gi</td><td>generalized iterator </td></tr>
<tr><td class="paramname">argv</td><td>arg list </td></tr>
<tr><td class="paramname">ftsOpts</td><td>fts(3) flags </td></tr>
<tr><td class="paramname">flags</td><td>iterator flags </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>RPMRC_OK on success </dd></dl>
</div>
</div>
<a class="anchor" id="gacbf9f852f0ff7b46245693250894f5db"></a><!-- doxytag: member="rpmgi.h::rpmgiTs" ref="gacbf9f852f0ff7b46245693250894f5db" args="(rpmgi gi)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__rpmtypes.html#ga1a512138316a227059ca128597dbd464">rpmts</a> rpmgiTs </td>
<td>(</td>
<td class="paramtype"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td>
<td class="paramname"><em>gi</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return current iteration transaction set. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">gi</td><td>generalized iterator </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>transaction set </dd></dl>
</div>
</div>
<a class="anchor" id="ga865aed9737d5c285eed0734129cb106f"></a><!-- doxytag: member="rpmgi.h::rpmgiUnlink" ref="ga865aed9737d5c285eed0734129cb106f" args="(rpmgi gi, const char *msg)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> rpmgiUnlink </td>
<td>(</td>
<td class="paramtype"><a class="el" href="rpmtypes_8h.html#a5f95c4ae1831f5944548432fdd9b3119">rpmgi</a> </td>
<td class="paramname"><em>gi</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>msg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Unreference a generalized iterator instance. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">gi</td><td>generalized iterator </td></tr>
<tr><td class="paramname">msg</td><td></td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>NULL always </dd></dl>
</div>
</div>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Mon Oct 15 2012 for rpm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.4 </small></address>
</body>
</html>