cpl__conv_8h.html

gdal库的学习文档

</div>
</div><p>
<a class="anchor" name="0a01ca071035c36d4b4f85336e08c5d5"></a><!-- doxytag: member="cpl_conv.h::CPLAtofDelim" ref="0a01ca071035c36d4b4f85336e08c5d5" args="(const char *, char)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">double CPLAtofDelim           </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>nptr</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">char&nbsp;</td>
          <td class="paramname"> <em>point</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>
Converts ASCII string to floating point number.<p>
This function converts the initial portion of the string pointed to by nptr to double floating point representation. The behaviour is the same as<p>
CPLStrtodDelim(nptr, (char **)NULL, point);<p>
This function does the same as standard atof(3), but does not take locale in account. Instead of locale defined decimal delimiter you can specify your own one. Also see notes for <a class="el" href="cpl__conv_8h.html#fb5bf88066f997b1ab3b3911f5e9b722">CPLAtof()</a> function.<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>nptr</em>&nbsp;</td><td>Pointer to string to convert. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>point</em>&nbsp;</td><td>Decimal delimiter.</td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Converted value, if any. </dd></dl>

</div>
</div><p>
<a class="anchor" name="a07cd1b2aa5e76eb67ba952440198796"></a><!-- doxytag: member="cpl_conv.h::CPLAtofM" ref="a07cd1b2aa5e76eb67ba952440198796" args="(const char *)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">double CPLAtofM           </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>nptr</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Converts ASCII string to floating point number using any numeric locale.<p>
This function converts the initial portion of the string pointed to by nptr to double floating point representation. This function does the same as standard atof(), but it allows a variety of locale representations. That is it supports numeric values with either a comma or a period for the decimal delimiter.<p>
PS. The M stands for Multi-lingual.<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>nptr</em>&nbsp;</td><td>The string to convert.</td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Converted value, if any. Zero on failure. </dd></dl>

</div>
</div><p>
<a class="anchor" name="5b990672a0221115c9b54a8931554136"></a><!-- doxytag: member="cpl_conv.h::CPLCalloc" ref="5b990672a0221115c9b54a8931554136" args="(size_t, size_t)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void* CPLCalloc           </td>
          <td>(</td>
          <td class="paramtype">size_t&nbsp;</td>
          <td class="paramname"> <em>nCount</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t&nbsp;</td>
          <td class="paramname"> <em>nSize</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>
Safe version of calloc().<p>
This function is like the C library calloc(), but raises a CE_Fatal error with <a class="el" href="cpl__error_8h.html#ad2b98dd58e4de706a245faddac90403">CPLError()</a> if it fails to allocate the desired memory. It should be used for small memory allocations that are unlikely to fail and for which the application is unwilling to test for out of memory conditions. It uses VSICalloc() to get the memory, so any hooking of VSICalloc() will apply to <a class="el" href="cpl__conv_8h.html#5b990672a0221115c9b54a8931554136">CPLCalloc()</a> as well. CPLFree() or VSIFree() can be used free memory allocated by <a class="el" href="cpl__conv_8h.html#5b990672a0221115c9b54a8931554136">CPLCalloc()</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>nCount</em>&nbsp;</td><td>number of objects to allocate. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>nSize</em>&nbsp;</td><td>size (in bytes) of object to allocate. </td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>pointer to newly allocated memory, only NULL if nSize * nCount is NULL. </dd></dl>

</div>
</div><p>
<a class="anchor" name="c8ed75603810ed09726ebff3463ba80b"></a><!-- doxytag: member="cpl_conv.h::CPLCleanTrailingSlash" ref="c8ed75603810ed09726ebff3463ba80b" args="(const char *)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* CPLCleanTrailingSlash           </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>pszFilename</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Remove trailing forward/backward slash from the path for unix/windows resp.<p>
Returns a string containing the portion of the passed path string with trailing slash removed. If there is no path in the passed filename an empty string will be returned (not NULL).<p>
<pre>
 CPLCleanTrailingSlash( "abc/def/" ) == "abc/def"
 CPLCleanTrailingSlash( "abc/def" ) == "abc/def"
 CPLCleanTrailingSlash( "c:\abc\def\" ) == "c:\abc\def"
 CPLCleanTrailingSlash( "c:\abc\def" ) == "c:\abc\def"
 CPLCleanTrailingSlash( "abc" ) == "abc"
 </pre><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>pszPath</em>&nbsp;</td><td>the path to be cleaned up</td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Path in an internal string which must not be freed. The string may be destroyed by the next CPL filename handling call. The returned will generally not contain a trailing path separator. </dd></dl>

</div>
</div><p>
<a class="anchor" name="1afd2c936bbf27a74b02ae6dcadf25a7"></a><!-- doxytag: member="cpl_conv.h::CPLCloseShared" ref="1afd2c936bbf27a74b02ae6dcadf25a7" args="(FILE *)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void CPLCloseShared           </td>
          <td>(</td>
          <td class="paramtype">FILE *&nbsp;</td>
          <td class="paramname"> <em>fp</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Close shared file.<p>
Dereferences the indicated file handle, and closes it if the reference count has dropped to zero. A <a class="el" href="cpl__error_8h.html#ad2b98dd58e4de706a245faddac90403">CPLError()</a> is issued if the file is not in the shared file list.<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>fp</em>&nbsp;</td><td>file handle from <a class="el" href="cpl__conv_8h.html#f47485362aca554e37796c352a77fc71">CPLOpenShared()</a> to deaccess. </td></tr>
  </table>
</dl>

</div>
</div><p>
<a class="anchor" name="97b69cc886a1a5c9618612d8205600e4"></a><!-- doxytag: member="cpl_conv.h::CPLDecToPackedDMS" ref="97b69cc886a1a5c9618612d8205600e4" args="(double dfDec)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">double CPLDecToPackedDMS           </td>
          <td>(</td>
          <td class="paramtype">double&nbsp;</td>
          <td class="paramname"> <em>dfDec</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Convert decimal degrees into packed DMS value (DDDMMMSSS.SS).<p>
This function converts a value, specified in decimal degrees into packed DMS angle. The standard packed DMS format is:<p>
degrees * 1000000 + minutes * 1000 + seconds<p>
See also <a class="el" href="cpl__conv_8h.html#a4ffc8fd25881635e18d1a53e177a8e1">CPLPackedDMSToDec()</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>dfDec</em>&nbsp;</td><td>Angle in decimal degrees.</td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Angle in packed DMS format. </dd></dl>

</div>
</div><p>
<a class="anchor" name="a7709a32d13e10f2c6c28a176b5a8784"></a><!-- doxytag: member="cpl_conv.h::CPLDumpSharedList" ref="a7709a32d13e10f2c6c28a176b5a8784" args="(FILE *)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void CPLDumpSharedList           </td>
          <td>(</td>
          <td class="paramtype">FILE *&nbsp;</td>
          <td class="paramname"> <em>fp</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Report open shared files.<p>
Dumps all open shared files to the indicated file handle. If the file handle is NULL information is sent via the <a class="el" href="cpl__error_8h.html#d0c5d3481dd34c1f3a0f7775ebf74817">CPLDebug()</a> call.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>