mitab__capi_8cpp.html

mitab,读取MapInfo的地图文件

The C wrapper functions contained in <a class="el" href="mitab__capi_8cpp.html" title="MITAB C API.">mitab_capi.cpp</a> provide a much simpler interface than the OGR-based C++ classes to the MITAB library to read and write .TAB and .MIF files.<p>
To use the C API, simply include "mitab_capi.h" and use the functions defined in <a class="el" href="mitab__capi_8cpp.html" title="MITAB C API.">mitab_capi.cpp</a>.<p>
See also mitabc_test.cpp which for examples of use of the C API.<p>
See contrib/README_VB.TXT in the MITAB source code distribution for informations on using the MITAB C API from VB, Pascal, or MapBasic. <hr><h2>Function Documentation</h2>
<a class="anchor" name="49647accca61dfbc57b2dcc35fef325b"></a><!-- doxytag: member="mitab_capi.cpp::mitab_c_add_field" ref="49647accca61dfbc57b2dcc35fef325b" args="(mitab_handle dataset, const char *field_name, int field_type, int width, int precision, int indexed, int unique)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int MITAB_STDCALL mitab_c_add_field           </td>
          <td>(</td>
          <td class="paramtype">mitab_handle&nbsp;</td>
          <td class="paramname"> <em>dataset</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>field_name</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>field_type</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>width</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>precision</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>indexed</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>unique</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Add a new field to the dataset's schema. 
<p>
Adding fields MUST be done immediately after creating a new dataset and BEFORE creating the first feature.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>dataset</em>&nbsp;</td><td>the mitab_handle of the newly created dataset. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>field_name</em>&nbsp;</td><td>the name of the new field to create. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>field_type</em>&nbsp;</td><td>the new field type, one of TABFT_Char (1), TABFT_Integer (2), TABFT_SmallInt (3), TABFT_Decimal (4), TABFT_Float (5), TABFT_Date (6), or TABFT_Logical (7) </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>width</em>&nbsp;</td><td>the width of the new field, applies only to char and decimal types. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>precision</em>&nbsp;</td><td>the number of digits after the decimal point, applies only to the decimal field type. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>indexed</em>&nbsp;</td><td>TRUE (1) to create an indexed field (or FALSE (0) for no index) </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>unique</em>&nbsp;</td><td>for indexed fields, set this to TRUE (1) if the field values are guaranteed to be unique, or FALSE (0) otherwise. </td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the 0-based index of the new field, or -1 if the field could not be created. </dd></dl>

</div>
</div><p>
<a class="anchor" name="7a736cbe5f0c357b75fab8cd5b17d917"></a><!-- doxytag: member="mitab_capi.cpp::mitab_c_close" ref="7a736cbe5f0c357b75fab8cd5b17d917" args="(mitab_handle handle)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void MITAB_STDCALL mitab_c_close           </td>
          <td>(</td>
          <td class="paramtype">mitab_handle&nbsp;</td>
          <td class="paramname"> <em>handle</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Close a dataset previously opened using <a class="el" href="mitab__capi_8cpp.html#4ee2dfa087f3e5887121af204c1a54c3" title="Open an existing .TAB or .MIF dataset for read access.">mitab_c_open()</a> or created using <a class="el" href="mitab__capi_8cpp.html#00001954939919bc111937e9b82adce3" title="Create a new .TAB or .MIF dataset.">mitab_c_create()</a>. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>the mitab_handle of the dataset to close. </td></tr>
  </table>
</dl>

</div>
</div><p>
<a class="anchor" name="00001954939919bc111937e9b82adce3"></a><!-- doxytag: member="mitab_capi.cpp::mitab_c_create" ref="00001954939919bc111937e9b82adce3" args="(const char *filename, const char *mif_or_tab, const char *mif_projection, double north, double south, double east, double west)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">mitab_handle MITAB_STDCALL mitab_c_create           </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>filename</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>mif_or_tab</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>mif_projection</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">double&nbsp;</td>
          <td class="paramname"> <em>north</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">double&nbsp;</td>
          <td class="paramname"> <em>south</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">double&nbsp;</td>
          <td class="paramname"> <em>east</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>