<!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>GDAL: cpl_conv.h File 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.2-20100208 -->
<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="annotated.html"><span>Classes</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>File Members</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>cpl_conv.h File Reference</h1><code>#include "<a class="el" href="cpl__port_8h_source.html">cpl_port.h</a>"</code><br/>
<code>#include "<a class="el" href="cpl__vsi_8h_source.html">cpl_vsi.h</a>"</code><br/>
<code>#include "<a class="el" href="cpl__error_8h_source.html">cpl_error.h</a>"</code><br/>
<p><a href="cpl__conv_8h_source.html">Go to the source code of this file.</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">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structCPLSharedFileInfo.html">CPLSharedFileInfo</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classCPLLocaleC.html">CPLLocaleC</a></td></tr>
<tr><td colspan="2"><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a21b7f312da39ddb0a12bdde06b153b48"></a><!-- doxytag: member="cpl_conv.h::CPLFree" ref="a21b7f312da39ddb0a12bdde06b153b48" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPLFree</b> VSIFree</td></tr>
<tr><td colspan="2"><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ad6f974fbf2abefc9be05ad2c569dad27"></a><!-- doxytag: member="cpl_conv.h::CPLFileFinder" ref="ad6f974fbf2abefc9be05ad2c569dad27" args=")(const char *, const char *)" -->
typedef const char *(* </td><td class="memItemRight" valign="bottom"><b>CPLFileFinder</b> )(const char *, const char *)</td></tr>
<tr><td colspan="2"><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a5b137c39b2fb50df0629d4eb37a53971"></a><!-- doxytag: member="cpl_conv.h::CPLVerifyConfiguration" ref="a5b137c39b2fb50df0629d4eb37a53971" args="(void)" -->
void </td><td class="memItemRight" valign="bottom"><b>CPLVerifyConfiguration</b> (void)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a8b249211d68e4b6b1844004891e5ca5a"></a><!-- doxytag: member="cpl_conv.h::CPLGetConfigOption" ref="a8b249211d68e4b6b1844004891e5ca5a" args="(const char *, const char *)" -->
const char * </td><td class="memItemRight" valign="bottom"><b>CPLGetConfigOption</b> (const char *, const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aa0cd1a68fe4f2fc7874cd2da605c36ce"></a><!-- doxytag: member="cpl_conv.h::CPLSetConfigOption" ref="aa0cd1a68fe4f2fc7874cd2da605c36ce" args="(const char *, const char *)" -->
void </td><td class="memItemRight" valign="bottom"><b>CPLSetConfigOption</b> (const char *, const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a694fe05b1bececde022a2f182a357e0d"></a><!-- doxytag: member="cpl_conv.h::CPLFreeConfig" ref="a694fe05b1bececde022a2f182a357e0d" args="(void)" -->
void </td><td class="memItemRight" valign="bottom"><b>CPLFreeConfig</b> (void)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a9ebcdb25fc6ff90b0c7b01733d5ae6d3">CPLMalloc</a> (size_t)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a5b990672a0221115c9b54a8931554136">CPLCalloc</a> (size_t, size_t)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a6861a37c19e925ee0aa8d5b10ee13147">CPLRealloc</a> (void *, size_t)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a464d6861faf9f6272317d160a3ad9a81">CPLStrdup</a> (const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a1dac5cfc5a7e9dbcf511b461812d89b9">CPLStrlwr</a> (char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a98e99149a5cb64a79c6a683dc4a4efe2">CPLFGets</a> (char *, int, FILE *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a0ad35dbadd4f1d04bbedd66774be940f">CPLReadLine</a> (FILE *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a88612c88fb41db8a7e38c0f09c4042c9">CPLReadLineL</a> (FILE *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#afb5bf88066f997b1ab3b3911f5e9b722">CPLAtof</a> (const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a0a01ca071035c36d4b4f85336e08c5d5">CPLAtofDelim</a> (const char *, char)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a2388e43fb089a354eb3583016b2a3b00">CPLStrtod</a> (const char *, char **)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#ac96c5f1823c54ef96b5783208c817817">CPLStrtodDelim</a> (const char *, char **, char)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a1ccda187ed172fd6e33cd98223328531">CPLStrtof</a> (const char *, char **)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a3a102a1417c98a242900fb8c0076fc1b">CPLStrtofDelim</a> (const char *, char **, char)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#aa07cd1b2aa5e76eb67ba952440198796">CPLAtofM</a> (const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a9c2ddf6a8bdb1a9bf2e90e7acbea2cdc">CPLScanString</a> (const char *, int, int, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#abcdeae39a61518c9c31ecc593eeff621">CPLScanDouble</a> (const char *, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">long </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a338bbe67c148d2555861eb5563b17303">CPLScanLong</a> (const char *, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">unsigned long </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#ac6e9643c26ab4ee22df95e3dd18c959a">CPLScanULong</a> (const char *, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GUIntBig </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#ab4a8e6cf7a0d0f662f6cd4555b074bb5">CPLScanUIntBig</a> (const char *, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a2dea859a1f5690d25e5eb32f8d091905">CPLScanPointer</a> (const char *, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#ae284b3e504edca3eb1eaf568469d61ba">CPLPrintString</a> (char *, const char *, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a0bdbcb209eb9b8e2e6be4fa6e0b750f6">CPLPrintStringFill</a> (char *, const char *, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a33618500e56ec12e6775b3ed9014b8fb">CPLPrintInt32</a> (char *, GInt32, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a13ca1da1151489f1eee7770296f164aa">CPLPrintUIntBig</a> (char *, GUIntBig, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#ad77e478b4f2e14cc03ae23a9c81434c9">CPLPrintDouble</a> (char *, const char *, double, const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a5be9cf1de05769139a77339ffb970ce4">CPLPrintTime</a> (char *, int, const char *, const struct tm *, const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#af268becc479787ae48bb2607d0000886">CPLPrintPointer</a> (char *, void *, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a0c8e54bbbdd75f6315fe2fafd3d5259f">CPLGetSymbol</a> (const char *, const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a5325c900de0918020b747ed07d98da24">CPLGetExecPath</a> (char *pszPathBuf, int nMaxLength)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a4cd11a5f67bb4816342301fa8a5990a0">CPLGetPath</a> (const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a3c6f71eaf9b8e8f98242af533752d1bb">CPLGetDirname</a> (const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#ae67694bcaaaa43f046325994e3413bac">CPLGetFilename</a> (const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a913ec8c102e1dd312d9447cd815a8673">CPLGetBasename</a> (const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#ae46fcfcea1b2e8c24738542613ba4752">CPLGetExtension</a> (const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#afc51f03a3789be8a47b8a753eb897856">CPLGetCurrentDir</a> (void)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#aee0f81afed5b1b31da1b401822c7a2fb">CPLFormFilename</a> (const char *pszPath, const char *pszBasename, const char *pszExtension)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a9c76b24b06830f0da04fe076177f9ff3">CPLFormCIFilename</a> (const char *pszPath, const char *pszBasename, const char *pszExtension)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a637fddebebefc776e5c657bcc7366b89">CPLResetExtension</a> (const char *, const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#acb7cd6067d35796aa1af144e5a4283b4">CPLProjectRelativeFilename</a> (const char *pszProjectDir, const char *pszSecondaryFilename)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a0cd8ae8d760125ec5b01958a776691ec">CPLIsFilenameRelative</a> (const char *pszFilename)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a1f558377064b63f76eefb4065368f8e2">CPLExtractRelativePath</a> (const char *, const char *, int *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#ac8ed75603810ed09726ebff3463ba80b">CPLCleanTrailingSlash</a> (const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char ** </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a7e9657e7ff077fabbc25a41219a8f8ce">CPLCorrespondingPaths</a> (const char *pszOldFilename, const char *pszNewFilename, char **papszFileList)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#afa9b8f28ae84d5d898b7a3afc6bb6a4b">CPLCheckForFile</a> (char *pszFilename, char **papszSiblingList)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#aaadfd84593d3f707630eb06b520b7dbf">CPLGenerateTempFilename</a> (const char *pszStem)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a86d703dd3f7f137d1590b55d7a7e4fb8"></a><!-- doxytag: member="cpl_conv.h::CPLFindFile" ref="a86d703dd3f7f137d1590b55d7a7e4fb8" args="(const char *pszClass, const char *pszBasename)" -->
const char * </td><td class="memItemRight" valign="bottom"><b>CPLFindFile</b> (const char *pszClass, const char *pszBasename)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ad36c679ea9121ae1a82f0da9010b89ec"></a><!-- doxytag: member="cpl_conv.h::CPLDefaultFindFile" ref="ad36c679ea9121ae1a82f0da9010b89ec" args="(const char *pszClass, const char *pszBasename)" -->
const char * </td><td class="memItemRight" valign="bottom"><b>CPLDefaultFindFile</b> (const char *pszClass, const char *pszBasename)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a9205b5a0266e9ff0130324016cfe2743"></a><!-- doxytag: member="cpl_conv.h::CPLPushFileFinder" ref="a9205b5a0266e9ff0130324016cfe2743" args="(CPLFileFinder pfnFinder)" -->
void </td><td class="memItemRight" valign="bottom"><b>CPLPushFileFinder</b> (CPLFileFinder pfnFinder)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af09a216ab0d69b57b528628ef2f9ee51"></a><!-- doxytag: member="cpl_conv.h::CPLPopFileFinder" ref="af09a216ab0d69b57b528628ef2f9ee51" args="(void)" -->
CPLFileFinder </td><td class="memItemRight" valign="bottom"><b>CPLPopFileFinder</b> (void)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a8fb38a901b889d3b0d8a28ede5f97ef5"></a><!-- doxytag: member="cpl_conv.h::CPLPushFinderLocation" ref="a8fb38a901b889d3b0d8a28ede5f97ef5" args="(const char *)" -->
void </td><td class="memItemRight" valign="bottom"><b>CPLPushFinderLocation</b> (const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a9dbfaacc8fd61bcff6c06d5b8061dff4"></a><!-- doxytag: member="cpl_conv.h::CPLPopFinderLocation" ref="a9dbfaacc8fd61bcff6c06d5b8061dff4" args="(void)" -->
void </td><td class="memItemRight" valign="bottom"><b>CPLPopFinderLocation</b> (void)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a5d1735b5f7aeeed289c5dd699da9acb1"></a><!-- doxytag: member="cpl_conv.h::CPLFinderClean" ref="a5d1735b5f7aeeed289c5dd699da9acb1" args="(void)" -->
void </td><td class="memItemRight" valign="bottom"><b>CPLFinderClean</b> (void)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a95889f0027c30ed79b3a544a6eacf161"></a><!-- doxytag: member="cpl_conv.h::CPLStat" ref="a95889f0027c30ed79b3a544a6eacf161" args="(const char *, VSIStatBuf *)" -->
int </td><td class="memItemRight" valign="bottom"><b>CPLStat</b> (const char *, VSIStatBuf *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">FILE * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#af47485362aca554e37796c352a77fc71">CPLOpenShared</a> (const char *, const char *, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a1afd2c936bbf27a74b02ae6dcadf25a7">CPLCloseShared</a> (FILE *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="structCPLSharedFileInfo.html">CPLSharedFileInfo</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#ad102985b0ae1672d3d2cf3a4ea8aea4a">CPLGetSharedList</a> (int *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#aa7709a32d13e10f2c6c28a176b5a8784">CPLDumpSharedList</a> (FILE *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7f693923cfd3d171adb34420f09f7891"></a><!-- doxytag: member="cpl_conv.h::CPLDMSToDec" ref="a7f693923cfd3d171adb34420f09f7891" args="(const char *is)" -->
double </td><td class="memItemRight" valign="bottom"><b>CPLDMSToDec</b> (const char *is)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a679f0d2bbc965bcc8d29b56f5210f16b"></a><!-- doxytag: member="cpl_conv.h::CPLDecToDMS" ref="a679f0d2bbc965bcc8d29b56f5210f16b" args="(double dfAngle, const char *pszAxis, int nPrecision)" -->
const char * </td><td class="memItemRight" valign="bottom"><b>CPLDecToDMS</b> (double dfAngle, const char *pszAxis, int nPrecision)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#aa4ffc8fd25881635e18d1a53e177a8e1">CPLPackedDMSToDec</a> (double)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#a97b69cc886a1a5c9618612d8205600e4">CPLDecToPackedDMS</a> (double dfDec)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af4d09dcf679de60fdc2262a3a864fae7"></a><!-- doxytag: member="cpl_conv.h::CPLStringToComplex" ref="af4d09dcf679de60fdc2262a3a864fae7" args="(const char *pszString, double *pdfReal, double *pdfImag)" -->
void </td><td class="memItemRight" valign="bottom"><b>CPLStringToComplex</b> (const char *pszString, double *pdfReal, double *pdfImag)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__conv_8h.html#aa786ff8dd95ea5b2b641de9ed53cb277">CPLUnlinkTree</a> (const char *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ad357816a8e3713a7070e299764b236f7"></a><!-- doxytag: member="cpl_conv.h::CPLCopyFile" ref="ad357816a8e3713a7070e299764b236f7" args="(const char *pszNewPath, const char *pszOldPath)" -->
int </td><td class="memItemRight" valign="bottom"><b>CPLCopyFile</b> (const char *pszNewPath, const char *pszOldPath)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a2802d9321457b38b3318955c4042f3b9"></a><!-- doxytag: member="cpl_conv.h::CPLMoveFile" ref="a2802d9321457b38b3318955c4042f3b9" args="(const char *pszNewPath, const char *pszOldPath)" -->
int </td><td class="memItemRight" valign="bottom"><b>CPLMoveFile</b> (const char *pszNewPath, const char *pszOldPath)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Various convenience functions for CPL. </p>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="afb5bf88066f997b1ab3b3911f5e9b722"></a><!-- doxytag: member="cpl_conv.h::CPLAtof" ref="afb5bf88066f997b1ab3b3911f5e9b722" args="(const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">double CPLAtof </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>nptr</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Converts ASCII string to floating point number.</p>
<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>
<p>CPLStrtod(nptr, (char **)NULL);</p>
<p>This function does the same as standard atof(3), but does not take locale in account. That means, the decimal delimiter is always '.' (decimal point). Use <a class="el" href="cpl__conv_8h.html#a0a01ca071035c36d4b4f85336e08c5d5">CPLAtofDelim()</a> function if you want to specify custom delimiter.</p>
<p>IMPORTANT NOTE. Existance of this function does not mean you should always use it. Sometimes you should use standard locale aware atof(3) and its family. When you need to process the user's input (for example, command line parameters) use atof(3), because user works in localized environment and her input will be done accordingly the locale set. In particular that means we should not make assumptions about character used as decimal delimiter, it can be either "." or ",". But when you are parsing some ASCII file in predefined format, you most likely need <a class="el" href="cpl__conv_8h.html#afb5bf88066f997b1ab3b3911f5e9b722">CPLAtof()</a>, because such files distributed across the systems with different locales and floating point representation shoudl be considered as a part of file format. If the format uses "." as a delimiter the same character must be used when parsing number regardless of actual locale setting.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>nptr</em> </td><td>Pointer to string to convert.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Converted value, if any. </dd></dl>
<p>References <a class="el" href="cpl__strtod_8cpp_source.html#l00110">CPLAtof()</a>, and <a class="el" href="cpl__strtod_8cpp_source.html#l00270">CPLStrtod()</a>.</p>
<p>Referenced by <a class="el" href="cpl__strtod_8cpp_source.html#l00110">CPLAtof()</a>, <a class="el" href="cpl__conv_8cpp_source.html#l00921">CPLScanDouble()</a>, and <a class="el" href="gdal__rpc_8cpp_source.html#l00333">GDALCreateRPCTransformer()</a>.</p>
</div>
</div>
<a class="anchor" id="a0a01ca071035c36d4b4f85336e08c5d5"></a><!-- doxytag: member="cpl_conv.h::CPLAtofDelim" ref="a0a01ca071035c36d4b4f85336e08c5d5" 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 * </td>
<td class="paramname"> <em>nptr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char </td>
<td class="paramname"> <em>point</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Converts ASCII string to floating point number.</p>
<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>
<p>CPLStrtodDelim(nptr, (char **)NULL, point);</p>
<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#afb5bf88066f997b1ab3b3911f5e9b722">CPLAtof()</a> function.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>nptr</em> </td><td>Pointer to string to convert. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>point</em> </td><td>Decimal delimiter.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Converted value, if any. </dd></dl>
<p>References <a class="el" href="cpl__strtod_8cpp_source.html#l00068">CPLAtofDelim()</a>, and <a class="el" href="cpl__strtod_8cpp_source.html#l00223">CPLStrtodDelim()</a>.</p>
<p>Referenced by <a class="el" href="cpl__strtod_8cpp_source.html#l00068">CPLAtofDelim()</a>.</p>
</div>
</div>
<a class="anchor" id="aa07cd1b2aa5e76eb67ba952440198796"></a><!-- doxytag: member="cpl_conv.h::CPLAtofM" ref="aa07cd1b2aa5e76eb67ba952440198796" 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 * </td>
<td class="paramname"> <em>nptr</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Converts ASCII string to floating point number using any numeric locale.</p>
<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>
<p>PS. The M stands for Multi-lingual.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>nptr</em> </td><td>The string to convert.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Converted value, if any. Zero on failure. </dd></dl>
<p>References <a class="el" href="cpl__strtod_8cpp_source.html#l00135">CPLAtofM()</a>, and <a class="el" href="cpl__strtod_8cpp_source.html#l00223">CPLStrtodDelim()</a>.</p>
<p>Referenced by <a class="el" href="cpl__strtod_8cpp_source.html#l00135">CPLAtofM()</a>, <a class="el" href="gdal__misc_8cpp_source.html#l01121">GDALLoadWorldFile()</a>, <a class="el" href="gdalrasterband_8cpp_source.html#l01606">GDALRasterBand::GetMaximum()</a>, and <a class="el" href="gdalrasterband_8cpp_source.html#l01689">GDALRasterBand::GetMinimum()</a>.</p>
</div>
</div>
<a class="anchor" id="a5b990672a0221115c9b54a8931554136"></a><!-- doxytag: member="cpl_conv.h::CPLCalloc" ref="a5b990672a0221115c9b54a8931554136" 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 </td>
<td class="paramname"> <em>nCount</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>nSize</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Safe version of calloc().</p>
<p>This function is like the C library calloc(), but raises a CE_Fatal error with CPLError() 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#a5b990672a0221115c9b54a8931554136">CPLCalloc()</a> as well. CPLFree() or VSIFree() can be used free memory allocated by <a class="el" href="cpl__conv_8h.html#a5b990672a0221115c9b54a8931554136">CPLCalloc()</a>.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>nCount</em> </td><td>number of objects to allocate. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nSize</em> </td><td>size (in bytes) of object to allocate. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>pointer to newly allocated memory, only NULL if nSize * nCount is NULL. </dd></dl>
</div>
</div>
<a class="anchor" id="afa9b8f28ae84d5d898b7a3afc6bb6a4b"></a><!-- doxytag: member="cpl_conv.h::CPLCheckForFile" ref="afa9b8f28ae84d5d898b7a3afc6bb6a4b" args="(char *pszFilename, char **papszSiblingList)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CPLCheckForFile </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>pszFilename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>papszSiblingFiles</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Check for file existance.</p>
<p>The function checks if a named file exists in the filesystem, hopefully in an efficient fashion if a sibling file list is available. It exists primarily to do faster file checking for functions like GDAL open methods that get a list of files from the target directory.</p>
<p>If the sibling file list exists (is not NULL) it is assumed to be a list of files in the same directory as the target file, and it will be checked (case insensitively) for a match. If a match is found, pszFilename is updated with the correct case and TRUE is returned.</p>
<p>If papszSiblingFiles is NULL, a <a class="el" href="cpl__vsi_8h.html#ac92fbd5e6fc143b026001b32c4c19ed1" title="Get filesystem object info.">VSIStatL()</a> is used to test for the files existance, and no case insensitive testing is done.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszFilename</em> </td><td>name of file to check for - filename case updated in some cases. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>papszSiblingFiles</em> </td><td>a list of files in the same directory as pszFilename if available, or NULL. This list should have no path components.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>TRUE if a match is found, or FALSE if not. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00210">CPLGetFilename()</a>, and <a class="el" href="cpl__vsil_8cpp_source.html#l00226">VSIStatL()</a>.</p>
</div>
</div>
<a class="anchor" id="ac8ed75603810ed09726ebff3463ba80b"></a><!-- doxytag: member="cpl_conv.h::CPLCleanTrailingSlash" ref="ac8ed75603810ed09726ebff3463ba80b" 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 * </td>
<td class="paramname"> <em>pszPath</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Remove trailing forward/backward slash from the path for unix/windows resp.</p>
<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><dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszPath</em> </td><td>the path to be cleaned up</td></tr>
</table>
</dd>
</dl>
<dl class="return"><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>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00785">CPLCleanTrailingSlash()</a>.</p>
<p>Referenced by <a class="el" href="cpl__path_8cpp_source.html#l00785">CPLCleanTrailingSlash()</a>.</p>
</div>
</div>
<a class="anchor" id="a1afd2c936bbf27a74b02ae6dcadf25a7"></a><!-- doxytag: member="cpl_conv.h::CPLCloseShared" ref="a1afd2c936bbf27a74b02ae6dcadf25a7" args="(FILE *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CPLCloseShared </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>Close shared file.</p>
<p>Dereferences the indicated file handle, and closes it if the reference count has dropped to zero. A CPLError() is issued if the file is not in the shared file list.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>fp</em> </td><td>file handle from <a class="el" href="cpl__conv_8h.html#af47485362aca554e37796c352a77fc71">CPLOpenShared()</a> to deaccess. </td></tr>
</table>
</dd>
</dl>
<p>References <a class="el" href="cpl__vsil_8cpp_source.html#l00301">VSIFCloseL()</a>.</p>
</div>
</div>
<a class="anchor" id="a7e9657e7ff077fabbc25a41219a8f8ce"></a><!-- doxytag: member="cpl_conv.h::CPLCorrespondingPaths" ref="a7e9657e7ff077fabbc25a41219a8f8ce" args="(const char *pszOldFilename, const char *pszNewFilename, char **papszFileList)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char** CPLCorrespondingPaths </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszOldFilename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszNewFilename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>papszFileList</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Identify corresponding paths.</p>
<p>Given a prototype old and new filename this function will attempt to determine corresponding names for a set of other old filenames that will rename them in a similar manner. This correspondance assumes there are two possibly kinds of renaming going on. A change of path, and a change of filename stem.</p>
<p>If a consistent renaming cannot be established for all the files this function will return indicating an error.</p>
<p>The returned file list becomes owned by the caller and should be destroyed with <a class="el" href="cpl__string_8h.html#a5a39b9c5896a273cc6f06c1d5be93238">CSLDestroy()</a>.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszOldFilename</em> </td><td>path to old prototype file. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszNewFilename</em> </td><td>path to new prototype file. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>papszFileList</em> </td><td>list of other files associated with pszOldFilename to rename similarly.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a list of files corresponding to papszFileList but renamed to correspond to pszNewFilename. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00833">CPLCorrespondingPaths()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00439">CPLFormFilename()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00242">CPLGetBasename()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00210">CPLGetFilename()</a>, and <a class="el" href="cpl__path_8cpp_source.html#l00110">CPLGetPath()</a>.</p>
<p>Referenced by <a class="el" href="gdaldriver_8cpp_source.html#l00943">GDALDriver::CopyFiles()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00833">CPLCorrespondingPaths()</a>, and <a class="el" href="gdaldriver_8cpp_source.html#l00836">GDALDriver::Rename()</a>.</p>
</div>
</div>
<a class="anchor" id="a97b69cc886a1a5c9618612d8205600e4"></a><!-- doxytag: member="cpl_conv.h::CPLDecToPackedDMS" ref="a97b69cc886a1a5c9618612d8205600e4" 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 </td>
<td class="paramname"> <em>dfDec</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Convert decimal degrees into packed DMS value (DDDMMMSSS.SS).</p>
<p>This function converts a value, specified in decimal degrees into packed DMS angle. The standard packed DMS format is:</p>
<p>degrees * 1000000 + minutes * 1000 + seconds</p>
<p>See also <a class="el" href="cpl__conv_8h.html#aa4ffc8fd25881635e18d1a53e177a8e1">CPLPackedDMSToDec()</a>.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dfDec</em> </td><td>Angle in decimal degrees.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Angle in packed DMS format. </dd></dl>
</div>
</div>
<a class="anchor" id="aa7709a32d13e10f2c6c28a176b5a8784"></a><!-- doxytag: member="cpl_conv.h::CPLDumpSharedList" ref="aa7709a32d13e10f2c6c28a176b5a8784" args="(FILE *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CPLDumpSharedList </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>Report open shared files.</p>
<p>Dumps all open shared files to the indicated file handle. If the file handle is NULL information is sent via the CPLDebug() call.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>fp</em> </td><td>File handle to write to. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a1f558377064b63f76eefb4065368f8e2"></a><!-- doxytag: member="cpl_conv.h::CPLExtractRelativePath" ref="a1f558377064b63f76eefb4065368f8e2" args="(const char *, const char *, int *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLExtractRelativePath </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszBaseDir</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszTarget</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>pbGotRelative</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get relative path from directory to target file.</p>
<p>Computes a relative path for pszTarget relative to pszBaseDir. Currently this only works if they share a common base path. The returned path is normally into the pszTarget string. It should only be considered valid as long as pszTarget is valid or till the next call to this function, whichever comes first.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszBaseDir</em> </td><td>the name of the directory relative to which the path should be computed. pszBaseDir may be NULL in which case the original target is returned without relitivizing.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszTarget</em> </td><td>the filename to be changed to be relative to pszBaseDir.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pbGotRelative</em> </td><td>Pointer to location in which a flag is placed indicating that the returned path is relative to the basename (TRUE) or not (FALSE). This pointer may be NULL if flag is not desired.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>an adjusted path or the original if it could not be made relative to the pszBaseFile's path. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00688">CPLExtractRelativePath()</a>, and <a class="el" href="cpl__path_8cpp_source.html#l00110">CPLGetPath()</a>.</p>
<p>Referenced by <a class="el" href="cpl__path_8cpp_source.html#l00688">CPLExtractRelativePath()</a>.</p>
</div>
</div>
<a class="anchor" id="a98e99149a5cb64a79c6a683dc4a4efe2"></a><!-- doxytag: member="cpl_conv.h::CPLFGets" ref="a98e99149a5cb64a79c6a683dc4a4efe2" args="(char *, int, FILE *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* CPLFGets </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>pszBuffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nBufferSize</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">FILE * </td>
<td class="paramname"> <em>fp</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Reads in at most one less than nBufferSize characters from the fp stream and stores them into the buffer pointed to by pszBuffer. Reading stops after an EOF or a newline. If a newline is read, it is _not_ stored into the buffer. A '\0' is stored after the last character in the buffer. All three types of newline terminators recognized by the <a class="el" href="cpl__conv_8h.html#a98e99149a5cb64a79c6a683dc4a4efe2">CPLFGets()</a>: single '\r' and '\n' and '\r\n' combination.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszBuffer</em> </td><td>pointer to the targeting character buffer. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nBufferSize</em> </td><td>maximum size of the string to read (not including termonating '\0'). </td></tr>
<tr><td valign="top"></td><td valign="top"><em>fp</em> </td><td>file pointer to read from. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>pointer to the pszBuffer containing a string read from the file or NULL if the error or end of file was encountered. </dd></dl>
</div>
</div>
<a class="anchor" id="a9c76b24b06830f0da04fe076177f9ff3"></a><!-- doxytag: member="cpl_conv.h::CPLFormCIFilename" ref="a9c76b24b06830f0da04fe076177f9ff3" args="(const char *pszPath, const char *pszBasename, const char *pszExtension)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLFormCIFilename </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszPath</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszBasename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszExtension</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Case insensitive file searching, returing full path.</p>
<p>This function tries to return the path to a file regardless of whether the file exactly matches the basename, and extension case, or is all upper case, or all lower case. The path is treated as case sensitive. This function is equivelent to <a class="el" href="cpl__conv_8h.html#aee0f81afed5b1b31da1b401822c7a2fb">CPLFormFilename()</a> on case insensitive file systems (like Windows).</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszPath</em> </td><td>directory path to the directory containing the file. This may be relative or absolute, and may have a trailing path separator or not. May be NULL.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszBasename</em> </td><td>file basename. May optionally have path and/or extension. May not be NULL.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszExtension</em> </td><td>file extension, optionally including the period. May be NULL.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a fully formed filename in an internal static string. Do not modify or free the returned string. The string may be destroyed by the next CPL call. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00505">CPLFormCIFilename()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00439">CPLFormFilename()</a>, and <a class="el" href="cpl__vsil_8cpp_source.html#l00226">VSIStatL()</a>.</p>
<p>Referenced by <a class="el" href="cpl__path_8cpp_source.html#l00505">CPLFormCIFilename()</a>.</p>
</div>
</div>
<a class="anchor" id="aee0f81afed5b1b31da1b401822c7a2fb"></a><!-- doxytag: member="cpl_conv.h::CPLFormFilename" ref="aee0f81afed5b1b31da1b401822c7a2fb" args="(const char *pszPath, const char *pszBasename, const char *pszExtension)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLFormFilename </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszPath</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszBasename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszExtension</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Build a full file path from a passed path, file basename and extension.</p>
<p>The path, and extension are optional. The basename may in fact contain an extension if desired.</p>
<pre>
CPLFormFilename("abc/xyz","def", ".dat" ) == "abc/xyz/def.dat"
CPLFormFilename(NULL,"def", NULL ) == "def"
CPLFormFilename(NULL,"abc/def.dat", NULL ) == "abc/def.dat"
CPLFormFilename("/abc/xyz/","def.dat", NULL ) == "/abc/xyz/def.dat"
</pre><dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszPath</em> </td><td>directory path to the directory containing the file. This may be relative or absolute, and may have a trailing path separator or not. May be NULL.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszBasename</em> </td><td>file basename. May optionally have path and/or extension. May not be NULL.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszExtension</em> </td><td>file extension, optionally including the period. May be NULL.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a fully formed filename in an internal static string. Do not modify or free the returned string. The string may be destroyed by the next CPL call. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00439">CPLFormFilename()</a>.</p>
<p>Referenced by <a class="el" href="gdaldrivermanager_8cpp_source.html#l00533">GDALDriverManager::AutoLoadDrivers()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00833">CPLCorrespondingPaths()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00505">CPLFormCIFilename()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00439">CPLFormFilename()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00933">CPLGenerateTempFilename()</a>, <a class="el" href="cpl__conv_8cpp_source.html#l01919">CPLUnlinkTree()</a>, and <a class="el" href="gdal__misc_8cpp_source.html#l01802">GDALGeneralCmdLineProcessor()</a>.</p>
</div>
</div>
<a class="anchor" id="aaadfd84593d3f707630eb06b520b7dbf"></a><!-- doxytag: member="cpl_conv.h::CPLGenerateTempFilename" ref="aaadfd84593d3f707630eb06b520b7dbf" args="(const char *pszStem)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLGenerateTempFilename </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszStem</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Generate temporary file name.</p>
<p>Returns a filename that may be used for a temporary file. The location of the file tries to follow operating system semantics but may be forced via the CPL_TMPDIR configuration option.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszStem</em> </td><td>if non-NULL this will be part of the filename.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a filename which is valid till the next CPL call in this thread. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00439">CPLFormFilename()</a>, and <a class="el" href="cpl__path_8cpp_source.html#l00933">CPLGenerateTempFilename()</a>.</p>
<p>Referenced by <a class="el" href="cpl__path_8cpp_source.html#l00933">CPLGenerateTempFilename()</a>.</p>
</div>
</div>
<a class="anchor" id="a913ec8c102e1dd312d9447cd815a8673"></a><!-- doxytag: member="cpl_conv.h::CPLGetBasename" ref="a913ec8c102e1dd312d9447cd815a8673" args="(const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLGetBasename </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszFullFilename</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Extract basename (non-directory, non-extension) portion of filename.</p>
<p>Returns a string containing the file basename portion of the passed name. If there is no basename (passed value ends in trailing directory separator, or filename starts with a dot) an empty string is returned.</p>
<pre>
CPLGetBasename( "abc/def.xyz" ) == "def"
CPLGetBasename( "abc/def" ) == "def"
CPLGetBasename( "abc/def/" ) == ""
</pre><dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszFullFilename</em> </td><td>the full filename potentially including a path.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>just the non-directory, non-extension portion of the path in an internal string which must not be freed. The string may be destroyed by the next CPL filename handling call. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00242">CPLGetBasename()</a>.</p>
<p>Referenced by <a class="el" href="gdaldrivermanager_8cpp_source.html#l00533">GDALDriverManager::AutoLoadDrivers()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00833">CPLCorrespondingPaths()</a>, and <a class="el" href="cpl__path_8cpp_source.html#l00242">CPLGetBasename()</a>.</p>
</div>
</div>
<a class="anchor" id="afc51f03a3789be8a47b8a753eb897856"></a><!-- doxytag: member="cpl_conv.h::CPLGetCurrentDir" ref="afc51f03a3789be8a47b8a753eb897856" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* CPLGetCurrentDir </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the current working directory name.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>a pointer to buffer, containing current working directory path or NULL in case of error. User is responsible to free that buffer after usage with CPLFree() function. If HAVE_GETCWD macro is not defined, the function returns NULL. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00327">CPLGetCurrentDir()</a>.</p>
<p>Referenced by <a class="el" href="cpl__path_8cpp_source.html#l00327">CPLGetCurrentDir()</a>.</p>
</div>
</div>
<a class="anchor" id="a3c6f71eaf9b8e8f98242af533752d1bb"></a><!-- doxytag: member="cpl_conv.h::CPLGetDirname" ref="a3c6f71eaf9b8e8f98242af533752d1bb" args="(const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLGetDirname </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszFilename</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Extract directory path portion of filename.</p>
<p>Returns a string containing the directory path portion of the passed filename. If there is no path in the passed filename the dot will be returned. It is the only difference from <a class="el" href="cpl__conv_8h.html#a4cd11a5f67bb4816342301fa8a5990a0">CPLGetPath()</a>.</p>
<pre>
CPLGetDirname( "abc/def.xyz" ) == "abc"
CPLGetDirname( "/abc/def/" ) == "/abc/def"
CPLGetDirname( "/" ) == "/"
CPLGetDirname( "/abc/def" ) == "/abc"
CPLGetDirname( "abc" ) == "."
</pre><dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszFilename</em> </td><td>the filename potentially including a path.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><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>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00162">CPLGetDirname()</a>.</p>
<p>Referenced by <a class="el" href="gdaldrivermanager_8cpp_source.html#l00533">GDALDriverManager::AutoLoadDrivers()</a>, and <a class="el" href="cpl__path_8cpp_source.html#l00162">CPLGetDirname()</a>.</p>
</div>
</div>
<a class="anchor" id="a5325c900de0918020b747ed07d98da24"></a><!-- doxytag: member="cpl_conv.h::CPLGetExecPath" ref="a5325c900de0918020b747ed07d98da24" args="(char *pszPathBuf, int nMaxLength)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CPLGetExecPath </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>pszPathBuf</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLength</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Fetch path of executable.</p>
<p>The path to the executable currently running is returned. This path includes the name of the executable. Currently this only works on win32 platform.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszPathBuf</em> </td><td>the buffer into which the path is placed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLength</em> </td><td>the buffer size, MAX_PATH+1 is suggested.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>FALSE on failure or TRUE on success. </dd></dl>
<p>References <a class="el" href="cpl__getexecpath_8cpp_source.html#l00077">CPLGetExecPath()</a>.</p>
<p>Referenced by <a class="el" href="gdaldrivermanager_8cpp_source.html#l00533">GDALDriverManager::AutoLoadDrivers()</a>, and <a class="el" href="cpl__getexecpath_8cpp_source.html#l00077">CPLGetExecPath()</a>.</p>
</div>
</div>
<a class="anchor" id="ae46fcfcea1b2e8c24738542613ba4752"></a><!-- doxytag: member="cpl_conv.h::CPLGetExtension" ref="ae46fcfcea1b2e8c24738542613ba4752" args="(const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLGetExtension </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszFullFilename</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Extract filename extension from full filename.</p>
<p>Returns a string containing the extention portion of the passed name. If there is no extension (the filename has no dot) an empty string is returned. The returned extension will not include the period.</p>
<pre>
CPLGetExtension( "abc/def.xyz" ) == "xyz"
CPLGetExtension( "abc/def" ) == ""
</pre><dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszFullFilename</em> </td><td>the full filename potentially including a path.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>just the extension portion of the path in an internal string which must not be freed. The string may be destroyed by the next CPL filename handling call. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00292">CPLGetExtension()</a>.</p>
<p>Referenced by <a class="el" href="gdaldrivermanager_8cpp_source.html#l00533">GDALDriverManager::AutoLoadDrivers()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00292">CPLGetExtension()</a>, and <a class="el" href="gdal__misc_8cpp_source.html#l01222">GDALReadWorldFile()</a>.</p>
</div>
</div>
<a class="anchor" id="ae67694bcaaaa43f046325994e3413bac"></a><!-- doxytag: member="cpl_conv.h::CPLGetFilename" ref="ae67694bcaaaa43f046325994e3413bac" args="(const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLGetFilename </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszFullFilename</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Extract non-directory portion of filename.</p>
<p>Returns a string containing the bare filename portion of the passed filename. If there is no filename (passed value ends in trailing directory separator) an empty string is returned.</p>
<pre>
CPLGetFilename( "abc/def.xyz" ) == "def.xyz"
CPLGetFilename( "/abc/def/" ) == ""
CPLGetFilename( "abc/def" ) == "def"
</pre><dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszFullFilename</em> </td><td>the full filename potentially including a path.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>just the non-directory portion of the path (points back into original string). </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00210">CPLGetFilename()</a>.</p>
<p>Referenced by <a class="el" href="cpl__conv_8cpp_source.html#l02142">CPLCheckForFile()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00833">CPLCorrespondingPaths()</a>, and <a class="el" href="cpl__path_8cpp_source.html#l00210">CPLGetFilename()</a>.</p>
</div>
</div>
<a class="anchor" id="a4cd11a5f67bb4816342301fa8a5990a0"></a><!-- doxytag: member="cpl_conv.h::CPLGetPath" ref="a4cd11a5f67bb4816342301fa8a5990a0" args="(const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLGetPath </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszFilename</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Extract directory path portion of filename.</p>
<p>Returns a string containing the directory path portion of the passed filename. If there is no path in the passed filename an empty string will be returned (not NULL).</p>
<pre>
CPLGetPath( "abc/def.xyz" ) == "abc"
CPLGetPath( "/abc/def/" ) == "/abc/def"
CPLGetPath( "/" ) == "/"
CPLGetPath( "/abc/def" ) == "/abc"
CPLGetPath( "abc" ) == ""
</pre><dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszFilename</em> </td><td>the filename potentially including a path.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><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>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00110">CPLGetPath()</a>.</p>
<p>Referenced by <a class="el" href="cpl__path_8cpp_source.html#l00833">CPLCorrespondingPaths()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00688">CPLExtractRelativePath()</a>, <a class="el" href="cpl__path_8cpp_source.html#l00110">CPLGetPath()</a>, and <a class="el" href="vrtdataset_8cpp_source.html#l00106">VRTDataset::FlushCache()</a>.</p>
</div>
</div>
<a class="anchor" id="ad102985b0ae1672d3d2cf3a4ea8aea4a"></a><!-- doxytag: member="cpl_conv.h::CPLGetSharedList" ref="ad102985b0ae1672d3d2cf3a4ea8aea4a" args="(int *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structCPLSharedFileInfo.html">CPLSharedFileInfo</a>* CPLGetSharedList </td>
<td>(</td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>pnCount</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Fetch list of open shared files.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pnCount</em> </td><td>place to put the count of entries.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the pointer to the first in the array of shared file info structures. </dd></dl>
</div>
</div>
<a class="anchor" id="a0c8e54bbbdd75f6315fe2fafd3d5259f"></a><!-- doxytag: member="cpl_conv.h::CPLGetSymbol" ref="a0c8e54bbbdd75f6315fe2fafd3d5259f" args="(const char *, const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void * CPLGetSymbol </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszLibrary</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszSymbolName</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Fetch a function pointer from a shared library / DLL.</p>
<p>This function is meant to abstract access to shared libraries and DLLs and performs functions similar to dlopen()/dlsym() on Unix and LoadLibrary() / GetProcAddress() on Windows.</p>
<p>If no support for loading entry points from a shared library is available this function will always return NULL. Rules on when this function issues a CPLError() or not are not currently well defined, and will have to be resolved in the future.</p>
<p>Currently <a class="el" href="cpl__conv_8h.html#a0c8e54bbbdd75f6315fe2fafd3d5259f">CPLGetSymbol()</a> doesn't try to: </p>
<ul>
<li>
prevent the reference count on the library from going up for every request, or given any opportunity to unload the library. </li>
<li>
Attempt to look for the library in non-standard locations. </li>
<li>
Attempt to try variations on the symbol name, like pre-prending or post-pending an underscore. </li>
</ul>
<p>Some of these issues may be worked on in the future.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszLibrary</em> </td><td>the name of the shared library or DLL containing the function. May contain path to file. If not system supplies search paths will be used. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszSymbolName</em> </td><td>the name of the function to fetch a pointer to. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A pointer to the function if found, or NULL if the function isn't found, or the shared library can't be loaded. </dd></dl>
<p>References <a class="el" href="cplgetsymbol_8cpp_source.html#l00188">CPLGetSymbol()</a>.</p>
<p>Referenced by <a class="el" href="gdaldrivermanager_8cpp_source.html#l00533">GDALDriverManager::AutoLoadDrivers()</a>, and <a class="el" href="cplgetsymbol_8cpp_source.html#l00188">CPLGetSymbol()</a>.</p>
</div>
</div>
<a class="anchor" id="a0cd8ae8d760125ec5b01958a776691ec"></a><!-- doxytag: member="cpl_conv.h::CPLIsFilenameRelative" ref="a0cd8ae8d760125ec5b01958a776691ec" args="(const char *pszFilename)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CPLIsFilenameRelative </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszFilename</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Is filename relative or absolute?</p>
<p>The test is filesystem convention agnostic. That is it will test for Unix style and windows style path conventions regardless of the actual system in use.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszFilename</em> </td><td>the filename with path to test.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>TRUE if the filename is relative or FALSE if it is absolute. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00648">CPLIsFilenameRelative()</a>.</p>
<p>Referenced by <a class="el" href="cpl__path_8cpp_source.html#l00648">CPLIsFilenameRelative()</a>, and <a class="el" href="cpl__path_8cpp_source.html#l00599">CPLProjectRelativeFilename()</a>.</p>
</div>
</div>
<a class="anchor" id="a9ebcdb25fc6ff90b0c7b01733d5ae6d3"></a><!-- doxytag: member="cpl_conv.h::CPLMalloc" ref="a9ebcdb25fc6ff90b0c7b01733d5ae6d3" args="(size_t)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* CPLMalloc </td>
<td>(</td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>nSize</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Safe version of malloc().</p>
<p>This function is like the C library malloc(), but raises a CE_Fatal error with CPLError() 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 VSIMalloc() to get the memory, so any hooking of VSIMalloc() will apply to <a class="el" href="cpl__conv_8h.html#a9ebcdb25fc6ff90b0c7b01733d5ae6d3">CPLMalloc()</a> as well. CPLFree() or VSIFree() can be used free memory allocated by <a class="el" href="cpl__conv_8h.html#a9ebcdb25fc6ff90b0c7b01733d5ae6d3">CPLMalloc()</a>.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>nSize</em> </td><td>size (in bytes) of memory block to allocate. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>pointer to newly allocated memory, only NULL if nSize is zero. </dd></dl>
</div>
</div>
<a class="anchor" id="af47485362aca554e37796c352a77fc71"></a><!-- doxytag: member="cpl_conv.h::CPLOpenShared" ref="af47485362aca554e37796c352a77fc71" args="(const char *, const char *, int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">FILE* CPLOpenShared </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszFilename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszAccess</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>bLarge</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Open a shared file handle.</p>
<p>Some operating systems have limits on the number of file handles that can be open at one time. This function attempts to maintain a registry of already open file handles, and reuse existing ones if the same file is requested by another part of the application.</p>
<p>Note that access is only shared for access types "r", "rb", "r+" and "rb+". All others will just result in direct VSIOpen() calls. Keep in mind that a file is only reused if the file name is exactly the same. Different names referring to the same file will result in different handles.</p>
<p>The VSIFOpen() or <a class="el" href="cpl__vsi_8h.html#a48b5fab6cc22a9d0a543c095ee358634" title="Open file.">VSIFOpenL()</a> function is used to actually open the file, when an existing file handle can't be shared.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszFilename</em> </td><td>the name of the file to open. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszAccess</em> </td><td>the normal fopen()/VSIFOpen() style access string. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>bLarge</em> </td><td>If TRUE <a class="el" href="cpl__vsi_8h.html#a48b5fab6cc22a9d0a543c095ee358634" title="Open file.">VSIFOpenL()</a> (for large files) will be used instead of VSIFOpen().</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a file handle or NULL if opening fails. </dd></dl>
<p>References <a class="el" href="cpl__vsil_8cpp_source.html#l00273">VSIFOpenL()</a>.</p>
</div>
</div>
<a class="anchor" id="aa4ffc8fd25881635e18d1a53e177a8e1"></a><!-- doxytag: member="cpl_conv.h::CPLPackedDMSToDec" ref="aa4ffc8fd25881635e18d1a53e177a8e1" args="(double)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">double CPLPackedDMSToDec </td>
<td>(</td>
<td class="paramtype">double </td>
<td class="paramname"> <em>dfPacked</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Convert a packed DMS value (DDDMMMSSS.SS) into decimal degrees.</p>
<p>This function converts a packed DMS angle to seconds. The standard packed DMS format is:</p>
<p>degrees * 1000000 + minutes * 1000 + seconds</p>
<p>Example: ang = 120025045.25 yields deg = 120 min = 25 sec = 45.25</p>
<p>The algorithm used for the conversion is as follows:</p>
<p>1. The absolute value of the angle is used.</p>
<p>2. The degrees are separated out: deg = ang/1000000 (fractional portion truncated)</p>
<p>3. The minutes are separated out: min = (ang - deg * 1000000) / 1000 (fractional portion truncated)</p>
<p>4. The seconds are then computed: sec = ang - deg * 1000000 - min * 1000</p>
<p>5. The total angle in seconds is computed: sec = deg * 3600.0 + min * 60.0 + sec</p>
<p>6. The sign of sec is set to that of the input angle.</p>
<p>Packed DMS values used by the USGS GCTP package and probably by other software.</p>
<p>NOTE: This code does not validate input value. If you give the wrong value, you will get the wrong result.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dfPacked</em> </td><td>Angle in packed DMS format.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Angle in decimal degrees. </dd></dl>
</div>
</div>
<a class="anchor" id="ad77e478b4f2e14cc03ae23a9c81434c9"></a><!-- doxytag: member="cpl_conv.h::CPLPrintDouble" ref="ad77e478b4f2e14cc03ae23a9c81434c9" args="(char *, const char *, double, const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CPLPrintDouble </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>pszBuffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszFormat</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"> <em>dfValue</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszLocale</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Print double value into specified string buffer. Exponential character flag 'E' (or 'e') will be replaced with 'D', as in Fortran. Resulting string will not to be NULL-terminated.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszBuffer</em> </td><td>Pointer to the destination string buffer. Should be large enough to hold the resulting string. Note, that the string will not be NULL-terminated, so user should do this himself, if needed.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszFormat</em> </td><td>Format specifier (for example, "%16.9E").</td></tr>
<tr><td valign="top"></td><td valign="top"><em>dfValue</em> </td><td>Numerical value to print.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszLocale</em> </td><td>Pointer to a character string containing locale name ("C", "POSIX", "us_US", "ru_RU.KOI8-R" etc.). If NULL we will not manipulate with locale settings and current process locale will be used for printing. With the pszLocale option we can control what exact locale will be used for printing a numeric value to the string (in most cases it should be C/POSIX).</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of characters printed. </dd></dl>
</div>
</div>
<a class="anchor" id="a33618500e56ec12e6775b3ed9014b8fb"></a><!-- doxytag: member="cpl_conv.h::CPLPrintInt32" ref="a33618500e56ec12e6775b3ed9014b8fb" args="(char *, GInt32, int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CPLPrintInt32 </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>pszBuffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">GInt32 </td>
<td class="paramname"> <em>iValue</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLen</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Print GInt32 value into specified string buffer. This string will not be NULL-terminated.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszBuffer</em> </td><td>Pointer to the destination string buffer. Should be large enough to hold the resulting string. Note, that the string will not be NULL-terminated, so user should do this himself, if needed.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>iValue</em> </td><td>Numerical value to print.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLen</em> </td><td>Maximum length of the resulting string. If string length is greater than nMaxLen, it will be truncated.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of characters printed. </dd></dl>
</div>
</div>
<a class="anchor" id="af268becc479787ae48bb2607d0000886"></a><!-- doxytag: member="cpl_conv.h::CPLPrintPointer" ref="af268becc479787ae48bb2607d0000886" args="(char *, void *, int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CPLPrintPointer </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>pszBuffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>pValue</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLen</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Print pointer value into specified string buffer. This string will not be NULL-terminated.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszBuffer</em> </td><td>Pointer to the destination string buffer. Should be large enough to hold the resulting string. Note, that the string will not be NULL-terminated, so user should do this himself, if needed.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pValue</em> </td><td>Pointer to ASCII encode.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLen</em> </td><td>Maximum length of the resulting string. If string length is greater than nMaxLen, it will be truncated.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of characters printed. </dd></dl>
</div>
</div>
<a class="anchor" id="ae284b3e504edca3eb1eaf568469d61ba"></a><!-- doxytag: member="cpl_conv.h::CPLPrintString" ref="ae284b3e504edca3eb1eaf568469d61ba" args="(char *, const char *, int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CPLPrintString </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>pszDest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszSrc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLen</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Copy the string pointed to by pszSrc, NOT including the terminating `\0' character, to the array pointed to by pszDest.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszDest</em> </td><td>Pointer to the destination string buffer. Should be large enough to hold the resulting string.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszSrc</em> </td><td>Pointer to the source buffer.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLen</em> </td><td>Maximum length of the resulting string. If string length is greater than nMaxLen, it will be truncated.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of characters printed. </dd></dl>
</div>
</div>
<a class="anchor" id="a0bdbcb209eb9b8e2e6be4fa6e0b750f6"></a><!-- doxytag: member="cpl_conv.h::CPLPrintStringFill" ref="a0bdbcb209eb9b8e2e6be4fa6e0b750f6" args="(char *, const char *, int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CPLPrintStringFill </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>pszDest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszSrc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLen</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Copy the string pointed to by pszSrc, NOT including the terminating `\0' character, to the array pointed to by pszDest. Remainder of the destination string will be filled with space characters. This is only difference from the PrintString().</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszDest</em> </td><td>Pointer to the destination string buffer. Should be large enough to hold the resulting string.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszSrc</em> </td><td>Pointer to the source buffer.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLen</em> </td><td>Maximum length of the resulting string. If string length is greater than nMaxLen, it will be truncated.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of characters printed. </dd></dl>
</div>
</div>
<a class="anchor" id="a5be9cf1de05769139a77339ffb970ce4"></a><!-- doxytag: member="cpl_conv.h::CPLPrintTime" ref="a5be9cf1de05769139a77339ffb970ce4" args="(char *, int, const char *, const struct tm *, const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CPLPrintTime </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>pszBuffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszFormat</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const struct tm * </td>
<td class="paramname"> <em>poBrokenTime</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszLocale</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Print specified time value accordingly to the format options and specified locale name. This function does following:</p>
<ul>
<li>if locale parameter is not NULL, the current locale setting will be stored and replaced with the specified one;</li>
<li>format time value with the strftime(3) function;</li>
<li>restore back current locale, if was saved.</li>
</ul>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszBuffer</em> </td><td>Pointer to the destination string buffer. Should be large enough to hold the resulting string. Note, that the string will not be NULL-terminated, so user should do this himself, if needed.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLen</em> </td><td>Maximum length of the resulting string. If string length is greater than nMaxLen, it will be truncated.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszFormat</em> </td><td>Controls the output format. Options are the same as for strftime(3) function.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>poBrokenTime</em> </td><td>Pointer to the broken-down time structure. May be requested with the VSIGMTime() and VSILocalTime() functions.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszLocale</em> </td><td>Pointer to a character string containing locale name ("C", "POSIX", "us_US", "ru_RU.KOI8-R" etc.). If NULL we will not manipulate with locale settings and current process locale will be used for printing. Be aware that it may be unsuitable to use current locale for printing time, because all names will be printed in your native language, as well as time format settings also may be ajusted differently from the C/POSIX defaults. To solve these problems this option was introdiced.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of characters printed. </dd></dl>
</div>
</div>
<a class="anchor" id="a13ca1da1151489f1eee7770296f164aa"></a><!-- doxytag: member="cpl_conv.h::CPLPrintUIntBig" ref="a13ca1da1151489f1eee7770296f164aa" args="(char *, GUIntBig, int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CPLPrintUIntBig </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>pszBuffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">GUIntBig </td>
<td class="paramname"> <em>iValue</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLen</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Print GUIntBig value into specified string buffer. This string will not be NULL-terminated.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszBuffer</em> </td><td>Pointer to the destination string buffer. Should be large enough to hold the resulting string. Note, that the string will not be NULL-terminated, so user should do this himself, if needed.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>iValue</em> </td><td>Numerical value to print.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLen</em> </td><td>Maximum length of the resulting string. If string length is greater than nMaxLen, it will be truncated.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of characters printed. </dd></dl>
</div>
</div>
<a class="anchor" id="acb7cd6067d35796aa1af144e5a4283b4"></a><!-- doxytag: member="cpl_conv.h::CPLProjectRelativeFilename" ref="acb7cd6067d35796aa1af144e5a4283b4" args="(const char *pszProjectDir, const char *pszSecondaryFilename)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLProjectRelativeFilename </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszProjectDir</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszSecondaryFilename</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Find a file relative to a project file.</p>
<p>Given the path to a "project" directory, and a path to a secondary file referenced from that project, build a path to the secondary file that the current application can use. If the secondary path is already absolute, rather than relative, then it will be returned unaltered.</p>
<p>Examples: </p>
<pre>
CPLProjectRelativeFilename("abc/def","tmp/abc.gif") == "abc/def/tmp/abc.gif"
CPLProjectRelativeFilename("abc/def","/tmp/abc.gif") == "/tmp/abc.gif"
CPLProjectRelativeFilename("/xy", "abc.gif") == "/xy/abc.gif"
CPLProjectRelativeFilename("/abc/def","../abc.gif") == "/abc/def/../abc.gif"
CPLProjectRelativeFilename("C:\WIN","abc.gif") == "C:\WIN\abc.gif"
</pre><dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszProjectDir</em> </td><td>the directory relative to which the secondary files path should be interpreted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszSecondaryFilename</em> </td><td>the filename (potentially with path) that is to be interpreted relative to the project directory.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a composed path to the secondary file. The returned string is internal and should not be altered, freed, or depending on past the next CPL call. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00648">CPLIsFilenameRelative()</a>, and <a class="el" href="cpl__path_8cpp_source.html#l00599">CPLProjectRelativeFilename()</a>.</p>
<p>Referenced by <a class="el" href="cpl__path_8cpp_source.html#l00599">CPLProjectRelativeFilename()</a>.</p>
</div>
</div>
<a class="anchor" id="a0ad35dbadd4f1d04bbedd66774be940f"></a><!-- doxytag: member="cpl_conv.h::CPLReadLine" ref="a0ad35dbadd4f1d04bbedd66774be940f" args="(FILE *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLReadLine </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>Simplified line reading from text file.</p>
<p>Read a line of text from the given file handle, taking care to capture CR and/or LF and strip off ... equivelent of DKReadLine(). Pointer to an internal buffer is returned. The application shouldn't free it, or depend on it's value past the next call to <a class="el" href="cpl__conv_8h.html#a0ad35dbadd4f1d04bbedd66774be940f">CPLReadLine()</a>.</p>
<p>Note that <a class="el" href="cpl__conv_8h.html#a0ad35dbadd4f1d04bbedd66774be940f">CPLReadLine()</a> uses VSIFGets(), so any hooking of VSI file services should apply to <a class="el" href="cpl__conv_8h.html#a0ad35dbadd4f1d04bbedd66774be940f">CPLReadLine()</a> as well.</p>
<p><a class="el" href="cpl__conv_8h.html#a0ad35dbadd4f1d04bbedd66774be940f">CPLReadLine()</a> maintains an internal buffer, which will appear as a single block memory leak in some circumstances. <a class="el" href="cpl__conv_8h.html#a0ad35dbadd4f1d04bbedd66774be940f">CPLReadLine()</a> may be called with a NULL FILE * at any time to free this working buffer.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>fp</em> </td><td>file pointer opened with VSIFOpen().</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>pointer to an internal buffer containing a line of text read from the file or NULL if the end of file was encountered. </dd></dl>
</div>
</div>
<a class="anchor" id="a88612c88fb41db8a7e38c0f09c4042c9"></a><!-- doxytag: member="cpl_conv.h::CPLReadLineL" ref="a88612c88fb41db8a7e38c0f09c4042c9" args="(FILE *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLReadLineL </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>Simplified line reading from text file.</p>
<p>Similar to <a class="el" href="cpl__conv_8h.html#a0ad35dbadd4f1d04bbedd66774be940f">CPLReadLine()</a>, but reading from a large file API handle.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>fp</em> </td><td>file pointer opened with <a class="el" href="cpl__vsi_8h.html#a48b5fab6cc22a9d0a543c095ee358634" title="Open file.">VSIFOpenL()</a>.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>pointer to an internal buffer containing a line of text read from the file or NULL if the end of file was encountered. </dd></dl>
<p>References <a class="el" href="cpl__vsil_8cpp_source.html#l00431">VSIFReadL()</a>, <a class="el" href="cpl__vsil_8cpp_source.html#l00333">VSIFSeekL()</a>, and <a class="el" href="cpl__vsil_8cpp_source.html#l00361">VSIFTellL()</a>.</p>
</div>
</div>
<a class="anchor" id="a6861a37c19e925ee0aa8d5b10ee13147"></a><!-- doxytag: member="cpl_conv.h::CPLRealloc" ref="a6861a37c19e925ee0aa8d5b10ee13147" args="(void *, size_t)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* CPLRealloc </td>
<td>(</td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>pData</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>nNewSize</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Safe version of realloc().</p>
<p>This function is like the C library realloc(), but raises a CE_Fatal error with CPLError() 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 VSIRealloc() to get the memory, so any hooking of VSIRealloc() will apply to <a class="el" href="cpl__conv_8h.html#a6861a37c19e925ee0aa8d5b10ee13147">CPLRealloc()</a> as well. CPLFree() or VSIFree() can be used free memory allocated by <a class="el" href="cpl__conv_8h.html#a6861a37c19e925ee0aa8d5b10ee13147">CPLRealloc()</a>.</p>
<p>It is also safe to pass NULL in as the existing memory block for <a class="el" href="cpl__conv_8h.html#a6861a37c19e925ee0aa8d5b10ee13147">CPLRealloc()</a>, in which case it uses VSIMalloc() to allocate a new block.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pData</em> </td><td>existing memory block which should be copied to the new block. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nNewSize</em> </td><td>new size (in bytes) of memory block to allocate. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>pointer to allocated memory, only NULL if nNewSize is zero. </dd></dl>
</div>
</div>
<a class="anchor" id="a637fddebebefc776e5c657bcc7366b89"></a><!-- doxytag: member="cpl_conv.h::CPLResetExtension" ref="a637fddebebefc776e5c657bcc7366b89" args="(const char *, const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLResetExtension </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszPath</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszExt</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Replace the extension with the provided one.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszPath</em> </td><td>the input path, this string is not altered. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszExt</em> </td><td>the new extension to apply to the given path.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>an altered filename with the new extension. Do not modify or free the returned string. The string may be destroyed by the next CPL call. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00367">CPLResetExtension()</a>.</p>
<p>Referenced by <a class="el" href="cpl__path_8cpp_source.html#l00367">CPLResetExtension()</a>, <a class="el" href="gdal__misc_8cpp_source.html#l01222">GDALReadWorldFile()</a>, and <a class="el" href="gdal__misc_8cpp_source.html#l01343">GDALWriteWorldFile()</a>.</p>
</div>
</div>
<a class="anchor" id="abcdeae39a61518c9c31ecc593eeff621"></a><!-- doxytag: member="cpl_conv.h::CPLScanDouble" ref="abcdeae39a61518c9c31ecc593eeff621" args="(const char *, int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">double CPLScanDouble </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszString</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLength</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Extract double from string.</p>
<p>Scan up to a maximum number of characters from a string and convert the result to a double. This function uses <a class="el" href="cpl__conv_8h.html#afb5bf88066f997b1ab3b3911f5e9b722">CPLAtof()</a> to convert string to double value, so it uses a comma as a decimal delimiter.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszString</em> </td><td>String containing characters to be scanned. It may be terminated with a null character.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLength</em> </td><td>The maximum number of character to consider as part of the number. Less characters will be considered if a null character is encountered.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Double value, converted from its ASCII form. </dd></dl>
<p>References <a class="el" href="cpl__strtod_8cpp_source.html#l00110">CPLAtof()</a>.</p>
</div>
</div>
<a class="anchor" id="a338bbe67c148d2555861eb5563b17303"></a><!-- doxytag: member="cpl_conv.h::CPLScanLong" ref="a338bbe67c148d2555861eb5563b17303" args="(const char *, int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">long CPLScanLong </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszString</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLength</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Scan up to a maximum number of characters from a string and convert the result to a long.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszString</em> </td><td>String containing characters to be scanned. It may be terminated with a null character.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLength</em> </td><td>The maximum number of character to consider as part of the number. Less characters will be considered if a null character is encountered.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Long value, converted from its ASCII form. </dd></dl>
</div>
</div>
<a class="anchor" id="a2dea859a1f5690d25e5eb32f8d091905"></a><!-- doxytag: member="cpl_conv.h::CPLScanPointer" ref="a2dea859a1f5690d25e5eb32f8d091905" args="(const char *, int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* CPLScanPointer </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszString</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLength</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Extract pointer from string.</p>
<p>Scan up to a maximum number of characters from a string and convert the result to a pointer.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszString</em> </td><td>String containing characters to be scanned. It may be terminated with a null character.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLength</em> </td><td>The maximum number of character to consider as part of the number. Less characters will be considered if a null character is encountered.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>pointer value, converted from its ASCII form. </dd></dl>
</div>
</div>
<a class="anchor" id="a9c2ddf6a8bdb1a9bf2e90e7acbea2cdc"></a><!-- doxytag: member="cpl_conv.h::CPLScanString" ref="a9c2ddf6a8bdb1a9bf2e90e7acbea2cdc" args="(const char *, int, int, int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* CPLScanString </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszString</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>bTrimSpaces</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>bNormalize</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Scan up to a maximum number of characters from a given string, allocate a buffer for a new string and fill it with scanned characters.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszString</em> </td><td>String containing characters to be scanned. It may be terminated with a null character.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLength</em> </td><td>The maximum number of character to read. Less characters will be read if a null character is encountered.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>bTrimSpaces</em> </td><td>If TRUE, trim ending spaces from the input string. Character considered as empty using isspace(3) function.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>bNormalize</em> </td><td>If TRUE, replace ':' symbol with the '_'. It is needed if resulting string will be used in CPL dictionaries.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Pointer to the resulting string buffer. Caller responsible to free this buffer with CPLFree(). </dd></dl>
</div>
</div>
<a class="anchor" id="ab4a8e6cf7a0d0f662f6cd4555b074bb5"></a><!-- doxytag: member="cpl_conv.h::CPLScanUIntBig" ref="ab4a8e6cf7a0d0f662f6cd4555b074bb5" args="(const char *, int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GUIntBig CPLScanUIntBig </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszString</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLength</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Extract big integer from string.</p>
<p>Scan up to a maximum number of characters from a string and convert the result to a GUIntBig.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszString</em> </td><td>String containing characters to be scanned. It may be terminated with a null character.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLength</em> </td><td>The maximum number of character to consider as part of the number. Less characters will be considered if a null character is encountered.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GUIntBig value, converted from its ASCII form. </dd></dl>
</div>
</div>
<a class="anchor" id="ac6e9643c26ab4ee22df95e3dd18c959a"></a><!-- doxytag: member="cpl_conv.h::CPLScanULong" ref="ac6e9643c26ab4ee22df95e3dd18c959a" args="(const char *, int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">unsigned long CPLScanULong </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszString</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nMaxLength</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Scan up to a maximum number of characters from a string and convert the result to a unsigned long.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszString</em> </td><td>String containing characters to be scanned. It may be terminated with a null character.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>nMaxLength</em> </td><td>The maximum number of character to consider as part of the number. Less characters will be considered if a null character is encountered.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Unsigned long value, converted from its ASCII form. </dd></dl>
</div>
</div>
<a class="anchor" id="a464d6861faf9f6272317d160a3ad9a81"></a><!-- doxytag: member="cpl_conv.h::CPLStrdup" ref="a464d6861faf9f6272317d160a3ad9a81" args="(const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* CPLStrdup </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszString</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Safe version of strdup() function.</p>
<p>This function is similar to the C library strdup() function, but if the memory allocation fails it will issue a CE_Fatal error with CPLError() instead of returning NULL. It uses VSIStrdup(), so any hooking of that function will apply to <a class="el" href="cpl__conv_8h.html#a464d6861faf9f6272317d160a3ad9a81">CPLStrdup()</a> as well. Memory allocated with <a class="el" href="cpl__conv_8h.html#a464d6861faf9f6272317d160a3ad9a81">CPLStrdup()</a> can be freed with CPLFree() or VSIFree().</p>
<p>It is also safe to pass a NULL string into <a class="el" href="cpl__conv_8h.html#a464d6861faf9f6272317d160a3ad9a81">CPLStrdup()</a>. <a class="el" href="cpl__conv_8h.html#a464d6861faf9f6272317d160a3ad9a81">CPLStrdup()</a> will allocate and return a zero length string (as opposed to a NULL string).</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszString</em> </td><td>input string to be duplicated. May be NULL. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>pointer to a newly allocated copy of the string. Free with CPLFree() or VSIFree(). </dd></dl>
</div>
</div>
<a class="anchor" id="a1dac5cfc5a7e9dbcf511b461812d89b9"></a><!-- doxytag: member="cpl_conv.h::CPLStrlwr" ref="a1dac5cfc5a7e9dbcf511b461812d89b9" args="(char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* CPLStrlwr </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>pszString</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Convert each characters of the string to lower case.</p>
<p>For example, "ABcdE" will be converted to "abcde". This function is locale dependent.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszString</em> </td><td>input string to be converted. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>pointer to the same string, pszString. </dd></dl>
</div>
</div>
<a class="anchor" id="a2388e43fb089a354eb3583016b2a3b00"></a><!-- doxytag: member="cpl_conv.h::CPLStrtod" ref="a2388e43fb089a354eb3583016b2a3b00" args="(const char *, char **)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">double CPLStrtod </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>nptr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>endptr</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Converts ASCII string to floating point number.</p>
<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 strtod(3), but does not take locale in account. That means, the decimal delimiter is always '.' (decimal point). Use <a class="el" href="cpl__conv_8h.html#ac96c5f1823c54ef96b5783208c817817">CPLStrtodDelim()</a> function if you want to specify custom delimiter. Also see notes for <a class="el" href="cpl__conv_8h.html#afb5bf88066f997b1ab3b3911f5e9b722">CPLAtof()</a> function.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>nptr</em> </td><td>Pointer to string to convert. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>endptr</em> </td><td>If is not NULL, a pointer to the character after the last character used in the conversion is stored in the location referenced by endptr.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Converted value, if any. </dd></dl>
<p>References <a class="el" href="cpl__strtod_8cpp_source.html#l00270">CPLStrtod()</a>, and <a class="el" href="cpl__strtod_8cpp_source.html#l00223">CPLStrtodDelim()</a>.</p>
<p>Referenced by <a class="el" href="cpl__strtod_8cpp_source.html#l00110">CPLAtof()</a>, <a class="el" href="cpl__strtod_8cpp_source.html#l00270">CPLStrtod()</a>, and <a class="el" href="gdaldriver_8cpp_source.html#l01169">GDALValidateCreationOptions()</a>.</p>
</div>
</div>
<a class="anchor" id="ac96c5f1823c54ef96b5783208c817817"></a><!-- doxytag: member="cpl_conv.h::CPLStrtodDelim" ref="ac96c5f1823c54ef96b5783208c817817" args="(const char *, char **, char)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">double CPLStrtodDelim </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>nptr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>endptr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char </td>
<td class="paramname"> <em>point</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Converts ASCII string to floating point number using specified delimiter.</p>
<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 strtod(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#afb5bf88066f997b1ab3b3911f5e9b722">CPLAtof()</a> function.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>nptr</em> </td><td>Pointer to string to convert. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>endptr</em> </td><td>If is not NULL, a pointer to the character after the last character used in the conversion is stored in the location referenced by endptr. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>point</em> </td><td>Decimal delimiter.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Converted value, if any. </dd></dl>
<p>References <a class="el" href="cpl__strtod_8cpp_source.html#l00223">CPLStrtodDelim()</a>.</p>
<p>Referenced by <a class="el" href="cpl__strtod_8cpp_source.html#l00068">CPLAtofDelim()</a>, <a class="el" href="cpl__strtod_8cpp_source.html#l00135">CPLAtofM()</a>, <a class="el" href="cpl__strtod_8cpp_source.html#l00270">CPLStrtod()</a>, <a class="el" href="cpl__strtod_8cpp_source.html#l00223">CPLStrtodDelim()</a>, and <a class="el" href="cpl__strtod_8cpp_source.html#l00296">CPLStrtofDelim()</a>.</p>
</div>
</div>
<a class="anchor" id="a1ccda187ed172fd6e33cd98223328531"></a><!-- doxytag: member="cpl_conv.h::CPLStrtof" ref="a1ccda187ed172fd6e33cd98223328531" args="(const char *, char **)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float CPLStrtof </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>nptr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>endptr</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Converts ASCII string to floating point number.</p>
<p>This function converts the initial portion of the string pointed to by nptr to single floating point representation. This function does the same as standard strtof(3), but does not take locale in account. That means, the decimal delimiter is always '.' (decimal point). Use <a class="el" href="cpl__conv_8h.html#a3a102a1417c98a242900fb8c0076fc1b">CPLStrtofDelim()</a> function if you want to specify custom delimiter. Also see notes for <a class="el" href="cpl__conv_8h.html#afb5bf88066f997b1ab3b3911f5e9b722">CPLAtof()</a> function.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>nptr</em> </td><td>Pointer to string to convert. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>endptr</em> </td><td>If is not NULL, a pointer to the character after the last character used in the conversion is stored in the location referenced by endptr.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Converted value, if any. </dd></dl>
<p>References <a class="el" href="cpl__strtod_8cpp_source.html#l00351">CPLStrtof()</a>, and <a class="el" href="cpl__strtod_8cpp_source.html#l00296">CPLStrtofDelim()</a>.</p>
<p>Referenced by <a class="el" href="cpl__strtod_8cpp_source.html#l00351">CPLStrtof()</a>.</p>
</div>
</div>
<a class="anchor" id="a3a102a1417c98a242900fb8c0076fc1b"></a><!-- doxytag: member="cpl_conv.h::CPLStrtofDelim" ref="a3a102a1417c98a242900fb8c0076fc1b" args="(const char *, char **, char)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float CPLStrtofDelim </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>nptr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>endptr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char </td>
<td class="paramname"> <em>point</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Converts ASCII string to floating point number using specified delimiter.</p>
<p>This function converts the initial portion of the string pointed to by nptr to single floating point representation. This function does the same as standard strtof(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#afb5bf88066f997b1ab3b3911f5e9b722">CPLAtof()</a> function.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>nptr</em> </td><td>Pointer to string to convert. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>endptr</em> </td><td>If is not NULL, a pointer to the character after the last character used in the conversion is stored in the location referenced by endptr. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>point</em> </td><td>Decimal delimiter.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Converted value, if any. </dd></dl>
<p>References <a class="el" href="cpl__strtod_8cpp_source.html#l00223">CPLStrtodDelim()</a>, and <a class="el" href="cpl__strtod_8cpp_source.html#l00296">CPLStrtofDelim()</a>.</p>
<p>Referenced by <a class="el" href="cpl__strtod_8cpp_source.html#l00351">CPLStrtof()</a>, and <a class="el" href="cpl__strtod_8cpp_source.html#l00296">CPLStrtofDelim()</a>.</p>
</div>
</div>
<a class="anchor" id="aa786ff8dd95ea5b2b641de9ed53cb277"></a><!-- doxytag: member="cpl_conv.h::CPLUnlinkTree" ref="aa786ff8dd95ea5b2b641de9ed53cb277" args="(const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CPLUnlinkTree </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszPath</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="return"><dt><b>Returns:</b></dt><dd>0 on successful completion, -1 if function fails. </dd></dl>
<p>References <a class="el" href="cpl__path_8cpp_source.html#l00439">CPLFormFilename()</a>, <a class="el" href="cpl__vsil_8cpp_source.html#l00193">VSIRmdir()</a>, and <a class="el" href="cpl__vsil_8cpp_source.html#l00133">VSIUnlink()</a>.</p>
</div>
</div>
</div>
<hr>
Generated for GDAL by
<a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.6.2-20100208.
</body>
</html>
