blob: 691c1d091b14c26f528070be292328840c4da27f [file] [log] [blame]
<!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"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Apache Singa: singa::io::BinFileReader Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">Apache Singa
</div>
<div id="projectbrief">A General Distributed Deep Learning Library</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespacesinga.html">singa</a></li><li class="navelem"><b>io</b></li><li class="navelem"><a class="el" href="classsinga_1_1io_1_1BinFileReader.html">BinFileReader</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> &#124;
<a href="#pro-methods">Protected Member Functions</a> &#124;
<a href="classsinga_1_1io_1_1BinFileReader-members.html">List of all members</a> </div>
<div class="headertitle">
<div class="title">singa::io::BinFileReader Class Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>Binfilereader reads tuples from binary file with key-value pairs.
<a href="classsinga_1_1io_1_1BinFileReader.html#details">More...</a></p>
<p><code>#include &lt;<a class="el" href="reader_8h_source.html">reader.h</a>&gt;</code></p>
<div class="dynheader">
Inheritance diagram for singa::io::BinFileReader:</div>
<div class="dyncontent">
<div class="center"><img src="classsinga_1_1io_1_1BinFileReader__inherit__graph.png" border="0" usemap="#singa_1_1io_1_1BinFileReader_inherit__map" alt="Inheritance graph"/></div>
<!-- MAP 0 -->
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<div class="dynheader">
Collaboration diagram for singa::io::BinFileReader:</div>
<div class="dyncontent">
<div class="center"><img src="classsinga_1_1io_1_1BinFileReader__coll__graph.png" border="0" usemap="#singa_1_1io_1_1BinFileReader_coll__map" alt="Collaboration graph"/></div>
<!-- MAP 1 -->
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr class="memitem:a34cc1d57cb53922dd954f2380ff2e137"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classsinga_1_1io_1_1BinFileReader.html#a34cc1d57cb53922dd954f2380ff2e137">Open</a> (const std::string &amp;<a class="el" href="classsinga_1_1io_1_1BinFileReader.html#a85039856483c4e16b9ca12cdec7d8bca">path</a>) override</td></tr>
<tr class="separator:a34cc1d57cb53922dd954f2380ff2e137"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a691d7057b51baf2ed369bd76828770b1"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classsinga_1_1io_1_1BinFileReader.html#a691d7057b51baf2ed369bd76828770b1">Open</a> (const std::string &amp;<a class="el" href="classsinga_1_1io_1_1BinFileReader.html#a85039856483c4e16b9ca12cdec7d8bca">path</a>, int capacity)</td></tr>
<tr class="memdesc:a691d7057b51baf2ed369bd76828770b1"><td class="mdescLeft">&#160;</td><td class="mdescRight">user defines capacity <a href="#a691d7057b51baf2ed369bd76828770b1">More...</a><br /></td></tr>
<tr class="separator:a691d7057b51baf2ed369bd76828770b1"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ad975e2276d82173a59021f353dbadf68"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classsinga_1_1io_1_1BinFileReader.html#ad975e2276d82173a59021f353dbadf68">Close</a> () override</td></tr>
<tr class="separator:ad975e2276d82173a59021f353dbadf68"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a956414a417964de2a8f8248ea8ba1e0c"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classsinga_1_1io_1_1BinFileReader.html#a956414a417964de2a8f8248ea8ba1e0c">Read</a> (std::string *key, std::string *value) override</td></tr>
<tr class="separator:a956414a417964de2a8f8248ea8ba1e0c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a5cd9ba4198573517cdddf1670b28f1f6"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classsinga_1_1io_1_1BinFileReader.html#a5cd9ba4198573517cdddf1670b28f1f6">Count</a> () override</td></tr>
<tr class="separator:a5cd9ba4198573517cdddf1670b28f1f6"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ae73a7c0aed3d2667ff83176c7dc3539c"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classsinga_1_1io_1_1BinFileReader.html#ae73a7c0aed3d2667ff83176c7dc3539c">SeekToFirst</a> () override</td></tr>
<tr class="separator:ae73a7c0aed3d2667ff83176c7dc3539c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a85039856483c4e16b9ca12cdec7d8bca"><td class="memItemLeft" align="right" valign="top"><a id="a85039856483c4e16b9ca12cdec7d8bca"></a>
std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classsinga_1_1io_1_1BinFileReader.html#a85039856483c4e16b9ca12cdec7d8bca">path</a> ()</td></tr>
<tr class="memdesc:a85039856483c4e16b9ca12cdec7d8bca"><td class="mdescLeft">&#160;</td><td class="mdescRight">return path to binary file <br /></td></tr>
<tr class="separator:a85039856483c4e16b9ca12cdec7d8bca"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="inherit_header pub_methods_classsinga_1_1io_1_1Reader"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_classsinga_1_1io_1_1Reader')"><img src="closed.png" alt="-"/>&#160;Public Member Functions inherited from <a class="el" href="classsinga_1_1io_1_1Reader.html">singa::io::Reader</a></td></tr>
<tr class="memitem:a151239317e76d0db47e5e6d01ed5fca3 inherit pub_methods_classsinga_1_1io_1_1Reader"><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classsinga_1_1io_1_1Reader.html#a151239317e76d0db47e5e6d01ed5fca3">~Reader</a> ()</td></tr>
<tr class="memdesc:a151239317e76d0db47e5e6d01ed5fca3 inherit pub_methods_classsinga_1_1io_1_1Reader"><td class="mdescLeft">&#160;</td><td class="mdescRight">In case that users forget to call <a class="el" href="classsinga_1_1io_1_1Reader.html#ae9a44a2b4ae832493c04d9b540ef29e1" title="Release resources. ">Close()</a> to release resources, e.g., memory, you can release them here. <a href="classsinga_1_1io_1_1Reader.html#a151239317e76d0db47e5e6d01ed5fca3">More...</a><br /></td></tr>
<tr class="separator:a151239317e76d0db47e5e6d01ed5fca3 inherit pub_methods_classsinga_1_1io_1_1Reader"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr class="memitem:a55f03ebea25867f36b8e6a61597246eb"><td class="memItemLeft" align="right" valign="top"><a id="a55f03ebea25867f36b8e6a61597246eb"></a>
bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classsinga_1_1io_1_1BinFileReader.html#a55f03ebea25867f36b8e6a61597246eb">OpenFile</a> ()</td></tr>
<tr class="memdesc:a55f03ebea25867f36b8e6a61597246eb"><td class="mdescLeft">&#160;</td><td class="mdescRight">Open a file with path_ and initialize buf_. <br /></td></tr>
<tr class="separator:a55f03ebea25867f36b8e6a61597246eb"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:afb5a302a0633012c0e7a52514e8cfff0"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classsinga_1_1io_1_1BinFileReader.html#afb5a302a0633012c0e7a52514e8cfff0">ReadField</a> (std::string *content)</td></tr>
<tr class="memdesc:afb5a302a0633012c0e7a52514e8cfff0"><td class="mdescLeft">&#160;</td><td class="mdescRight">Read the next filed, including content_len and content; return true if succeed. <a href="#afb5a302a0633012c0e7a52514e8cfff0">More...</a><br /></td></tr>
<tr class="separator:afb5a302a0633012c0e7a52514e8cfff0"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac08f91372fb5ede0837fe59925f531d1"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classsinga_1_1io_1_1BinFileReader.html#ac08f91372fb5ede0837fe59925f531d1">PrepareNextField</a> (int size)</td></tr>
<tr class="memdesc:ac08f91372fb5ede0837fe59925f531d1"><td class="mdescLeft">&#160;</td><td class="mdescRight">Read data from disk if the current data in the buffer is not a full field. <a href="#ac08f91372fb5ede0837fe59925f531d1">More...</a><br /></td></tr>
<tr class="separator:ac08f91372fb5ede0837fe59925f531d1"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>Binfilereader reads tuples from binary file with key-value pairs. </p>
</div><h2 class="groupheader">Member Function Documentation</h2>
<a id="ad975e2276d82173a59021f353dbadf68"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ad975e2276d82173a59021f353dbadf68">&#9670;&nbsp;</a></span>Close()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">void singa::io::BinFileReader::Close </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">override</span><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p></p>
<p>Implements <a class="el" href="classsinga_1_1io_1_1Reader.html#ae9a44a2b4ae832493c04d9b540ef29e1">singa::io::Reader</a>.</p>
</div>
</div>
<a id="a5cd9ba4198573517cdddf1670b28f1f6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a5cd9ba4198573517cdddf1670b28f1f6">&#9670;&nbsp;</a></span>Count()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">int singa::io::BinFileReader::Count </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">override</span><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p></p>
<p>Implements <a class="el" href="classsinga_1_1io_1_1Reader.html#a860fade6259818e89887aac059bb6277">singa::io::Reader</a>.</p>
</div>
</div>
<a id="a34cc1d57cb53922dd954f2380ff2e137"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a34cc1d57cb53922dd954f2380ff2e137">&#9670;&nbsp;</a></span>Open() <span class="overload">[1/2]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">bool singa::io::BinFileReader::Open </td>
<td>(</td>
<td class="paramtype">const std::string &amp;&#160;</td>
<td class="paramname"><em>path</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">override</span><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p></p>
<p>Implements <a class="el" href="classsinga_1_1io_1_1Reader.html#a6894610ce2560dbe7641fdf5a3abf909">singa::io::Reader</a>.</p>
</div>
</div>
<a id="a691d7057b51baf2ed369bd76828770b1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a691d7057b51baf2ed369bd76828770b1">&#9670;&nbsp;</a></span>Open() <span class="overload">[2/2]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool singa::io::BinFileReader::Open </td>
<td>(</td>
<td class="paramtype">const std::string &amp;&#160;</td>
<td class="paramname"><em>path</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>capacity</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>user defines capacity </p>
<p>user defines capacity </p>
</div>
</div>
<a id="ac08f91372fb5ede0837fe59925f531d1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ac08f91372fb5ede0837fe59925f531d1">&#9670;&nbsp;</a></span>PrepareNextField()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">bool singa::io::BinFileReader::PrepareNextField </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>size</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">protected</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Read data from disk if the current data in the buffer is not a full field. </p>
<p>size is the size of the next field. </p>
</div>
</div>
<a id="a956414a417964de2a8f8248ea8ba1e0c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a956414a417964de2a8f8248ea8ba1e0c">&#9670;&nbsp;</a></span>Read()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">bool singa::io::BinFileReader::Read </td>
<td>(</td>
<td class="paramtype">std::string *&#160;</td>
<td class="paramname"><em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">std::string *&#160;</td>
<td class="paramname"><em>value</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">override</span><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p></p>
<p>Implements <a class="el" href="classsinga_1_1io_1_1Reader.html#a8d45ee8b877e4344d776265af16e0c4b">singa::io::Reader</a>.</p>
</div>
</div>
<a id="afb5a302a0633012c0e7a52514e8cfff0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#afb5a302a0633012c0e7a52514e8cfff0">&#9670;&nbsp;</a></span>ReadField()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">bool singa::io::BinFileReader::ReadField </td>
<td>(</td>
<td class="paramtype">std::string *&#160;</td>
<td class="paramname"><em>content</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">protected</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Read the next filed, including content_len and content; return true if succeed. </p>
</div>
</div>
<a id="ae73a7c0aed3d2667ff83176c7dc3539c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ae73a7c0aed3d2667ff83176c7dc3539c">&#9670;&nbsp;</a></span>SeekToFirst()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">void singa::io::BinFileReader::SeekToFirst </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">override</span><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p></p>
<p>Implements <a class="el" href="classsinga_1_1io_1_1Reader.html#a82bb5bcb71d5abc58ffad4b698eb4965">singa::io::Reader</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>/home/moaz/incubator-singa/include/singa/io/<a class="el" href="reader_8h_source.html">reader.h</a></li>
</ul>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Mon Apr 22 2019 12:27:05 for Apache Singa by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.13
</small></address>
</body>
</html>