Files
hdf5/doc/html/cpplus_RM/classH5_1_1DataSet.html
Frank Baker c17fb6fa1d [svn-r9028]
Purpose:
    Adding C++ Reference Manual to 1.6 release branch.
    This manual is automatically generated
    by doxygen from the C++ source code.
Platforms tested:
    Mozilla, Safari, IE 5
2004-08-05 16:22:19 -05:00

1530 lines
64 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html xmlns:v="urn:schemas-microsoft-com:vml"
xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:w="urn:schemas-microsoft-com:office:word"
xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv=Content-Type content="text/html; charset=iso-8859-1">
<meta name=ProgId content=Word.Document>
<meta name=Generator content="Microsoft Word 10">
<meta name=Originator content="Microsoft Word 10">
<link rel=File-List href="header_files/filelist.xml">
<link rel=Edit-Time-Data href="header_files/editdata.mso">
<!--[if !mso]>
<style>
v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style>
<![endif]-->
<title>Main Page</title>
<!--[if gte mso 9]><xml>
<o:DocumentProperties>
<o:Author>Randy Ribler</o:Author>
<o:Template>Normal</o:Template>
<o:LastAuthor>Randy Ribler</o:LastAuthor>
<o:Revision>6</o:Revision>
<o:TotalTime>16</o:TotalTime>
<o:Created>2004-07-23T05:34:00Z</o:Created>
<o:LastSaved>2004-07-23T06:03:00Z</o:LastSaved>
<o:Pages>1</o:Pages>
<o:Words>5</o:Words>
<o:Characters>32</o:Characters>
<o:Company>LC</o:Company>
<o:Lines>1</o:Lines>
<o:Paragraphs>1</o:Paragraphs>
<o:CharactersWithSpaces>36</o:CharactersWithSpaces>
<o:Version>10.2625</o:Version>
</o:DocumentProperties>
</xml><![endif]--><!--[if gte mso 9]><xml>
<w:WordDocument>
<w:SpellingState>Clean</w:SpellingState>
<w:GrammarState>Clean</w:GrammarState>
<w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
</w:WordDocument>
</xml><![endif]-->
<link rel=Stylesheet type="text/css" media=all href=doxygen.css>
<style>
<!--
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{mso-style-parent:"";
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";
mso-believe-normal-left:yes;}
h1
{mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
text-align:center;
mso-pagination:widow-orphan;
mso-outline-level:1;
font-size:24.0pt;
font-family:"Times New Roman";
font-weight:bold;}
h2
{mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
mso-pagination:widow-orphan;
mso-outline-level:2;
font-size:18.0pt;
font-family:"Times New Roman";
font-weight:bold;}
a:link, span.MsoHyperlink
{color:#252E78;
text-decoration:underline;
text-underline:single;}
a:visited, span.MsoHyperlinkFollowed
{color:#3D2185;
text-decoration:underline;
text-underline:single;}
p
{mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
address
{margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
font-style:italic;}
pre
{margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;
font-size:10.0pt;
font-family:"Courier New";
mso-fareast-font-family:"Times New Roman";}
p.formuladsp, li.formuladsp, div.formuladsp
{mso-style-name:formuladsp;
mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
text-align:center;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.mdtable, li.mdtable, div.mdtable
{mso-style-name:mdtable;
mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
mso-pagination:widow-orphan;
background:#F4F4FB;
border:none;
mso-border-alt:solid #868686 .75pt;
padding:0in;
mso-padding-alt:0in 0in 0in 0in;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.mdrow, li.mdrow, div.mdrow
{mso-style-name:mdrow;
mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.mdescleft, li.mdescleft, div.mdescleft
{mso-style-name:mdescleft;
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
background:#FAFAFA;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";
font-style:italic;}
p.mdescright, li.mdescright, div.mdescright
{mso-style-name:mdescright;
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
background:#FAFAFA;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";
font-style:italic;}
p.memitemleft, li.memitemleft, div.memitemleft
{mso-style-name:memitemleft;
margin:3.0pt;
mso-pagination:widow-orphan;
background:#FAFAFA;
border:none;
mso-border-top-alt:solid #E0E0E0 .75pt;
padding:0in;
mso-padding-alt:1.0pt 0in 0in 0in;
font-size:9.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.memitemright, li.memitemright, div.memitemright
{mso-style-name:memitemright;
margin:3.0pt;
mso-pagination:widow-orphan;
background:#FAFAFA;
border:none;
mso-border-top-alt:solid #E0E0E0 .75pt;
padding:0in;
mso-padding-alt:1.0pt 0in 0in 0in;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.search, li.search, div.search
{mso-style-name:search;
mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";
font-weight:bold;}
@page Section1
{size:8.5in 11.0in;
margin:1.0in 1.25in 1.0in 1.25in;
mso-header-margin:.5in;
mso-footer-margin:.5in;
mso-paper-source:0;}
div.Section1
{page:Section1;}
-->
</style>
<!--[if gte mso 10]>
<style>
/* Style Definitions */
table.MsoNormalTable
{mso-style-name:"Table Normal";
mso-tstyle-rowband-size:0;
mso-tstyle-colband-size:0;
mso-style-noshow:yes;
mso-style-parent:"";
mso-padding-alt:0in 5.4pt 0in 5.4pt;
mso-para-margin:0in;
mso-para-margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";}
table.MsoTableGrid
{mso-style-name:"Table Grid";
mso-tstyle-rowband-size:0;
mso-tstyle-colband-size:0;
border:solid windowtext 1.0pt;
mso-border-alt:solid windowtext .5pt;
mso-padding-alt:0in 5.4pt 0in 5.4pt;
mso-border-insideh:.5pt solid windowtext;
mso-border-insidev:.5pt solid windowtext;
mso-para-margin:0in;
mso-para-margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";}
</style>
<![endif]--><![if mso 9]>
<style>
p.MsoNormal
{margin-left:15.0pt;}
</style>
<![endif]><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="4098">
<o:colormru v:ext="edit" colors="#060"/>
<o:colormenu v:ext="edit" strokecolor="#060"/>
</o:shapedefaults></xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1"/>
</o:shapelayout></xml><![endif]-->
</head>
<body bgcolor=white lang=EN-US link="#252E78" vlink="#3D2185" style='tab-interval:
.5in;margin-left:15.0pt;margin-right:15.0pt'>
<div class=Section1>
<p class=MsoNormal style='margin-top:0in;margin-right:15.0pt;margin-bottom:
0in;margin-left:15.0pt;margin-bottom:.0001pt'><!--[if gte vml 1]><v:shapetype
id="_x0000_t75" coordsize="21600,21600" o:spt="75" o:preferrelative="t"
path="m@4@5l@4@11@9@11@9@5xe" filled="f" stroked="f">
<v:stroke joinstyle="miter"/>
<v:formulas>
<v:f eqn="if lineDrawn pixelLineWidth 0"/>
<v:f eqn="sum @0 1 0"/>
<v:f eqn="sum 0 0 @1"/>
<v:f eqn="prod @2 1 2"/>
<v:f eqn="prod @3 21600 pixelWidth"/>
<v:f eqn="prod @3 21600 pixelHeight"/>
<v:f eqn="sum @0 0 1"/>
<v:f eqn="prod @6 1 2"/>
<v:f eqn="prod @7 21600 pixelWidth"/>
<v:f eqn="sum @8 21600 0"/>
<v:f eqn="prod @7 21600 pixelHeight"/>
<v:f eqn="sum @10 21600 0"/>
</v:formulas>
<v:path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect"/>
<o:lock v:ext="edit" aspectratio="t"/>
</v:shapetype><v:shape id="_x0000_s1026" type="#_x0000_t75" style='position:absolute;
left:0;text-align:left;margin-left:30pt;margin-top:9pt;width:72.75pt;height:57.75pt;
z-index:1'>
<v:imagedata src="header_files/image001.jpg" o:title="NCSAlogo"/>
</v:shape><![endif]--><![if !vml]><span style='mso-ignore:vglayout;position:
absolute;z-index:1;left:0px;margin-left:40px;margin-top:12px;width:97px;
height:77px'><img width=97 height=77 src="header_files/image002.jpg" v:shapes="_x0000_s1026"></span><![endif]><span
style='mso-spacerun:yes'> </span><b style='mso-bidi-font-weight:normal'><span
style='font-size:22.0pt'><o:p></o:p></span></b></p>
<div align=center>
<table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
style='margin-left:103.45pt;border-collapse:collapse;border:none;mso-border-bottom-alt:
solid #006600 2.25pt;mso-yfti-tbllook:480;mso-padding-alt:0in 5.4pt 0in 5.4pt'>
<tr style='mso-yfti-irow:0;mso-yfti-lastrow:yes;height:29.25pt'>
<td width=443 valign=top style='width:332.6pt;border:none;border-bottom:solid #006600 2.25pt;
padding:0in 5.4pt 0in 5.4pt;height:29.25pt'>
<p class=MsoNormal><b style='mso-bidi-font-weight:normal'><span
style='font-size:22.0pt'>HDF5 C++ API Reference Manual</span></b></p>
</td>
</tr>
</table>
</div>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
</div>
</body>
</html>
<!-- Generated by Doxygen 1.3.7-20040718 -->
<div class="qindex"><a class="qindex" href="index.html">Main&nbsp;Page</a> | <a class="qindex" href="namespaces.html">Namespace List</a> | <a class="qindex" href="hierarchy.html">Class&nbsp;Hierarchy</a> | <a class="qindex" href="annotated.html">Class&nbsp;List</a> | <a class="qindex" href="files.html">File&nbsp;List</a> | <a class="qindex" href="functions.html">Class&nbsp;Members</a> | <a class="qindex" href="examples.html">Examples</a></div>
<h1>H5::DataSet Class Reference</h1><code>#include &lt;<a class="el" href="H5DataSet_8h-source.html">H5DataSet.h</a>&gt;</code>
<p>
<p>Inheritance diagram for H5::DataSet:
<p><center><img src="classH5_1_1DataSet.png" usemap="#H5::DataSet_map" border="0" alt=""></center>
<map name="H5::DataSet_map">
<area href="classH5_1_1AbstractDs.html" alt="H5::AbstractDs" shape="rect" coords="0,112,107,136">
<area href="classH5_1_1H5Object.html" alt="H5::H5Object" shape="rect" coords="0,56,107,80">
<area href="classH5_1_1IdComponent.html" alt="H5::IdComponent" shape="rect" coords="0,0,107,24">
</map>
<a href="classH5_1_1DataSet-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
<tr><td></td></tr>
<tr><td colspan=2><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a0">extend</a> (const hsize_t *size) const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Extends a dataset with unlimited dimension. <a href="#a0"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a1">fillMemBuf</a> (const void *fill, <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;fill_type, void *buf, <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;buf_type, <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;space)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Fills a selection in memory with a value. <a href="#a1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a2">fillMemBuf</a> (void *buf, <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;buf_type, <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;space)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">This is an overloaded member function, provided for convenience. It differs from the above function in that it only takes the the last three arguments. <a href="#a2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="classH5_1_1DSetCreatPropList.html">DSetCreatPropList</a>&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a3">getCreatePlist</a> () const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Gets the dataset creation property list. <a href="#a3"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>haddr_t&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a4">getOffset</a> () const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the address of this dataset in the file. <a href="#a4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>virtual <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a>&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a5">getSpace</a> () const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Gets a copy of the dataspace of this dataset. <a href="#a5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a6">getSpaceStatus</a> (H5D_space_status_t &amp;status) const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Determines whether space has been allocated for a dataset. <a href="#a6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>hsize_t&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a7">getStorageSize</a> () const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the amount of storage required for a dataset. <a href="#a7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>hsize_t&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a8">getVlenBufSize</a> (<a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;type, <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;space) const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the number of bytes required to store VL data. <a href="#a8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a9">vlenReclaim</a> (<a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;type, <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;space, <a class="el" href="classH5_1_1DSetMemXferPropList.html">DSetMemXferPropList</a> &amp;xfer_plist, void *buf) const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Reclaims VL datatype memory buffers. <a href="#a9"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a10">read</a> (void *buf, const <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;mem_type, const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;mem_space=<a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a>, const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;file_space=<a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a>, const <a class="el" href="classH5_1_1DSetMemXferPropList.html">DSetMemXferPropList</a> &amp;xfer_plist=<a class="el" href="classH5_1_1DSetMemXferPropList.html#s0">DSetMemXferPropList::DEFAULT</a>) const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Reads raw data from the specified dataset. <a href="#a10"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a11">read</a> (string &amp;buf, const <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;mem_type, const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;mem_space=<a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a>, const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;file_space=<a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a>, const <a class="el" href="classH5_1_1DSetMemXferPropList.html">DSetMemXferPropList</a> &amp;xfer_plist=<a class="el" href="classH5_1_1DSetMemXferPropList.html#s0">DSetMemXferPropList::DEFAULT</a>) const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">This is an overloaded member function, provided for convenience. It takes a reference to a <code>std::string</code> for the buffer. <a href="#a11"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a12">write</a> (const void *buf, const <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;mem_type, const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;mem_space=<a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a>, const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;file_space=<a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a>, const <a class="el" href="classH5_1_1DSetMemXferPropList.html">DSetMemXferPropList</a> &amp;xfer_plist=<a class="el" href="classH5_1_1DSetMemXferPropList.html#s0">DSetMemXferPropList::DEFAULT</a>) const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Writes raw data from an application buffer to a dataset. <a href="#a12"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a13">write</a> (const string &amp;buf, const <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;mem_type, const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;mem_space=<a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a>, const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;file_space=<a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a>, const <a class="el" href="classH5_1_1DSetMemXferPropList.html">DSetMemXferPropList</a> &amp;xfer_plist=<a class="el" href="classH5_1_1DSetMemXferPropList.html#s0">DSetMemXferPropList::DEFAULT</a>) const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">This is an overloaded member function, provided for convenience. It takes a reference to a <code>std::string</code> for the buffer. <a href="#a13"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a14">iterateElems</a> (void *buf, const <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;type, const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;space, H5D_operator_t op, void *op_data=NULL)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Iterates over all selected elements in a dataspace. <a href="#a14"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>H5G_obj_t&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a15">getObjType</a> (void *ref, H5R_type_t ref_type) const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Retrieves the type of object that an object reference points to. <a href="#a15"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="classH5_1_1DataSpace.html">DataSpace</a>&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a16">getRegion</a> (void *ref, H5R_type_t ref_type=H5R_DATASET_REGION) const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Retrieves a dataspace with the region pointed to selected. <a href="#a16"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a17">Reference</a> (const char *name, <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;dataspace, H5R_type_t ref_type=H5R_DATASET_REGION) const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Creates a reference to an HDF5 object or a dataset region. <a href="#a17"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a18">Reference</a> (const char *name) const</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">This is an overloaded function, provided for your convenience. It differs from the above function in that it only creates a reference to an HDF5 object, not to a dataset region. <a href="#a18"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a19">DataSet</a> (const hid_t existing_id)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Creates an <a class="el" href="classH5_1_1DataSet.html">DataSet</a> object using the id of an existing dataset. <a href="#a19"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a20">DataSet</a> ()</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Default constructor: creates a stub <a class="el" href="classH5_1_1DataSet.html">DataSet</a>. <a href="#a20"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a21">DataSet</a> (const <a class="el" href="classH5_1_1DataSet.html">DataSet</a> &amp;original)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Copy constructor: makes a copy of the original <a class="el" href="classH5_1_1DataSet.html">DataSet</a> object. <a href="#a21"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>virtual&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="classH5_1_1DataSet.html#a22">~DataSet</a> ()</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Properly terminates access to this dataset. <a href="#a22"></a><br></td></tr>
</table>
<hr><h2>Constructor &amp; Destructor Documentation</h2>
<a class="anchor" name="a19" doxytag="H5::DataSet::DataSet" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> H5::DataSet::DataSet </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const hid_t&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>existing_id</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Creates an <a class="el" href="classH5_1_1DataSet.html">DataSet</a> object using the id of an existing dataset.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>existing_id</em>&nbsp;</td><td>- IN: Id of an existing dataset </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a20" doxytag="H5::DataSet::DataSet" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> H5::DataSet::DataSet </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Default constructor: creates a stub <a class="el" href="classH5_1_1DataSet.html">DataSet</a>.
<p>
</td>
</tr>
</table>
<a class="anchor" name="a21" doxytag="H5::DataSet::DataSet" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> H5::DataSet::DataSet </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const <a class="el" href="classH5_1_1DataSet.html">DataSet</a> &amp;&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>original</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Copy constructor: makes a copy of the original <a class="el" href="classH5_1_1DataSet.html">DataSet</a> object.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>original</em>&nbsp;</td><td>- IN: <a class="el" href="classH5_1_1DataSet.html">DataSet</a> instance to copy </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a22" doxytag="H5::DataSet::~DataSet" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> H5::DataSet::~<a class="el" href="classH5_1_1DataSet.html">DataSet</a> </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Properly terminates access to this dataset.
<p>
</td>
</tr>
</table>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="a0" doxytag="H5::DataSet::extend" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void H5::DataSet::extend </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const hsize_t *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>size</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Extends a dataset with unlimited dimension.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>size</em>&nbsp;</td><td>- IN: Array containing the new magnitude of each dimension </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
<dl compact><dt><b>Description</b></dt><dd>For more information, please see the Description section in C layer Reference Manual at: http: </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a1" doxytag="H5::DataSet::fillMemBuf" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void H5::DataSet::fillMemBuf </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const void *&nbsp;</td>
<td class="mdname" nowrap> <em>fill</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap><a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>fill_type</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>void *&nbsp;</td>
<td class="mdname" nowrap> <em>buf</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap><a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>buf_type</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap><a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>space</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Fills a selection in memory with a value.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>fill</em>&nbsp;</td><td>- IN: Pointer to fill value to use - default NULL </td></tr>
<tr><td></td><td valign=top><em>fill_type</em>&nbsp;</td><td>- IN: Datatype of the fill value </td></tr>
<tr><td></td><td valign=top><em>buf</em>&nbsp;</td><td>- IN/OUT: Memory buffer to fill selection within </td></tr>
<tr><td></td><td valign=top><em>buf_type</em>&nbsp;</td><td>- IN: Datatype of the elements in buffer </td></tr>
<tr><td></td><td valign=top><em>space</em>&nbsp;</td><td>- IN: Dataspace describing memory buffer &amp; containing selection to use </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a2" doxytag="H5::DataSet::fillMemBuf" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void H5::DataSet::fillMemBuf </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">void *&nbsp;</td>
<td class="mdname" nowrap> <em>buf</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap><a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>buf_type</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap><a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>space</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
This is an overloaded member function, provided for convenience. It differs from the above function in that it only takes the the last three arguments.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>buf</em>&nbsp;</td><td>- IN/OUT: Memory buffer to fill selection within </td></tr>
<tr><td></td><td valign=top><em>buf_type</em>&nbsp;</td><td>- IN: Datatype of the elements in buffer </td></tr>
<tr><td></td><td valign=top><em>space</em>&nbsp;</td><td>- IN: Dataspace describing memory buffer &amp; containing selection to use </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a3" doxytag="H5::DataSet::getCreatePlist" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="classH5_1_1DSetCreatPropList.html">DSetCreatPropList</a> H5::DataSet::getCreatePlist </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Gets the dataset creation property list.
<p>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="classH5_1_1DSetCreatPropList.html">DSetCreatPropList</a> instance </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a4" doxytag="H5::DataSet::getOffset" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> haddr_t H5::DataSet::getOffset </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns the address of this dataset in the file.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>Address of dataset </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a5" doxytag="H5::DataSet::getSpace" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> H5::DataSet::getSpace </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const<code> [virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Gets a copy of the dataspace of this dataset.
<p>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> instance </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
<p>
Implements <a class="el" href="classH5_1_1AbstractDs.html#a6">H5::AbstractDs</a>.
<p>
</td>
</tr>
</table>
<a class="anchor" name="a6" doxytag="H5::DataSet::getSpaceStatus" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void H5::DataSet::getSpaceStatus </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">H5D_space_status_t &amp;&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>status</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Determines whether space has been allocated for a dataset.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>status</em>&nbsp;</td><td>- OUT: Space allocation status </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a7" doxytag="H5::DataSet::getStorageSize" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> hsize_t H5::DataSet::getStorageSize </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns the amount of storage required for a dataset.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>Amount of storage </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a8" doxytag="H5::DataSet::getVlenBufSize" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> hsize_t H5::DataSet::getVlenBufSize </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top"><a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>type</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap><a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>space</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns the number of bytes required to store VL data.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>Amount of storage </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a9" doxytag="H5::DataSet::vlenReclaim" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void H5::DataSet::vlenReclaim </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top"><a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>type</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap><a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>space</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap><a class="el" href="classH5_1_1DSetMemXferPropList.html">DSetMemXferPropList</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>xfer_plist</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>void *&nbsp;</td>
<td class="mdname" nowrap> <em>buf</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Reclaims VL datatype memory buffers.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>type</em>&nbsp;</td><td>- IN: Datatype, which is the datatype stored in the buffer </td></tr>
<tr><td></td><td valign=top><em>space</em>&nbsp;</td><td>- IN: Selection for the memory buffer to free the VL datatypes within </td></tr>
<tr><td></td><td valign=top><em>xfer_plist</em>&nbsp;</td><td>- IN: Property list used to create the buffer </td></tr>
<tr><td></td><td valign=top><em>buf</em>&nbsp;</td><td>- IN: Pointer to the buffer to be reclaimed </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a10" doxytag="H5::DataSet::read" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void H5::DataSet::read </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">void *&nbsp;</td>
<td class="mdname" nowrap> <em>buf</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>mem_type</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>mem_space</em> = <code><a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a></code>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>file_space</em> = <code><a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a></code>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DSetMemXferPropList.html">DSetMemXferPropList</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>xfer_plist</em> = <code><a class="el" href="classH5_1_1DSetMemXferPropList.html#s0">DSetMemXferPropList::DEFAULT</a></code></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Reads raw data from the specified dataset.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>buf</em>&nbsp;</td><td>- IN: Buffer for read data </td></tr>
<tr><td></td><td valign=top><em>mem_type</em>&nbsp;</td><td>- IN: Memory datatype </td></tr>
<tr><td></td><td valign=top><em>mem_space</em>&nbsp;</td><td>- IN: Memory dataspace </td></tr>
<tr><td></td><td valign=top><em>file_space</em>&nbsp;</td><td>- IN: Dataset's dataspace in the file </td></tr>
<tr><td></td><td valign=top><em>xfer_plist</em>&nbsp;</td><td>- IN: Transfer property list for this I/O operation </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
<dl compact><dt><b>Description</b></dt><dd>This function reads raw data from this dataset into the buffer <em>buf</em>, converting from file datatype and dataspace to memory datatype <em>mem_type</em> and dataspace <em>mem_space</em>. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a11" doxytag="H5::DataSet::read" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void H5::DataSet::read </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">string &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>strg</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>mem_type</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>mem_space</em> = <code><a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a></code>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>file_space</em> = <code><a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a></code>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DSetMemXferPropList.html">DSetMemXferPropList</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>xfer_plist</em> = <code><a class="el" href="classH5_1_1DSetMemXferPropList.html#s0">DSetMemXferPropList::DEFAULT</a></code></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
This is an overloaded member function, provided for convenience. It takes a reference to a <code>std::string</code> for the buffer.
<p>
</td>
</tr>
</table>
<a class="anchor" name="a12" doxytag="H5::DataSet::write" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void H5::DataSet::write </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const void *&nbsp;</td>
<td class="mdname" nowrap> <em>buf</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>mem_type</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>mem_space</em> = <code><a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a></code>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>file_space</em> = <code><a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a></code>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DSetMemXferPropList.html">DSetMemXferPropList</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>xfer_plist</em> = <code><a class="el" href="classH5_1_1DSetMemXferPropList.html#s0">DSetMemXferPropList::DEFAULT</a></code></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Writes raw data from an application buffer to a dataset.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>buf</em>&nbsp;</td><td>- IN: Buffer containing data to be written </td></tr>
<tr><td></td><td valign=top><em>mem_type</em>&nbsp;</td><td>- IN: Memory datatype </td></tr>
<tr><td></td><td valign=top><em>mem_space</em>&nbsp;</td><td>- IN: Memory dataspace </td></tr>
<tr><td></td><td valign=top><em>file_space</em>&nbsp;</td><td>- IN: Dataset's dataspace in the file </td></tr>
<tr><td></td><td valign=top><em>xfer_plist</em>&nbsp;</td><td>- IN: Transfer property list for this I/O operation </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
<dl compact><dt><b>Description</b></dt><dd>This function writes raw data from an application buffer <em>buf</em> to a dataset, converting from memory datatype <em>mem_type</em> and dataspace <em>mem_space</em> to file datatype and dataspace. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a13" doxytag="H5::DataSet::write" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void H5::DataSet::write </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const string &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>strg</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>mem_type</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>mem_space</em> = <code><a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a></code>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>file_space</em> = <code><a class="el" href="classH5_1_1DataSpace.html#s0">DataSpace::ALL</a></code>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DSetMemXferPropList.html">DSetMemXferPropList</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>xfer_plist</em> = <code><a class="el" href="classH5_1_1DSetMemXferPropList.html#s0">DSetMemXferPropList::DEFAULT</a></code></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
This is an overloaded member function, provided for convenience. It takes a reference to a <code>std::string</code> for the buffer.
<p>
</td>
</tr>
</table>
<a class="anchor" name="a14" doxytag="H5::DataSet::iterateElems" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int H5::DataSet::iterateElems </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">void *&nbsp;</td>
<td class="mdname" nowrap> <em>buf</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataType.html">DataType</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>type</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>space</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>H5D_operator_t&nbsp;</td>
<td class="mdname" nowrap> <em>op</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>void *&nbsp;</td>
<td class="mdname" nowrap> <em>op_data</em> = <code>NULL</code></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Iterates over all selected elements in a dataspace.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>buf</em>&nbsp;</td><td>- IN/OUT: Pointer to the buffer in memory containing the elements to iterate over </td></tr>
<tr><td></td><td valign=top><em>type</em>&nbsp;</td><td>- IN: Datatype for the elements stored in <em>buf</em> </td></tr>
<tr><td></td><td valign=top><em>space</em>&nbsp;</td><td>- IN: Dataspace for <em>buf</em>. Also contains the selection to iterate over. </td></tr>
<tr><td></td><td valign=top><em>op</em>&nbsp;</td><td>- IN: Function pointer to the routine to be called for each element in <em>buf</em> iterated over </td></tr>
<tr><td></td><td valign=top><em>op_data</em>&nbsp;</td><td>- IN/OUT: Pointer to any user-defined data associated with the operation </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::DataSetIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
<dl compact><dt><b>Note:</b></dt><dd>This function may not work correctly yet - it's still under development. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a15" doxytag="H5::DataSet::getObjType" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> H5G_obj_t H5::DataSet::getObjType </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">void *&nbsp;</td>
<td class="mdname" nowrap> <em>ref</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>H5R_type_t&nbsp;</td>
<td class="mdname" nowrap> <em>ref_type</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Retrieves the type of object that an object reference points to.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>ref_type</em>&nbsp;</td><td>- IN: Type of reference to query </td></tr>
<tr><td></td><td valign=top><em>ref</em>&nbsp;</td><td>- IN: Reference to query </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a16" doxytag="H5::DataSet::getRegion" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> H5::DataSet::getRegion </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">void *&nbsp;</td>
<td class="mdname" nowrap> <em>ref</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>H5R_type_t&nbsp;</td>
<td class="mdname" nowrap> <em>ref_type</em> = <code>H5R_DATASET_REGION</code></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Retrieves a dataspace with the region pointed to selected.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>ref_type</em>&nbsp;</td><td>- IN: Type of reference to get region of - default to H5R_DATASET_REGION </td></tr>
<tr><td></td><td valign=top><em>ref</em>&nbsp;</td><td>- IN: Reference to get region of </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> instance </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::ReferenceIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a17" doxytag="H5::DataSet::Reference" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void * H5::DataSet::Reference </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const char *&nbsp;</td>
<td class="mdname" nowrap> <em>name</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap><a class="el" href="classH5_1_1DataSpace.html">DataSpace</a> &amp;&nbsp;</td>
<td class="mdname" nowrap> <em>dataspace</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>H5R_type_t&nbsp;</td>
<td class="mdname" nowrap> <em>ref_type</em> = <code>H5R_DATASET_REGION</code></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Creates a reference to an HDF5 object or a dataset region.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>name</em>&nbsp;</td><td>- IN: Name of the object to be referenced </td></tr>
<tr><td></td><td valign=top><em>dataspace</em>&nbsp;</td><td>- IN: Dataspace with selection </td></tr>
<tr><td></td><td valign=top><em>ref_type</em>&nbsp;</td><td>- IN: Type of reference; default to <code>H5R_DATASET_REGION</code> </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A reference </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::ReferenceIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a18" doxytag="H5::DataSet::Reference" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void * H5::DataSet::Reference </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const char *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>name</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
This is an overloaded function, provided for your convenience. It differs from the above function in that it only creates a reference to an HDF5 object, not to a dataset region.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>name</em>&nbsp;</td><td>- IN: Name of the object to be referenced </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A reference </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>H5::ReferenceIException</em>&nbsp;</td><td></td></tr>
</table>
</dl>
<dl compact><dt><b>Description</b></dt><dd></dd></dl>
</td>
</tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Thu Aug 5 00:22:38 2004 by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border=0 ></a> 1.3.7-20040718 </small></address>
</body>
</html>