<!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>CCfits: CCfits::Table Class Reference</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.6.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<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="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="navpath"><b>CCfits</b>::<a class="el" href="classCCfits_1_1Table.html">Table</a>
</div>
</div>
<div class="contents">
<h1>CCfits::Table Class Reference</h1><!-- doxytag: class="CCfits::Table" --><!-- doxytag: inherits="CCfits::ExtHDU" -->
<p><code>#include <<a class="el" href="Table_8h_source.html">Table.h</a>></code></p>
<div class="dynheader">
Inheritance diagram for CCfits::Table:</div>
<div class="dynsection">
<div class="center">
<img src="classCCfits_1_1Table.gif" alt="Inheritance diagram" usemap="#CCfits::Table_map" alt=""/>
<map id="CCfits::Table_map" name="CCfits::Table_map">
<area href="classCCfits_1_1ExtHDU.html" alt="CCfits::ExtHDU" shape="rect" coords="60,56,171,80"/>
<area href="classCCfits_1_1HDU.html" alt="CCfits::HDU" shape="rect" coords="60,0,171,24"/>
<area href="classCCfits_1_1AsciiTable.html" alt="CCfits::AsciiTable" shape="rect" coords="0,168,111,192"/>
<area href="classCCfits_1_1BinTable.html" alt="CCfits::BinTable" shape="rect" coords="121,168,232,192"/>
</map>
</div>
</div>
<p><a href="classCCfits_1_1Table-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Classes</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table_1_1NoSuchColumn.html">NoSuchColumn</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Exception to be thrown on a failure to retrieve a column specified either by name or index number. <a href="classCCfits_1_1Table_1_1NoSuchColumn.html#_details">More...</a><br/></td></tr>
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a0b1f880e7bb883a2b05ee20909d94fbf"></a><!-- doxytag: member="CCfits::Table::Table" ref="a0b1f880e7bb883a2b05ee20909d94fbf" args="(const Table &right)" -->
</td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a0b1f880e7bb883a2b05ee20909d94fbf">Table</a> (const <a class="el" href="classCCfits_1_1Table.html">Table</a> &right)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">copy constructor <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a933afd64667d8ad6a7291686ca3d8603"></a><!-- doxytag: member="CCfits::Table::~Table" ref="a933afd64667d8ad6a7291686ca3d8603" args="()" -->
virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a933afd64667d8ad6a7291686ca3d8603">~Table</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">destructor <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual std::map< string, <br class="typebreak"/>
<a class="el" href="classCCfits_1_1Column.html">Column</a> * > & </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#ac41ac8e02386d095a969142b486d3890">column</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return a reference to the array containing the columns. <a href="#ac41ac8e02386d095a969142b486d3890"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual const std::map< string, <br class="typebreak"/>
<a class="el" href="classCCfits_1_1Column.html">Column</a> * > & </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a573b295bfdd242a99d97d0d3a1dd4982">column</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return a reference to the array containing the columns. <a href="#a573b295bfdd242a99d97d0d3a1dd4982"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classCCfits_1_1Column.html">Column</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a67eb478179846fc940e202476b4c08a3">column</a> (int colIndex) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return a reference to the column identified by colIndex <a href="#a67eb478179846fc940e202476b4c08a3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classCCfits_1_1Column.html">Column</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#ae578460dd522485e48ccd8f4536e5531">column</a> (const String &colName, bool caseSensitive=true) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return a reference to a <a class="el" href="classCCfits_1_1Table.html">Table</a> column specified by name. <a href="#ae578460dd522485e48ccd8f4536e5531"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a19bde9d4a37a2ee07016ef627e5fecde">deleteColumn</a> (const String &columnName)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">delete a column in a <a class="el" href="classCCfits_1_1Table.html">Table</a> extension by name. <a href="#a19bde9d4a37a2ee07016ef627e5fecde"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a7dc1b5bfcfde698946777e045b532ba2">deleteRows</a> (const std::vector< long > &rowList)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">delete a set of rows in the table specified by an input array. <a href="#a7dc1b5bfcfde698946777e045b532ba2"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#aa89bbe572a86b8bc4ca4249ba0b21dbb">deleteRows</a> (long first, long number=1)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">delete a range of rows in a table. <a href="#aa89bbe572a86b8bc4ca4249ba0b21dbb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual long </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a54e2948a7603a058c6a3cd99f0806ac9">getRowsize</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return the optimal number of rows to read or write at a time <a href="#a54e2948a7603a058c6a3cd99f0806ac9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a470beae464348ac917729b0d1d693ba0">insertRows</a> (long first, long number=1)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">insert empty rows into the table <a href="#a470beae464348ac917729b0d1d693ba0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7a10118f8f79786fa1c8813e2e838076"></a><!-- doxytag: member="CCfits::Table::numCols" ref="a7a10118f8f79786fa1c8813e2e838076" args="() const " -->
virtual int </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a7a10118f8f79786fa1c8813e2e838076">numCols</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return the number of Columns in the <a class="el" href="classCCfits_1_1Table.html">Table</a> (the TFIELDS keyword). <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aaf11d6f4b77aa533bd09562edcea4c10"></a><!-- doxytag: member="CCfits::Table::rows" ref="aaf11d6f4b77aa533bd09562edcea4c10" args="(long numRows)" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#aaf11d6f4b77aa533bd09562edcea4c10">rows</a> (long numRows)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">set the number of rows in the <a class="el" href="classCCfits_1_1Table.html">Table</a>. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a63b3ceb651637d7e73fd4a787b136450"></a><!-- doxytag: member="CCfits::Table::rows" ref="a63b3ceb651637d7e73fd4a787b136450" args="() const " -->
virtual long </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a63b3ceb651637d7e73fd4a787b136450">rows</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">return the number of rows in the table (NAXIS2). <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#aa610c082528ac5ed89b715e3f3b2e4e6">updateRows</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">update the number of rows in the table <a href="#aa610c082528ac5ed89b715e3f3b2e4e6"></a><br/></td></tr>
<tr><td colspan="2"><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#af79b97361d3f64e7b6fa48296a971818">Table</a> (FITSBase *p, HduType xtype, int number)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classCCfits_1_1Table.html">Table</a> constructor for getting Tables by number. <a href="#af79b97361d3f64e7b6fa48296a971818"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3325a78088498051760efde16dfae9b8"></a><!-- doxytag: member="CCfits::Table::Table" ref="a3325a78088498051760efde16dfae9b8" args="(FITSBase *p, HduType xtype, const String &hduName=String(""), int version=1)" -->
</td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a3325a78088498051760efde16dfae9b8">Table</a> (FITSBase *p, HduType xtype, const String &hduName=String(""), int version=1)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Constructor to be called by operations that read <a class="el" href="classCCfits_1_1Table.html">Table</a> specified by hduName and version. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a37f73f59845f49a01fbd587ce1bd06f3">Table</a> (FITSBase *p, HduType xtype, const String &hduName, int rows, const std::vector< String > &columnName, const std::vector< String > &columnFmt, const std::vector< String > &columnUnit=std::vector< String >(), int version=1)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Constructor to be used for creating new HDUs. <a href="#a37f73f59845f49a01fbd587ce1bd06f3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#ab5ade7dd546fe55f2c0e1f5ff7e0eddf">init</a> (bool readFlag=false, const std::vector< String > &keys=std::vector< String >())</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7a9b5c4231233847904f841d023978a5"></a><!-- doxytag: member="CCfits::Table::numCols" ref="a7a9b5c4231233847904f841d023978a5" args="(int value)" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#a7a9b5c4231233847904f841d023978a5">numCols</a> (int value)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">set the number of Columns in the <a class="el" href="classCCfits_1_1Table.html">Table</a> <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="adcf7114a5828d38b35e1732618716c35"></a><!-- doxytag: member="CCfits::Table::setColumn" ref="adcf7114a5828d38b35e1732618716c35" args="(const String &colname, Column *value)" -->
virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCCfits_1_1Table.html#adcf7114a5828d38b35e1732618716c35">setColumn</a> (const String &colname, <a class="el" href="classCCfits_1_1Column.html">Column</a> *value)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">set the column with name colname to the input value. <br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p><a class="el" href="classCCfits_1_1Table.html">Table</a> is the abstract common interface to Binary and Ascii <a class="el" href="classCCfits_1_1Table.html">Table</a> HDUs.</p>
<p><a class="el" href="classCCfits_1_1Table.html">Table</a> is a subclass of <a class="el" href="classCCfits_1_1ExtHDU.html" title="base class for all FITS extension HDUs, i.e. Image Extensions and Tables.">ExtHDU</a> that contains an associative array of <a class="el" href="classCCfits_1_1Column.html" title="Abstract base class for Column objects.">Column</a> objects. It implements methods for reading and writing columns </p>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a37f73f59845f49a01fbd587ce1bd06f3"></a><!-- doxytag: member="CCfits::Table::Table" ref="a37f73f59845f49a01fbd587ce1bd06f3" args="(FITSBase *p, HduType xtype, const String &hduName, int rows, const std::vector< String > &columnName, const std::vector< String > &columnFmt, const std::vector< String > &columnUnit=std::vector< String >(), int version=1)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">CCfits::Table::Table </td>
<td>(</td>
<td class="paramtype">FITSBase * </td>
<td class="paramname"> <em>p</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">HduType </td>
<td class="paramname"> <em>xtype</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const String & </td>
<td class="paramname"> <em>hduName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>rows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector< String > & </td>
<td class="paramname"> <em>columnName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector< String > & </td>
<td class="paramname"> <em>columnFmt</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector< String > & </td>
<td class="paramname"> <em>columnUnit</em> = <code>std::vector<String>()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>version</em> = <code>1</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Constructor to be used for creating new HDUs. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> file in which to place the new <a class="el" href="classCCfits_1_1HDU.html" title="Base class for all HDU [Header-Data Unit] objects.">HDU</a> </td></tr>
<tr><td valign="top"></td><td valign="top"><em>xtype</em> </td><td>An HduType enumerator defined in CCfits.h for type of table (AsciiTbl or BinaryTbl) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>hduName</em> </td><td>The name of this <a class="el" href="classCCfits_1_1HDU.html" title="Base class for all HDU [Header-Data Unit] objects.">HDU</a> extension </td></tr>
<tr><td valign="top"></td><td valign="top"><em>rows</em> </td><td>The number of rows in the new <a class="el" href="classCCfits_1_1HDU.html" title="Base class for all HDU [Header-Data Unit] objects.">HDU</a> (the value of the NAXIS2 keyword). </td></tr>
<tr><td valign="top"></td><td valign="top"><em>columnName</em> </td><td>a vector of names for the columns. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>columnFmt</em> </td><td>the format strings for the columns </td></tr>
<tr><td valign="top"></td><td valign="top"><em>columnUnit</em> </td><td>the units for the columns. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>version</em> </td><td>a version number </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="af79b97361d3f64e7b6fa48296a971818"></a><!-- doxytag: member="CCfits::Table::Table" ref="af79b97361d3f64e7b6fa48296a971818" args="(FITSBase *p, HduType xtype, int number)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">CCfits::Table::Table </td>
<td>(</td>
<td class="paramtype">FITSBase * </td>
<td class="paramname"> <em>p</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">HduType </td>
<td class="paramname"> <em>xtype</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>number</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classCCfits_1_1Table.html">Table</a> constructor for getting Tables by number. </p>
<p>Necessary since EXTNAME is a reserved not required keyword, and users may thus read <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> files without an extension name. Since an <a class="el" href="classCCfits_1_1HDU.html" title="Base class for all HDU [Header-Data Unit] objects.">HDU</a> is completely specified by extension number, this is part of the public interface. </p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="ac41ac8e02386d095a969142b486d3890"></a><!-- doxytag: member="CCfits::Table::column" ref="ac41ac8e02386d095a969142b486d3890" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::map< string, <a class="el" href="classCCfits_1_1Column.html">Column</a> * > & CCfits::Table::column </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [inline, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return a reference to the array containing the columns. </p>
<p>To be used in the implementation of subclasses. </p>
</div>
</div>
<a class="anchor" id="a573b295bfdd242a99d97d0d3a1dd4982"></a><!-- doxytag: member="CCfits::Table::column" ref="a573b295bfdd242a99d97d0d3a1dd4982" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const std::map< string, <a class="el" href="classCCfits_1_1Column.html">Column</a> * > & CCfits::Table::column </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const<code> [inline, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return a reference to the array containing the columns. </p>
<p>This public version might be used to query the size of the column container in a routine that manipulates column table data. </p>
<p>Reimplemented from <a class="el" href="classCCfits_1_1ExtHDU.html#ab121d5ab64abcc0a5df4ca7955bec2e9">CCfits::ExtHDU</a>.</p>
</div>
</div>
<a class="anchor" id="a67eb478179846fc940e202476b4c08a3"></a><!-- doxytag: member="CCfits::Table::column" ref="a67eb478179846fc940e202476b4c08a3" args="(int colIndex) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classCCfits_1_1Column.html">Column</a> & CCfits::Table::column </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>colIndex</em></td>
<td> ) </td>
<td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return a reference to the column identified by colIndex </p>
<p>Throws <a class="el" href="classCCfits_1_1Table_1_1NoSuchColumn.html" title="Exception to be thrown on a failure to retrieve a column specified either by name...">NoSuchColumn</a> if the index is out of range -index must satisfy (1 <= index <= <a class="el" href="classCCfits_1_1Table.html#a7a10118f8f79786fa1c8813e2e838076" title="return the number of Columns in the Table (the TFIELDS keyword).">numCols()</a> ).</p>
<p>N.B. the column number is assigned as 1-based, as in FORTRAN rather than 0-based as in C.</p>
<dl><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classCCfits_1_1Table_1_1NoSuchColumn.html" title="Exception to be thrown on a failure to retrieve a column specified either by name...">Table::NoSuchColumn</a></em> </td><td>passes colIndex to the diagnostic message printed when the exception is thrown </td></tr>
</table>
</dd>
</dl>
<p>Reimplemented from <a class="el" href="classCCfits_1_1ExtHDU.html#a06d5f1ebd32e0228790c8b4e4b57e2e4">CCfits::ExtHDU</a>.</p>
</div>
</div>
<a class="anchor" id="ae578460dd522485e48ccd8f4536e5531"></a><!-- doxytag: member="CCfits::Table::column" ref="ae578460dd522485e48ccd8f4536e5531" args="(const String &colName, bool caseSensitive=true) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classCCfits_1_1Column.html">Column</a> & CCfits::Table::column </td>
<td>(</td>
<td class="paramtype">const String & </td>
<td class="paramname"> <em>colName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>caseSensitive</em> = <code>true</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return a reference to a <a class="el" href="classCCfits_1_1Table.html">Table</a> column specified by name. </p>
<p>If the <em>caseSensitive</em> parameter is set to false, the search will be case-insensitive. The overridden base class implementation <a class="el" href="classCCfits_1_1ExtHDU.html#a9d3f8b23a32aa7303b0824fa6cb2f21b" title="return a reference to a Table column specified by name.">ExtHDU::column</a> throws an exception, which is thus the action to be taken if self is an image extension</p>
<dl><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>WrongExtensionType</em> </td><td>see above </td></tr>
</table>
</dd>
</dl>
<p>Reimplemented from <a class="el" href="classCCfits_1_1ExtHDU.html#a9d3f8b23a32aa7303b0824fa6cb2f21b">CCfits::ExtHDU</a>.</p>
</div>
</div>
<a class="anchor" id="a19bde9d4a37a2ee07016ef627e5fecde"></a><!-- doxytag: member="CCfits::Table::deleteColumn" ref="a19bde9d4a37a2ee07016ef627e5fecde" args="(const String &columnName)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CCfits::Table::deleteColumn </td>
<td>(</td>
<td class="paramtype">const String & </td>
<td class="paramname"> <em>columnName</em></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>delete a column in a <a class="el" href="classCCfits_1_1Table.html">Table</a> extension by name. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>columnName</em> </td><td>The name of the column to be deleted.</td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>WrongExtensionType</em> </td><td>if extension is an image. </td></tr>
</table>
</dd>
</dl>
<p>Reimplemented from <a class="el" href="classCCfits_1_1ExtHDU.html#aaee3fda1eb075ef4ee7a9178114bd00d">CCfits::ExtHDU</a>.</p>
</div>
</div>
<a class="anchor" id="a7dc1b5bfcfde698946777e045b532ba2"></a><!-- doxytag: member="CCfits::Table::deleteRows" ref="a7dc1b5bfcfde698946777e045b532ba2" args="(const std::vector< long > &rowList)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CCfits::Table::deleteRows </td>
<td>(</td>
<td class="paramtype">const std::vector< long > & </td>
<td class="paramname"> <em>rowlist</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>delete a set of rows in the table specified by an input array. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>rowlist</em> </td><td>The vector of row numbers to be deleted.</td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classCCfits_1_1FitsError.html" title="FitsError is the exception thrown by non-zero cfitsio status codes.">FitsError</a></em> </td><td>thrown if the underlying cfitsio call fails to return without error. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="aa89bbe572a86b8bc4ca4249ba0b21dbb"></a><!-- doxytag: member="CCfits::Table::deleteRows" ref="aa89bbe572a86b8bc4ca4249ba0b21dbb" args="(long first, long number=1)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CCfits::Table::deleteRows </td>
<td>(</td>
<td class="paramtype">long </td>
<td class="paramname"> <em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>number</em> = <code>1</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>delete a range of rows in a table. </p>
<p>In both this and the overloaded version which allows a selection of rows to be deleted, the cfitsio library is called first to perform the operation on the disk file, and then the <a class="el" href="classCCfits_1_1FITS.html" title="Memory object representation of a disk FITS file.">FITS</a> object is updated.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>first</em> </td><td>the start row of the range </td></tr>
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>the number of rows to delete; defaults to 1.</td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classCCfits_1_1FitsError.html" title="FitsError is the exception thrown by non-zero cfitsio status codes.">FitsError</a></em> </td><td>thrown if the cfitsio call fails to return without error. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a54e2948a7603a058c6a3cd99f0806ac9"></a><!-- doxytag: member="CCfits::Table::getRowsize" ref="a54e2948a7603a058c6a3cd99f0806ac9" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">long CCfits::Table::getRowsize </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>return the optimal number of rows to read or write at a time </p>
<p>A wrapper for the CFITSIO function fits_get_rowsize, useful for obtaining maximum I/O efficiency. This will throw if it is not called for a <a class="el" href="classCCfits_1_1Table.html">Table</a> extension. </p>
<p>Reimplemented from <a class="el" href="classCCfits_1_1ExtHDU.html#a5a480387701525f75ea450dac7510f23">CCfits::ExtHDU</a>.</p>
</div>
</div>
<a class="anchor" id="ab5ade7dd546fe55f2c0e1f5ff7e0eddf"></a><!-- doxytag: member="CCfits::Table::init" ref="ab5ade7dd546fe55f2c0e1f5ff7e0eddf" args="(bool readFlag=false, const std::vector< String > &keys=std::vector< String >())" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CCfits::Table::init </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>readFlag</em> = <code>false</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector< String > & </td>
<td class="paramname"> <em>keys</em> = <code>std::vector<String>()</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>"Late Constructor." wrap-up of calls needed to construct a table. Reads header information and sets up the array of column objects in the table.</p>
<p>Protected function, provided to allow the implementation of extensions of the library. </p>
</div>
</div>
<a class="anchor" id="a470beae464348ac917729b0d1d693ba0"></a><!-- doxytag: member="CCfits::Table::insertRows" ref="a470beae464348ac917729b0d1d693ba0" args="(long first, long number=1)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CCfits::Table::insertRows </td>
<td>(</td>
<td class="paramtype">long </td>
<td class="paramname"> <em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>number</em> = <code>1</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>insert empty rows into the table </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>first</em> </td><td>the start row of the range </td></tr>
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>the number of rows to insert.</td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classCCfits_1_1FitsError.html" title="FitsError is the exception thrown by non-zero cfitsio status codes.">FitsError</a></em> </td><td>thrown if the underlying cfitsio call fails to return without error. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="aa610c082528ac5ed89b715e3f3b2e4e6"></a><!-- doxytag: member="CCfits::Table::updateRows" ref="aa610c082528ac5ed89b715e3f3b2e4e6" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CCfits::Table::updateRows </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>update the number of rows in the table </p>
<p>Called to force the <a class="el" href="classCCfits_1_1Table.html">Table</a> to reset its internal "rows" attribute. public, but is called when needed internally. </p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="Table_8h_source.html">Table.h</a></li>
<li>Table.cxx</li>
</ul>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on Wed Sep 9 11:59:47 2009 for CCfits by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>
distrib
>
Fedora
>
13
>
i386
>
media
>
os
>
by-pkgid
>
ecbd8c5b7568e331fe6ea5b9a07a78a0
>
files
>
131
