📄 cpl__string_8h.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"><title>GDAL: cpl_string.h File Reference</title><link href="doxygen.css" rel="stylesheet" type="text/css"><link href="tabs.css" rel="stylesheet" type="text/css"></head><body><!-- Generated by Doxygen 1.5.1 --><div class="tabs"> <ul> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="annotated.html"><span>Classes</span></a></li> <li id="current"><a href="files.html"><span>Files</span></a></li> <li><a href="pages.html"><span>Related Pages</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><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><table border="0" cellpadding="0" cellspacing="0"><tr><td></td></tr><tr><td colspan="2"><br><h2>Classes</h2></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b>CPLString</b></td></tr><tr><td colspan="2"><br><h2>Defines</h2></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="2338aada58f9282979f68e527f5aeb03"></a><!-- doxytag: member="cpl_string.h::CSLT_HONOURSTRINGS" ref="2338aada58f9282979f68e527f5aeb03" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CSLT_HONOURSTRINGS</b> 0x0001</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="2cf4a54c9dc07fb312ff0f0d143048cc"></a><!-- doxytag: member="cpl_string.h::CSLT_ALLOWEMPTYTOKENS" ref="2cf4a54c9dc07fb312ff0f0d143048cc" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CSLT_ALLOWEMPTYTOKENS</b> 0x0002</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="da6b937d227431e8076ec35294a3cb56"></a><!-- doxytag: member="cpl_string.h::CSLT_PRESERVEQUOTES" ref="da6b937d227431e8076ec35294a3cb56" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CSLT_PRESERVEQUOTES</b> 0x0004</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="8aace221e37b023221866198770ffe50"></a><!-- doxytag: member="cpl_string.h::CSLT_PRESERVEESCAPES" ref="8aace221e37b023221866198770ffe50" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CSLT_PRESERVEESCAPES</b> 0x0008</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="4d69daceff916c28ef0c65506d89d6d3"></a><!-- doxytag: member="cpl_string.h::CPLES_BackslashQuotable" ref="4d69daceff916c28ef0c65506d89d6d3" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLES_BackslashQuotable</b> 0</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="7f5479acb68fb882fed8bada7b92db15"></a><!-- doxytag: member="cpl_string.h::CPLES_XML" ref="7f5479acb68fb882fed8bada7b92db15" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLES_XML</b> 1</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="88296f14572ad5a724fb512357fddb03"></a><!-- doxytag: member="cpl_string.h::CPLES_URL" ref="88296f14572ad5a724fb512357fddb03" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLES_URL</b> 2</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="90614c3cf4cdd748e063f9c2cf669246"></a><!-- doxytag: member="cpl_string.h::CPLES_SQL" ref="90614c3cf4cdd748e063f9c2cf669246" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLES_SQL</b> 3</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a3347d20cc965ec42e25bc285a763ea9"></a><!-- doxytag: member="cpl_string.h::CPLES_CSV" ref="a3347d20cc965ec42e25bc285a763ea9" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLES_CSV</b> 4</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="0852d12c5823e0ff70b3da10ecff8b59"></a><!-- doxytag: member="cpl_string.h::MSVC_OLD_STUPID_BEHAVIOUR" ref="0852d12c5823e0ff70b3da10ecff8b59" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>MSVC_OLD_STUPID_BEHAVIOUR</b></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d0d030c6e3c0a6d298306a0c9b812f29"></a><!-- doxytag: member="cpl_string.h::std_string" ref="d0d030c6e3c0a6d298306a0c9b812f29" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>std_string</b> string</td></tr><tr><td colspan="2"><br><h2>Functions</h2></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="324b647df7638ffd3b1ad61392e3e057"></a><!-- doxytag: member="cpl_string.h::CSLAddString" ref="324b647df7638ffd3b1ad61392e3e057" 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" nowrap align="right" valign="top"><a class="anchor" name="c1ffd0e5baf9729f09388a38c07f5835"></a><!-- doxytag: member="cpl_string.h::CSLCount" ref="c1ffd0e5baf9729f09388a38c07f5835" args="(char **papszStrList)" -->int </td><td class="memItemRight" valign="bottom"><b>CSLCount</b> (char **papszStrList)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="41484b9e79baf47b540bd4160f2ac661"></a><!-- doxytag: member="cpl_string.h::CSLGetField" ref="41484b9e79baf47b540bd4160f2ac661" args="(char **, int)" -->const char * </td><td class="memItemRight" valign="bottom"><b>CSLGetField</b> (char **, int)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5a39b9c5896a273cc6f06c1d5be93238"></a><!-- doxytag: member="cpl_string.h::CSLDestroy" ref="5a39b9c5896a273cc6f06c1d5be93238" args="(char **papszStrList)" -->void </td><td class="memItemRight" valign="bottom"><b>CSLDestroy</b> (char **papszStrList)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="8b9c9ad6c5a416c91f1fca55d9a91701"></a><!-- doxytag: member="cpl_string.h::CSLDuplicate" ref="8b9c9ad6c5a416c91f1fca55d9a91701" args="(char **papszStrList)" -->char ** </td><td class="memItemRight" valign="bottom"><b>CSLDuplicate</b> (char **papszStrList)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">char ** </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#d2766cf9f275a413c46ac4f7fa749be7">CSLMerge</a> (char **papszOrig, char **papszOverride)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Merge two lists. <a href="#d2766cf9f275a413c46ac4f7fa749be7"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ddf1c1b43c085a351fd241ec0775a298"></a><!-- doxytag: member="cpl_string.h::CSLTokenizeString" ref="ddf1c1b43c085a351fd241ec0775a298" args="(const char *pszString)" -->char ** </td><td class="memItemRight" valign="bottom"><b>CSLTokenizeString</b> (const char *pszString)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="54182bb1d51f205d2bd252c46ee7ade3"></a><!-- doxytag: member="cpl_string.h::CSLTokenizeStringComplex" ref="54182bb1d51f205d2bd252c46ee7ade3" 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" nowrap align="right" valign="top"><a class="anchor" name="36f1e4efb0da65e3d900d3a0ce8cbaab"></a><!-- doxytag: member="cpl_string.h::CSLTokenizeString2" ref="36f1e4efb0da65e3d900d3a0ce8cbaab" args="(const char *pszString, const char *pszDelimeter, int nCSLTFlags)" -->char ** </td><td class="memItemRight" valign="bottom"><b>CSLTokenizeString2</b> (const char *pszString, const char *pszDelimeter, int nCSLTFlags)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="574bbe82f32ba1b80da40f24e0b5103e"></a><!-- doxytag: member="cpl_string.h::CSLPrint" ref="574bbe82f32ba1b80da40f24e0b5103e" 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" nowrap align="right" valign="top"><a class="anchor" name="d7af0a270dc019a17bf1326da8e6a970"></a><!-- doxytag: member="cpl_string.h::CSLLoad" ref="d7af0a270dc019a17bf1326da8e6a970" args="(const char *pszFname)" -->char ** </td><td class="memItemRight" valign="bottom"><b>CSLLoad</b> (const char *pszFname)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d5a20acd37e7b5d1239f2be228f14f3e"></a><!-- doxytag: member="cpl_string.h::CSLSave" ref="d5a20acd37e7b5d1239f2be228f14f3e" 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" nowrap align="right" valign="top"><a class="anchor" name="86e011718c751cac6b3d56dfea299150"></a><!-- doxytag: member="cpl_string.h::CSLInsertStrings" ref="86e011718c751cac6b3d56dfea299150" 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" nowrap align="right" valign="top"><a class="anchor" name="821f8de347986f15357d927dc6e6eba1"></a><!-- doxytag: member="cpl_string.h::CSLInsertString" ref="821f8de347986f15357d927dc6e6eba1" 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" nowrap align="right" valign="top"><a class="anchor" name="e48ee49e83f74b44f7f3beea072aa75c"></a><!-- doxytag: member="cpl_string.h::CSLRemoveStrings" ref="e48ee49e83f74b44f7f3beea072aa75c" 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" nowrap align="right" valign="top"><a class="anchor" name="adb00ff49c2d9dc32c043ca58fd9d8cd"></a><!-- doxytag: member="cpl_string.h::CSLFindString" ref="adb00ff49c2d9dc32c043ca58fd9d8cd" args="(char **, const char *)" -->int </td><td class="memItemRight" valign="bottom"><b>CSLFindString</b> (char **, const char *)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#da798bb0fafd08c7908d0f3716f341b3">CSLTestBoolean</a> (const char *pszValue)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="76fbc85c1d546c07f1ca94e63c025b7c"></a><!-- doxytag: member="cpl_string.h::CSLFetchBoolean" ref="76fbc85c1d546c07f1ca94e63c025b7c" 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" nowrap align="right" valign="top"><a class="anchor" name="670561263a6653fe024ca5ec65cd93c7"></a><!-- doxytag: member="cpl_string.h::CPLSPrintf" ref="670561263a6653fe024ca5ec65cd93c7" args="(const char *fmt,...)" -->const char * </td><td class="memItemRight" valign="bottom"><b>CPLSPrintf</b> (const char *fmt,...)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="7d2a2a63025452f678decdcea64ac4e4"></a><!-- doxytag: member="cpl_string.h::CSLAppendPrintf" ref="7d2a2a63025452f678decdcea64ac4e4" args="(char **papszStrList, char *fmt,...)" -->char ** </td><td class="memItemRight" valign="bottom"><b>CSLAppendPrintf</b> (char **papszStrList, char *fmt,...)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#40ff577b83aca84a603414183e6903d3">CPLParseNameValue</a> (const char *pszNameValue, char **ppszKey)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5ddbcc4a8e541c6183000455f7a3273e"></a><!-- doxytag: member="cpl_string.h::CSLFetchNameValue" ref="5ddbcc4a8e541c6183000455f7a3273e" 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" nowrap align="right" valign="top"><a class="anchor" name="d936491d4a23865d56d77fe70247991d"></a><!-- doxytag: member="cpl_string.h::CSLFetchNameValueMultiple" ref="d936491d4a23865d56d77fe70247991d" 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" nowrap align="right" valign="top"><a class="anchor" name="4e6c7234ad43e2fbeec8b7a35d014cbd"></a><!-- doxytag: member="cpl_string.h::CSLAddNameValue" ref="4e6c7234ad43e2fbeec8b7a35d014cbd" 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" nowrap align="right" valign="top">char ** </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#8dbce00a6e7fa4710613e3e4c963dd5d">CSLSetNameValue</a> (char **papszStrList, const char *pszName, const char *pszValue)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#97b38f55a35f3c1d66ba343692ab9ec0">CSLSetNameValueSeparator</a> (char **papszStrList, const char *pszSeparator)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#df2c0e5051d8f5c7fc742e4be41e935a">CPLEscapeString</a> (const char *pszString, int nLength, int nScheme)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#74938e1e92b5847af925600af609f8d3">CPLUnescapeString</a> (const char *pszString, int *pnLength, int nScheme)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#e683e10df83274c83aefc305cbcf4cba">CPLBinaryToHex</a> (int nBytes, const GByte *pabyData)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">GByte * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__string_8h.html#ababd56ea0317416780a1acc19aa61a3">CPLHexToBinary</a> (const char *pszHex, int *pnBytes)</td></tr></table><hr><a name="_details"></a><h2>Detailed Description</h2>Various convenience functions for working with strings and string lists.<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>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#8dbce00a6e7fa4710613e3e4c963dd5d">CSLSetNameValue()</a>, and CSLFetchNameValue()). <hr><h2>Function Documentation</h2><a class="anchor" name="e683e10df83274c83aefc305cbcf4cba"></a><!-- doxytag: member="cpl_string.h::CPLBinaryToHex" ref="e683e10df83274c83aefc305cbcf4cba" 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 width="100%"></td> </tr>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -