<!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_string.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_string.h File Reference</h1><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/>
<code>#include "<a class="el" href="cpl__conv_8h_source.html">cpl_conv.h</a>"</code><br/>
<code>#include <string></code><br/>
<p><a href="cpl__string_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">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classCPLString.html">CPLString</a></td></tr>
<tr><td colspan="2"><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a2338aada58f9282979f68e527f5aeb03"></a><!-- doxytag: member="cpl_string.h::CSLT_HONOURSTRINGS" ref="a2338aada58f9282979f68e527f5aeb03" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CSLT_HONOURSTRINGS</b> 0x0001</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a2cf4a54c9dc07fb312ff0f0d143048cc"></a><!-- doxytag: member="cpl_string.h::CSLT_ALLOWEMPTYTOKENS" ref="a2cf4a54c9dc07fb312ff0f0d143048cc" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CSLT_ALLOWEMPTYTOKENS</b> 0x0002</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ada6b937d227431e8076ec35294a3cb56"></a><!-- doxytag: member="cpl_string.h::CSLT_PRESERVEQUOTES" ref="ada6b937d227431e8076ec35294a3cb56" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CSLT_PRESERVEQUOTES</b> 0x0004</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a8aace221e37b023221866198770ffe50"></a><!-- doxytag: member="cpl_string.h::CSLT_PRESERVEESCAPES" ref="a8aace221e37b023221866198770ffe50" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CSLT_PRESERVEESCAPES</b> 0x0008</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3abb7b31dfa10f4480f4ada48db2cd5b"></a><!-- doxytag: member="cpl_string.h::CSLT_STRIPLEADSPACES" ref="a3abb7b31dfa10f4480f4ada48db2cd5b" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CSLT_STRIPLEADSPACES</b> 0x0010</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af45f2f4c3d953ab2bf6594ac042a265b"></a><!-- doxytag: member="cpl_string.h::CSLT_STRIPENDSPACES" ref="af45f2f4c3d953ab2bf6594ac042a265b" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CSLT_STRIPENDSPACES</b> 0x0020</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a4d69daceff916c28ef0c65506d89d6d3"></a><!-- doxytag: member="cpl_string.h::CPLES_BackslashQuotable" ref="a4d69daceff916c28ef0c65506d89d6d3" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPLES_BackslashQuotable</b> 0</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7f5479acb68fb882fed8bada7b92db15"></a><!-- doxytag: member="cpl_string.h::CPLES_XML" ref="a7f5479acb68fb882fed8bada7b92db15" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPLES_XML</b> 1</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a88296f14572ad5a724fb512357fddb03"></a><!-- doxytag: member="cpl_string.h::CPLES_URL" ref="a88296f14572ad5a724fb512357fddb03" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPLES_URL</b> 2</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a90614c3cf4cdd748e063f9c2cf669246"></a><!-- doxytag: member="cpl_string.h::CPLES_SQL" ref="a90614c3cf4cdd748e063f9c2cf669246" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPLES_SQL</b> 3</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aa3347d20cc965ec42e25bc285a763ea9"></a><!-- doxytag: member="cpl_string.h::CPLES_CSV" ref="aa3347d20cc965ec42e25bc285a763ea9" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPLES_CSV</b> 4</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a87d8ea35a911bef8e5bd3e851043d959"></a><!-- doxytag: member="cpl_string.h::CPL_ENC_LOCALE" ref="a87d8ea35a911bef8e5bd3e851043d959" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPL_ENC_LOCALE</b> ""</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a26d8bd24304461e94dd5a407576c6f42"></a><!-- doxytag: member="cpl_string.h::CPL_ENC_UTF8" ref="a26d8bd24304461e94dd5a407576c6f42" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPL_ENC_UTF8</b> "UTF-8"</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a8bc6144aae9925e22d6476e8df3ae937"></a><!-- doxytag: member="cpl_string.h::CPL_ENC_UTF16" ref="a8bc6144aae9925e22d6476e8df3ae937" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPL_ENC_UTF16</b> "UTF-16"</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a04aab58c768a810389f63c3de7867b50"></a><!-- doxytag: member="cpl_string.h::CPL_ENC_UCS2" ref="a04aab58c768a810389f63c3de7867b50" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPL_ENC_UCS2</b> "UCS-2"</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a134294ed95e8c77931dc817146449aa7"></a><!-- doxytag: member="cpl_string.h::CPL_ENC_UCS4" ref="a134294ed95e8c77931dc817146449aa7" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPL_ENC_UCS4</b> "UCS-4"</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="adcc150659994a7c7d66a5ed64ed4ff9b"></a><!-- doxytag: member="cpl_string.h::CPL_ENC_ASCII" ref="adcc150659994a7c7d66a5ed64ed4ff9b" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPL_ENC_ASCII</b> "ASCII"</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a82b2de9456d43c67ba3eeeb9e2ca239b"></a><!-- doxytag: member="cpl_string.h::CPL_ENC_ISO8859_1" ref="a82b2de9456d43c67ba3eeeb9e2ca239b" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>CPL_ENC_ISO8859_1</b> "ISO-8859-1"</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ad0d030c6e3c0a6d298306a0c9b812f29"></a><!-- doxytag: member="cpl_string.h::std_string" ref="ad0d030c6e3c0a6d298306a0c9b812f29" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>std_string</b> std::string</td></tr>
<tr><td colspan="2"><h2>Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b>CPLValueType</b> { <b>CPL_VALUE_STRING</b>,
<b>CPL_VALUE_REAL</b>,
<b>CPL_VALUE_INTEGER</b>
}</td></tr>
<tr><td colspan="2"><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a324b647df7638ffd3b1ad61392e3e057"></a><!-- doxytag: member="cpl_string.h::CSLAddString" ref="a324b647df7638ffd3b1ad61392e3e057" args="(char **papszStrList, const char *pszNewString)" -->
char ** </td><td class="memItemRight" valign="bottom"><b>CSLAddString</b> (char **papszStrList, const char *pszNewString)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#ac1ffd0e5baf9729f09388a38c07f5835">CSLCount</a> (char **papszStrList)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a41484b9e79baf47b540bd4160f2ac661"></a><!-- doxytag: member="cpl_string.h::CSLGetField" ref="a41484b9e79baf47b540bd4160f2ac661" args="(char **, int)" -->
const char * </td><td class="memItemRight" valign="bottom"><b>CSLGetField</b> (char **, int)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#a5a39b9c5896a273cc6f06c1d5be93238">CSLDestroy</a> (char **papszStrList)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char ** </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#a8b9c9ad6c5a416c91f1fca55d9a91701">CSLDuplicate</a> (char **papszStrList)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char ** </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#ad2766cf9f275a413c46ac4f7fa749be7">CSLMerge</a> (char **papszOrig, char **papszOverride)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Merge two lists. <a href="#ad2766cf9f275a413c46ac4f7fa749be7"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="addf1c1b43c085a351fd241ec0775a298"></a><!-- doxytag: member="cpl_string.h::CSLTokenizeString" ref="addf1c1b43c085a351fd241ec0775a298" args="(const char *pszString)" -->
char ** </td><td class="memItemRight" valign="bottom"><b>CSLTokenizeString</b> (const char *pszString)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a54182bb1d51f205d2bd252c46ee7ade3"></a><!-- doxytag: member="cpl_string.h::CSLTokenizeStringComplex" ref="a54182bb1d51f205d2bd252c46ee7ade3" args="(const char *pszString, const char *pszDelimiter, int bHonourStrings, int bAllowEmptyTokens)" -->
char ** </td><td class="memItemRight" valign="bottom"><b>CSLTokenizeStringComplex</b> (const char *pszString, const char *pszDelimiter, int bHonourStrings, int bAllowEmptyTokens)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char ** </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#a36f1e4efb0da65e3d900d3a0ce8cbaab">CSLTokenizeString2</a> (const char *pszString, const char *pszDelimeter, int nCSLTFlags)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a574bbe82f32ba1b80da40f24e0b5103e"></a><!-- doxytag: member="cpl_string.h::CSLPrint" ref="a574bbe82f32ba1b80da40f24e0b5103e" args="(char **papszStrList, FILE *fpOut)" -->
int </td><td class="memItemRight" valign="bottom"><b>CSLPrint</b> (char **papszStrList, FILE *fpOut)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char ** </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#ad7af0a270dc019a17bf1326da8e6a970">CSLLoad</a> (const char *pszFname)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ad5a20acd37e7b5d1239f2be228f14f3e"></a><!-- doxytag: member="cpl_string.h::CSLSave" ref="ad5a20acd37e7b5d1239f2be228f14f3e" args="(char **papszStrList, const char *pszFname)" -->
int </td><td class="memItemRight" valign="bottom"><b>CSLSave</b> (char **papszStrList, const char *pszFname)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a86e011718c751cac6b3d56dfea299150"></a><!-- doxytag: member="cpl_string.h::CSLInsertStrings" ref="a86e011718c751cac6b3d56dfea299150" args="(char **papszStrList, int nInsertAtLineNo, char **papszNewLines)" -->
char ** </td><td class="memItemRight" valign="bottom"><b>CSLInsertStrings</b> (char **papszStrList, int nInsertAtLineNo, char **papszNewLines)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a821f8de347986f15357d927dc6e6eba1"></a><!-- doxytag: member="cpl_string.h::CSLInsertString" ref="a821f8de347986f15357d927dc6e6eba1" args="(char **papszStrList, int nInsertAtLineNo, const char *pszNewLine)" -->
char ** </td><td class="memItemRight" valign="bottom"><b>CSLInsertString</b> (char **papszStrList, int nInsertAtLineNo, const char *pszNewLine)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ae48ee49e83f74b44f7f3beea072aa75c"></a><!-- doxytag: member="cpl_string.h::CSLRemoveStrings" ref="ae48ee49e83f74b44f7f3beea072aa75c" args="(char **papszStrList, int nFirstLineToDelete, int nNumToRemove, char ***ppapszRetStrings)" -->
char ** </td><td class="memItemRight" valign="bottom"><b>CSLRemoveStrings</b> (char **papszStrList, int nFirstLineToDelete, int nNumToRemove, char ***ppapszRetStrings)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#aadb00ff49c2d9dc32c043ca58fd9d8cd">CSLFindString</a> (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__string_8h.html#aa1211d7957346bdb49bd40a80475615a">CSLPartialFindString</a> (char **papszHaystack, const char *pszNeedle)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#a0901440811294a6a0d6762b6e64107e3">CSLFindName</a> (char **papszStrList, const char *pszName)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#ada798bb0fafd08c7908d0f3716f341b3">CSLTestBoolean</a> (const char *pszValue)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a76fbc85c1d546c07f1ca94e63c025b7c"></a><!-- doxytag: member="cpl_string.h::CSLFetchBoolean" ref="a76fbc85c1d546c07f1ca94e63c025b7c" args="(char **papszStrList, const char *pszKey, int bDefault)" -->
int </td><td class="memItemRight" valign="bottom"><b>CSLFetchBoolean</b> (char **papszStrList, const char *pszKey, int bDefault)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a0447ac47f9c17377494503c84feb0430"></a><!-- doxytag: member="cpl_string.h::CPLSPrintf" ref="a0447ac47f9c17377494503c84feb0430" args="(const char *fmt,...) CPL_PRINT_FUNC_FORMAT(1" -->
const char * </td><td class="memItemRight" valign="bottom"><b>CPLSPrintf</b> (const char *fmt,...) CPL_PRINT_FUNC_FORMAT(1</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a2897c68429d325a421f45e7d57d51d2e"></a><!-- doxytag: member="cpl_string.h::CSLAppendPrintf" ref="a2897c68429d325a421f45e7d57d51d2e" args="(char **papszStrList, const char *fmt,...) CPL_PRINT_FUNC_FORMAT(2" -->
const char *char ** </td><td class="memItemRight" valign="bottom"><b>CSLAppendPrintf</b> (char **papszStrList, const char *fmt,...) CPL_PRINT_FUNC_FORMAT(2</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ad26f8fb891f4795afc8ad9d5427172f7"></a><!-- doxytag: member="cpl_string.h::CPLVASPrintf" ref="ad26f8fb891f4795afc8ad9d5427172f7" args="(char **buf, const char *fmt, va_list args)" -->
const char *char **int </td><td class="memItemRight" valign="bottom"><b>CPLVASPrintf</b> (char **buf, const char *fmt, va_list args)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#a40ff577b83aca84a603414183e6903d3">CPLParseNameValue</a> (const char *pszNameValue, char **ppszKey)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a5ddbcc4a8e541c6183000455f7a3273e"></a><!-- doxytag: member="cpl_string.h::CSLFetchNameValue" ref="a5ddbcc4a8e541c6183000455f7a3273e" args="(char **papszStrList, const char *pszName)" -->
const char * </td><td class="memItemRight" valign="bottom"><b>CSLFetchNameValue</b> (char **papszStrList, const char *pszName)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ad936491d4a23865d56d77fe70247991d"></a><!-- doxytag: member="cpl_string.h::CSLFetchNameValueMultiple" ref="ad936491d4a23865d56d77fe70247991d" args="(char **papszStrList, const char *pszName)" -->
char ** </td><td class="memItemRight" valign="bottom"><b>CSLFetchNameValueMultiple</b> (char **papszStrList, const char *pszName)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a4e6c7234ad43e2fbeec8b7a35d014cbd"></a><!-- doxytag: member="cpl_string.h::CSLAddNameValue" ref="a4e6c7234ad43e2fbeec8b7a35d014cbd" args="(char **papszStrList, const char *pszName, const char *pszValue)" -->
char ** </td><td class="memItemRight" valign="bottom"><b>CSLAddNameValue</b> (char **papszStrList, const char *pszName, const char *pszValue)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char ** </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#a8dbce00a6e7fa4710613e3e4c963dd5d">CSLSetNameValue</a> (char **papszStrList, const char *pszName, const char *pszValue)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#a97b38f55a35f3c1d66ba343692ab9ec0">CSLSetNameValueSeparator</a> (char **papszStrList, const char *pszSeparator)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#adf2c0e5051d8f5c7fc742e4be41e935a">CPLEscapeString</a> (const char *pszString, int nLength, int nScheme)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#a74938e1e92b5847af925600af609f8d3">CPLUnescapeString</a> (const char *pszString, int *pnLength, int nScheme)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#ae683e10df83274c83aefc305cbcf4cba">CPLBinaryToHex</a> (int nBytes, const GByte *pabyData)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GByte * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#aababd56ea0317416780a1acc19aa61a3">CPLHexToBinary</a> (const char *pszHex, int *pnBytes)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">CPLValueType </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#aafb0188f43b0848407f5e6e7c3cfdbb8">CPLGetValueType</a> (const char *pszValue)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a0a6b060ecc0f005f338029f825783fb7"></a><!-- doxytag: member="cpl_string.h::CPLRecode" ref="a0a6b060ecc0f005f338029f825783fb7" args="(const char *pszSource, const char *pszSrcEncoding, const char *pszDstEncoding)" -->
char * </td><td class="memItemRight" valign="bottom"><b>CPLRecode</b> (const char *pszSource, const char *pszSrcEncoding, const char *pszDstEncoding)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#a1717f249d1d23289b634e7cd9336a1ab">CPLRecodeFromWChar</a> (const wchar_t *pwszSource, const char *pszSrcEncoding, const char *pszDstEncoding)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">wchar_t * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#ad889c8d3eb7e71cefe15b7278b7798de">CPLRecodeToWChar</a> (const char *pszSource, const char *pszSrcEncoding, const char *pszDstEncoding)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Various convenience functions for working with strings and string lists.</p>
<p>A StringList is just an array of strings with the last pointer being NULL. An empty StringList may be either a NULL pointer, or a pointer to a pointer memory location with a NULL value.</p>
<p>A common convention for StringLists is to use them to store name/value lists. In this case the contents are treated like a dictionary of name/value pairs. The actual data is formatted with each string having the format "<name>:<value>" (though "=" is also an acceptable separator). A number of the functions in the file operate on name/value style string lists (such as <a class="el" href="cpl__string_8h.html#a8dbce00a6e7fa4710613e3e4c963dd5d">CSLSetNameValue()</a>, and CSLFetchNameValue()). </p>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ae683e10df83274c83aefc305cbcf4cba"></a><!-- doxytag: member="cpl_string.h::CPLBinaryToHex" ref="ae683e10df83274c83aefc305cbcf4cba" args="(int nBytes, const GByte *pabyData)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* CPLBinaryToHex </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nBytes</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const GByte * </td>
<td class="paramname"> <em>pabyData</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Binary to hexadecimal translation.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>nBytes</em> </td><td>number of bytes of binary data in pabyData. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pabyData</em> </td><td>array of data bytes to translate.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>hexadecimal translation, zero terminated. Free with CPLFree(). </dd></dl>
</div>
</div>
<a class="anchor" id="adf2c0e5051d8f5c7fc742e4be41e935a"></a><!-- doxytag: member="cpl_string.h::CPLEscapeString" ref="adf2c0e5051d8f5c7fc742e4be41e935a" args="(const char *pszString, int nLength, int nScheme)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* CPLEscapeString </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszInput</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nScheme</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Apply escaping to string to preserve special characters.</p>
<p>This function will "escape" a variety of special characters to make the string suitable to embed within a string constant or to write within a text stream but in a form that can be reconstitued to it's original form. The escaping will even preserve zero bytes allowing preservation of raw binary data.</p>
<p>CPLES_BackslashQuotable(0): This scheme turns a binary string into a form suitable to be placed within double quotes as a string constant. The backslash, quote, '\0' and newline characters are all escaped in the usual C style.</p>
<p>CPLES_XML(1): This scheme converts the '<', '<' and '&' characters into their XML/HTML equivelent (>, < and &) making a string safe to embed as CDATA within an XML element. The '\0' is not escaped and should not be included in the input.</p>
<p>CPLES_URL(2): Everything except alphanumerics and the underscore are converted to a percent followed by a two digit hex encoding of the character (leading zero supplied if needed). This is the mechanism used for encoding values to be passed in URLs.</p>
<p>CPLES_SQL(3): All single quotes are replaced with two single quotes. Suitable for use when constructing literal values for SQL commands where the literal will be enclosed in single quotes.</p>
<p>CPLES_CSV(4): If the values contains commas, double quotes, or newlines it placed in double quotes, and double quotes in the value are doubled. Suitable for use when constructing field values for .csv files. Note that <a class="el" href="cpl__string_8h.html#a74938e1e92b5847af925600af609f8d3">CPLUnescapeString()</a> currently does not support this format, only <a class="el" href="cpl__string_8h.html#adf2c0e5051d8f5c7fc742e4be41e935a">CPLEscapeString()</a>. See cpl_csv.cpp for csv parsing support.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszInput</em> </td><td>the string to escape. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nLength</em> </td><td>The number of bytes of data to preserve. If this is -1 the strlen(pszString) function will be used to compute the length. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nScheme</em> </td><td>the encoding scheme to use.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>an escaped, zero terminated string that should be freed with CPLFree() when no longer needed. </dd></dl>
</div>
</div>
<a class="anchor" id="aafb0188f43b0848407f5e6e7c3cfdbb8"></a><!-- doxytag: member="cpl_string.h::CPLGetValueType" ref="aafb0188f43b0848407f5e6e7c3cfdbb8" args="(const char *pszValue)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">CPLValueType CPLGetValueType </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszValue</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Detect the type of the value contained in a string, whether it is a real, an integer or a string Leading and trailing spaces are skipped in the analysis.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszValue</em> </td><td>the string to analyze</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>returns the type of the value contained in the string. </dd></dl>
</div>
</div>
<a class="anchor" id="aababd56ea0317416780a1acc19aa61a3"></a><!-- doxytag: member="cpl_string.h::CPLHexToBinary" ref="aababd56ea0317416780a1acc19aa61a3" args="(const char *pszHex, int *pnBytes)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GByte* CPLHexToBinary </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszHex</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>pnBytes</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Hexadecimal to binary translation</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszHex</em> </td><td>the input hex encoded string. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pnBytes</em> </td><td>the returned count of decoded bytes placed here.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>returns binary buffer of data - free with CPLFree(). </dd></dl>
</div>
</div>
<a class="anchor" id="a40ff577b83aca84a603414183e6903d3"></a><!-- doxytag: member="cpl_string.h::CPLParseNameValue" ref="a40ff577b83aca84a603414183e6903d3" args="(const char *pszNameValue, char **ppszKey)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* CPLParseNameValue </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszNameValue</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>ppszKey</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parse NAME=VALUE string into name and value components.</p>
<p>Note that if ppszKey is non-NULL, the key (or name) portion will be allocated using VSIMalloc(), and returned in that pointer. It is the applications responsibility to free this string, but the application should not modify or free the returned value portion.</p>
<p>This function also support "NAME:VALUE" strings and will strip white space from around the delimeter when forming name and value strings.</p>
<p>Eventually CSLFetchNameValue() and friends may be modified to use <a class="el" href="cpl__string_8h.html#a40ff577b83aca84a603414183e6903d3">CPLParseNameValue()</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>pszNameValue</em> </td><td>string in "NAME=VALUE" format. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ppszKey</em> </td><td>optional pointer though which to return the name portion. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the value portion (pointing into original string). </dd></dl>
</div>
</div>
<a class="anchor" id="a1717f249d1d23289b634e7cd9336a1ab"></a><!-- doxytag: member="cpl_string.h::CPLRecodeFromWChar" ref="a1717f249d1d23289b634e7cd9336a1ab" args="(const wchar_t *pwszSource, const char *pszSrcEncoding, const char *pszDstEncoding)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* CPLRecodeFromWChar </td>
<td>(</td>
<td class="paramtype">const wchar_t * </td>
<td class="paramname"> <em>pwszSource</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszSrcEncoding</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszDstEncoding</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Convert wchar_t string to UTF-8.</p>
<p>Convert a wchar_t string into a multibyte utf-8 string. The only guaranteed supported source encoding is CPL_ENC_UCS2, and the only guaranteed supported destination encodings are CPL_ENC_UTF8, CPL_ENC_ASCII and CPL_ENC_ISO8859_1. In some cases (ie. using iconv()) other encodings may also be supported.</p>
<p>Note that the wchar_t type varies in size on different systems. On win32 it is normally 2 bytes, and on unix 4 bytes.</p>
<p>If an error occurs an error may, or may not be posted with CPLError().</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pwszSource</em> </td><td>the source wchar_t string, terminated with a 0 wchar_t. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszSrcEncoding</em> </td><td>the source encoding, typically CPL_ENC_UCS2. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszDstEncoding</em> </td><td>the destination encoding, typically CPL_ENC_UTF8.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a zero terminated multi-byte string which should be freed with CPLFree(), or NULL if an error occurs. </dd></dl>
</div>
</div>
<a class="anchor" id="ad889c8d3eb7e71cefe15b7278b7798de"></a><!-- doxytag: member="cpl_string.h::CPLRecodeToWChar" ref="ad889c8d3eb7e71cefe15b7278b7798de" args="(const char *pszSource, const char *pszSrcEncoding, const char *pszDstEncoding)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">wchar_t* CPLRecodeToWChar </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszSource</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszSrcEncoding</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszDstEncoding</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Convert UTF-8 string to a wchar_t string.</p>
<p>Convert a 8bit, multi-byte per character input string into a wide character (wchar_t) string. The only guaranteed supported source encodings are CPL_ENC_UTF8, CPL_ENC_ASCII and CPL_ENC_ISO8869_1 (LATIN1). The only guaranteed supported destination encoding is CPL_ENC_UCS2. Other source and destination encodings may be supported depending on the underlying implementation.</p>
<p>Note that the wchar_t type varies in size on different systems. On win32 it is normally 2 bytes, and on unix 4 bytes.</p>
<p>If an error occurs an error may, or may not be posted with CPLError().</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszSource</em> </td><td>input multi-byte character string. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszSrcEncoding</em> </td><td>source encoding, typically CPL_ENC_UTF8. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszDstEncoding</em> </td><td>destination encoding, typically CPL_ENC_UCS2.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the zero terminated wchar_t string (to be freed with CPLFree()) or NULL on error. </dd></dl>
</div>
</div>
<a class="anchor" id="a74938e1e92b5847af925600af609f8d3"></a><!-- doxytag: member="cpl_string.h::CPLUnescapeString" ref="a74938e1e92b5847af925600af609f8d3" args="(const char *pszString, int *pnLength, int nScheme)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* CPLUnescapeString </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszInput</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>pnLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nScheme</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Unescape a string.</p>
<p>This function does the opposite of <a class="el" href="cpl__string_8h.html#adf2c0e5051d8f5c7fc742e4be41e935a">CPLEscapeString()</a>. Given a string with special values escaped according to some scheme, it will return a new copy of the string returned to it's original form.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszInput</em> </td><td>the input string. This is a zero terminated string. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pnLength</em> </td><td>location to return the length of the unescaped string, which may in some cases include embedded '\0' characters. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nScheme</em> </td><td>the escaped scheme to undo (see <a class="el" href="cpl__string_8h.html#adf2c0e5051d8f5c7fc742e4be41e935a">CPLEscapeString()</a> for a list).</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a copy of the unescaped string that should be freed by the application using CPLFree() when no longer needed. </dd></dl>
</div>
</div>
<a class="anchor" id="ac1ffd0e5baf9729f09388a38c07f5835"></a><!-- doxytag: member="cpl_string.h::CSLCount" ref="ac1ffd0e5baf9729f09388a38c07f5835" args="(char **papszStrList)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CSLCount </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>papszStrList</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return number of items in a string list.</p>
<p>Returns the number of items in a string list, not counting the terminating NULL. Passing in NULL is safe, and will result in a count of zero.</p>
<p>Lists are counted by iterating through them so long lists will take more time than short lists. Care should be taken to avoid using <a class="el" href="cpl__string_8h.html#ac1ffd0e5baf9729f09388a38c07f5835">CSLCount()</a> as an end condition for loops as it will result in O(n^2) behavior.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>papszStrList</em> </td><td>the string list to count.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the number of entries. </dd></dl>
</div>
</div>
<a class="anchor" id="a5a39b9c5896a273cc6f06c1d5be93238"></a><!-- doxytag: member="cpl_string.h::CSLDestroy" ref="a5a39b9c5896a273cc6f06c1d5be93238" args="(char **papszStrList)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CSLDestroy </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>papszStrList</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Free string list.</p>
<p>Frees the passed string list (null terminated array of strings). It is safe to pass NULL.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>papszStrList</em> </td><td>the list to free. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a8b9c9ad6c5a416c91f1fca55d9a91701"></a><!-- doxytag: member="cpl_string.h::CSLDuplicate" ref="a8b9c9ad6c5a416c91f1fca55d9a91701" args="(char **papszStrList)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char** CSLDuplicate </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>papszStrList</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Clone a string list.</p>
<p>Efficiently allocates a copy of a string list. The returned list is owned by the caller and should be freed 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>papszStrList</em> </td><td>the input string list.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>newly allocated copy. </dd></dl>
</div>
</div>
<a class="anchor" id="a0901440811294a6a0d6762b6e64107e3"></a><!-- doxytag: member="cpl_string.h::CSLFindName" ref="a0901440811294a6a0d6762b6e64107e3" args="(char **papszStrList, const char *pszName)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CSLFindName </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>papszStrList</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszName</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Find StringList entry with given key name.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>papszStrList</em> </td><td>the string list to search. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszName</em> </td><td>the key value to look for (case insensitive).</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>-1 on failure or the list index of the first occurance matching the given key. </dd></dl>
</div>
</div>
<a class="anchor" id="aadb00ff49c2d9dc32c043ca58fd9d8cd"></a><!-- doxytag: member="cpl_string.h::CSLFindString" ref="aadb00ff49c2d9dc32c043ca58fd9d8cd" args="(char **, const char *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CSLFindString </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>papszList</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszTarget</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 string within a string list.</p>
<p>Returns the index of the entry in the string list that contains the target string. The string in the string list must be a full match for the target, but the search is case insensitive.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>papszList</em> </td><td>the string list to be searched. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszTarget</em> </td><td>the string to be searched for.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the index of the string within the list or -1 on failure. </dd></dl>
</div>
</div>
<a class="anchor" id="ad7af0a270dc019a17bf1326da8e6a970"></a><!-- doxytag: member="cpl_string.h::CSLLoad" ref="ad7af0a270dc019a17bf1326da8e6a970" args="(const char *pszFname)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char** CSLLoad </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszFname</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Load a text file into a string list.</p>
<p>The VSI*L API is used, so <a class="el" href="cpl__vsi_8h.html#a48b5fab6cc22a9d0a543c095ee358634" title="Open file.">VSIFOpenL()</a> supported objects that aren't physical files can also be accessed. Files are returned as a string list, with one item in the string list per line. End of line markers are stripped (by <a class="el" href="cpl__conv_8h.html#a88612c88fb41db8a7e38c0f09c4042c9">CPLReadLineL()</a>).</p>
<p>If reading the file fails a CPLError() will be issued and NULL returned.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszFname</em> </td><td>the name of the file to read.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a string list with the files lines, now owned by caller. </dd></dl>
<p>References <a class="el" href="cpl__vsil_8cpp_source.html#l00301">VSIFCloseL()</a>, <a class="el" href="cpl__vsil_8cpp_source.html#l00491">VSIFEofL()</a>, and <a class="el" href="cpl__vsil_8cpp_source.html#l00273">VSIFOpenL()</a>.</p>
</div>
</div>
<a class="anchor" id="ad2766cf9f275a413c46ac4f7fa749be7"></a><!-- doxytag: member="cpl_string.h::CSLMerge" ref="ad2766cf9f275a413c46ac4f7fa749be7" args="(char **papszOrig, char **papszOverride)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char** CSLMerge </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>papszOrig</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>papszOverride</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Merge two lists. </p>
<p>The two lists are merged, ensuring that if any keys appear in both that the value from the second (papszOverride) list take precidence.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>papszOrig</em> </td><td>the original list, being modified. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>papszOverride</em> </td><td>the list of items being merged in. This list is unaltered and remains owned by the caller.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>updated list. </dd></dl>
</div>
</div>
<a class="anchor" id="aa1211d7957346bdb49bd40a80475615a"></a><!-- doxytag: member="cpl_string.h::CSLPartialFindString" ref="aa1211d7957346bdb49bd40a80475615a" args="(char **papszHaystack, const char *pszNeedle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CSLPartialFindString </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>papszHaystack</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszNeedle</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 substring within a string list.</p>
<p>Returns the index of the entry in the string list that contains the target string as a substring. The search is case sensitive (unlike <a class="el" href="cpl__string_8h.html#aadb00ff49c2d9dc32c043ca58fd9d8cd">CSLFindString()</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>papszHaystack</em> </td><td>the string list to be searched. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszNeedle</em> </td><td>the substring to be searched for.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the index of the string within the list or -1 on failure. </dd></dl>
</div>
</div>
<a class="anchor" id="a8dbce00a6e7fa4710613e3e4c963dd5d"></a><!-- doxytag: member="cpl_string.h::CSLSetNameValue" ref="a8dbce00a6e7fa4710613e3e4c963dd5d" args="(char **papszStrList, const char *pszName, const char *pszValue)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char** CSLSetNameValue </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>papszList</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszValue</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Assign value to name in StringList.</p>
<p>Set the value for a given name in a StringList of "Name=Value" pairs ("Name:Value" pairs are also supported for backward compatibility with older stuff.)</p>
<p>If there is already a value for that name in the list then the value is changed, otherwise a new "Name=Value" pair is added.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>papszList</em> </td><td>the original list, the modified version is returned. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszName</em> </td><td>the name to be assigned a value. This should be a well formed token (no spaces or very special characters). </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszValue</em> </td><td>the value to assign to the name. This should not contain any newlines (CR or LF) but is otherwise pretty much unconstrained. If NULL any corresponding value will be removed.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>modified stringlist. </dd></dl>
</div>
</div>
<a class="anchor" id="a97b38f55a35f3c1d66ba343692ab9ec0"></a><!-- doxytag: member="cpl_string.h::CSLSetNameValueSeparator" ref="a97b38f55a35f3c1d66ba343692ab9ec0" args="(char **papszStrList, const char *pszSeparator)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void CSLSetNameValueSeparator </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>papszList</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszSeparator</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 default separator (":" or "=") with the passed separator in the given name/value list.</p>
<p>Note that if a separator other than ":" or "=" is used, the resulting list will not be manipulatable by the CSL name/value functions any more.</p>
<p>The <a class="el" href="cpl__string_8h.html#a40ff577b83aca84a603414183e6903d3">CPLParseNameValue()</a> function is used to break the existing lines, and it also strips white space from around the existing delimiter, thus the old separator, and any white space will be replaced by the new separator. For formatting purposes it may be desireable to include some white space in the new separator. eg. ": " or " = ".</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>papszList</em> </td><td>the list to update. Component strings may be freed but the list array will remain at the same location.</td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszSeparator</em> </td><td>the new separator string to insert. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ada798bb0fafd08c7908d0f3716f341b3"></a><!-- doxytag: member="cpl_string.h::CSLTestBoolean" ref="ada798bb0fafd08c7908d0f3716f341b3" args="(const char *pszValue)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int CSLTestBoolean </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pszValue</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Test what boolean value contained in the string.</p>
<p>If pszValue is "NO", "FALSE", "OFF" or "0" will be returned FALSE. Otherwise, TRUE will be returned.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pszValue</em> </td><td>the string should be tested.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>TRUE or FALSE. </dd></dl>
</div>
</div>
<a class="anchor" id="a36f1e4efb0da65e3d900d3a0ce8cbaab"></a><!-- doxytag: member="cpl_string.h::CSLTokenizeString2" ref="a36f1e4efb0da65e3d900d3a0ce8cbaab" args="(const char *pszString, const char *pszDelimeter, int nCSLTFlags)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char** CSLTokenizeString2 </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">const char * </td>
<td class="paramname"> <em>pszDelimiters</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nCSLTFlags</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tokenize a string.</p>
<p>This function will split a string into tokens based on specified' delimeter(s) with a variety of options. The returned result is a string list that should be freed with <a class="el" href="cpl__string_8h.html#a5a39b9c5896a273cc6f06c1d5be93238">CSLDestroy()</a> when no longer needed.</p>
<p>The available parsing options are:</p>
<ul>
<li>CSLT_ALLOWEMPTYTOKENS: allow the return of empty tokens when two delimiters in a row occur with no other text between them. If not set, empty tokens will be discarded;</li>
<li>CSLT_STRIPLEADSPACES: strip leading space characters from the token (as reported by isspace());</li>
<li>CSLT_STRIPENDSPACES: strip ending space characters from the token (as reported by isspace());</li>
<li>CSLT_HONOURSTRINGS: double quotes can be used to hold values that should not be broken into multiple tokens;</li>
<li>CSLT_PRESERVEQUOTES: string quotes are carried into the tokens when this is set, otherwise they are removed;</li>
<li>CSLT_PRESERVEESCAPES: if set backslash escapes (for backslash itself, and for literal double quotes) will be preserved in the tokens, otherwise the backslashes will be removed in processing.</li>
</ul>
<p><b>Example:</b> </p>
<p>Parse a string into tokens based on various white space (space, newline, tab) and then print out results and cleanup. Quotes may be used to hold white space in tokens.</p>
<div class="fragment"><pre class="fragment"> <span class="keywordtype">char</span> **papszTokens;
<span class="keywordtype">int</span> i;
papszTokens =
CSLTokenizeString2( pszCommand, <span class="stringliteral">" \t\n"</span>,
CSLT_HONOURSTRINGS | CSLT_ALLOWEMPTYTOKENS );
<span class="keywordflow">for</span>( i = 0; papszTokens != NULL && papszTokens[i] != NULL; i++ )
printf( <span class="stringliteral">"arg %d: '%s'"</span>, papszTokens[i] );
CSLDestroy( papszTokens );
</pre></div><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>the string to be split into tokens. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pszDelimiters</em> </td><td>one or more characters to be used as token delimeters. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nCSLTFlags</em> </td><td>an ORing of one or more of the CSLT_ flag values.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a string list of tokens owned by the caller. </dd></dl>
</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>
