EVOLUTION-MANAGER
Edit File: classDDFField.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.5"/> <title>SDTS_AL: DDFField Class Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">SDTS_AL </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.5 --> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li class="current"><a href="annotated.html"><span>Classes</span></a></li> <li><a href="files.html"><span>Files</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <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><!-- top --> <div class="header"> <div class="summary"> <a href="#pub-methods">Public Member Functions</a> | <a href="classDDFField-members.html">List of all members</a> </div> <div class="headertitle"> <div class="title">DDFField Class Reference</div> </div> </div><!--header--> <div class="contents"> <p><code>#include <<a class="el" href="iso8211_8h_source.html">iso8211.h</a>></code></p> <table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a> Public Member Functions</h2></td></tr> <tr class="memitem:ac4b9941d3d0ba357f8265b8e698b2f36"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDDFField.html#ac4b9941d3d0ba357f8265b8e698b2f36">Dump</a> (FILE *fp)</td></tr> <tr class="separator:ac4b9941d3d0ba357f8265b8e698b2f36"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a778da0e37f57a48e1c39e4ee3cf1ca83"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classDDFField.html#a778da0e37f57a48e1c39e4ee3cf1ca83">GetSubfieldData</a> (<a class="el" href="classDDFSubfieldDefn.html">DDFSubfieldDefn</a> *, int *=NULL, int=0)</td></tr> <tr class="separator:a778da0e37f57a48e1c39e4ee3cf1ca83"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a1663390fe6bbb95a112ad9e5db46ad09"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classDDFField.html#a1663390fe6bbb95a112ad9e5db46ad09">GetInstanceData</a> (int nInstance, int *pnSize)</td></tr> <tr class="separator:a1663390fe6bbb95a112ad9e5db46ad09"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a1e7577f4577b917eaeb0fa06702367c4"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classDDFField.html#a1e7577f4577b917eaeb0fa06702367c4">GetData</a> ()</td></tr> <tr class="separator:a1e7577f4577b917eaeb0fa06702367c4"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a10da0719702d80b6ce7a2ebc0a756483"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classDDFField.html#a10da0719702d80b6ce7a2ebc0a756483">GetDataSize</a> ()</td></tr> <tr class="separator:a10da0719702d80b6ce7a2ebc0a756483"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:af192de6f3189570fd6dfb31c8fd091ce"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classDDFField.html#af192de6f3189570fd6dfb31c8fd091ce">GetRepeatCount</a> ()</td></tr> <tr class="separator:af192de6f3189570fd6dfb31c8fd091ce"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ae2dc98dc9f24cd548a8b0c7461f4179d"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classDDFFieldDefn.html">DDFFieldDefn</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classDDFField.html#ae2dc98dc9f24cd548a8b0c7461f4179d">GetFieldDefn</a> ()</td></tr> <tr class="separator:ae2dc98dc9f24cd548a8b0c7461f4179d"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <div class="textblock"><p>This object represents one field in a <a class="el" href="classDDFRecord.html">DDFRecord</a>. This models an instance of the fields data, rather than it's data definition which is handled by the <a class="el" href="classDDFFieldDefn.html">DDFFieldDefn</a> class. Note that a <a class="el" href="classDDFField.html">DDFField</a> doesn't have DDFSubfield children as you would expect. To extract subfield values use <a class="el" href="classDDFField.html#a778da0e37f57a48e1c39e4ee3cf1ca83">GetSubfieldData()</a> to find the right data pointer and then use ExtractIntData(), ExtractFloatData() or ExtractStringData(). </p> </div><h2 class="groupheader">Member Function Documentation</h2> <a class="anchor" id="ac4b9941d3d0ba357f8265b8e698b2f36"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void DDFField::Dump </td> <td>(</td> <td class="paramtype">FILE * </td> <td class="paramname"><em>fp</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Write out field contents to debugging file.</p> <p>A variety of information about this field, and all it's subfields is written to the given debugging file handle. Note that field definition information (ala <a class="el" href="classDDFFieldDefn.html">DDFFieldDefn</a>) isn't written.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">fp</td><td>The standard io file handle to write to. ie. stderr </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a1e7577f4577b917eaeb0fa06702367c4"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">const char* DDFField::GetData </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Return the pointer to the entire data block for this record. This is an internal copy, and shouldn't be freed by the application. </p> </div> </div> <a class="anchor" id="a10da0719702d80b6ce7a2ebc0a756483"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">int DDFField::GetDataSize </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Return the number of bytes in the data block returned by <a class="el" href="classDDFField.html#a1e7577f4577b917eaeb0fa06702367c4">GetData()</a>. </p> </div> </div> <a class="anchor" id="ae2dc98dc9f24cd548a8b0c7461f4179d"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classDDFFieldDefn.html">DDFFieldDefn</a>* DDFField::GetFieldDefn </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Fetch the corresponding <a class="el" href="classDDFFieldDefn.html">DDFFieldDefn</a>. </p> </div> </div> <a class="anchor" id="a1663390fe6bbb95a112ad9e5db46ad09"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">const char * DDFField::GetInstanceData </td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"><em>nInstance</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int * </td> <td class="paramname"><em>pnInstanceSize</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Get field instance data and size.</p> <p>The returned data pointer and size values are suitable for use with <a class="el" href="classDDFRecord.html#a6d4c805ce592dc1bc70e601858f4da1b">DDFRecord::SetFieldRaw()</a>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">nInstance</td><td>a value from 0 to <a class="el" href="classDDFField.html#af192de6f3189570fd6dfb31c8fd091ce">GetRepeatCount()</a>-1. </td></tr> <tr><td class="paramname">pnInstanceSize</td><td>a location to put the size (in bytes) of the field instance data returned. This size will include the unit terminator (if any), but not the field terminator. This size pointer may be NULL if not needed.</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the data pointer, or NULL on error. </dd></dl> </div> </div> <a class="anchor" id="af192de6f3189570fd6dfb31c8fd091ce"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int DDFField::GetRepeatCount </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>How many times do the subfields of this record repeat? This will always be one for non-repeating fields.</p> <dl class="section return"><dt>Returns</dt><dd>The number of times that the subfields of this record occur in this record. This will be one for non-repeating fields.</dd></dl> <dl class="section see"><dt>See Also</dt><dd><a href="example.html">8211view example program</a> for demonstation of handling repeated fields properly. </dd></dl> </div> </div> <a class="anchor" id="a778da0e37f57a48e1c39e4ee3cf1ca83"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">const char * DDFField::GetSubfieldData </td> <td>(</td> <td class="paramtype"><a class="el" href="classDDFSubfieldDefn.html">DDFSubfieldDefn</a> * </td> <td class="paramname"><em>poSFDefn</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int * </td> <td class="paramname"><em>pnMaxBytes</em> = <code>NULL</code>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>iSubfieldIndex</em> = <code>0</code> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Fetch raw data pointer for a particular subfield of this field.</p> <p>The passed <a class="el" href="classDDFSubfieldDefn.html">DDFSubfieldDefn</a> (poSFDefn) should be acquired from the <a class="el" href="classDDFFieldDefn.html">DDFFieldDefn</a> corresponding with this field. This is normally done once before reading any records. This method involves a series of calls to DDFSubfield::GetDataLength() in order to track through the <a class="el" href="classDDFField.html">DDFField</a> data to that belonging to the requested subfield. This can be relatively expensive.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">poSFDefn</td><td>The definition of the subfield for which the raw data pointer is desired. </td></tr> <tr><td class="paramname">pnMaxBytes</td><td>The maximum number of bytes that can be accessed from the returned data pointer is placed in this int, unless it is NULL. </td></tr> <tr><td class="paramname">iSubfieldIndex</td><td>The instance of this subfield to fetch. Use zero (the default) for the first instance.</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>A pointer into the <a class="el" href="classDDFField.html">DDFField</a>'s data that belongs to the subfield. This returned pointer is invalidated by the next record read (DDFRecord::ReadRecord()) and the returned pointer should not be freed by the application. </dd></dl> </div> </div> <hr/>The documentation for this class was generated from the following files:<ul> <li><a class="el" href="iso8211_8h_source.html">iso8211.h</a></li> <li>ddffield.cpp</li> </ul> </div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.5 </small></address> </body> </html>