00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024
00025
00026
00027
00028
00029
00030
00031
00032
00033
00034
00035
00036
00037
00038
00039
00040
00041
00042
00043
00044
00045
00046
00047
00048
00049
00050
00051
00052
00053
00054
00055
00056
00057
00058
00059
00060
00061
00062
00063
00064
00065
00066
00067
00068
00069
00070
00071
00072 #ifndef _CPL_STRING_H_INCLUDED
00073 #define _CPL_STRING_H_INCLUDED
00074
00075 #include "cpl_vsi.h"
00076 #include "cpl_error.h"
00077 #include "cpl_conv.h"
00078
00097 CPL_C_START
00098
00099 char CPL_DLL **CSLAddString(char **papszStrList, const char *pszNewString);
00100 int CPL_DLL CSLCount(char **papszStrList);
00101 const char CPL_DLL *CSLGetField( char **, int );
00102 void CPL_DLL CPL_STDCALL CSLDestroy(char **papszStrList);
00103 char CPL_DLL **CSLDuplicate(char **papszStrList);
00104 char CPL_DLL **CSLMerge( char **papszOrig, char **papszOverride );
00105
00106 char CPL_DLL **CSLTokenizeString(const char *pszString );
00107 char CPL_DLL **CSLTokenizeStringComplex(const char *pszString,
00108 const char *pszDelimiter,
00109 int bHonourStrings, int bAllowEmptyTokens );
00110 char CPL_DLL **CSLTokenizeString2( const char *pszString,
00111 const char *pszDelimeter,
00112 int nCSLTFlags );
00113
00114 #define CSLT_HONOURSTRINGS 0x0001
00115 #define CSLT_ALLOWEMPTYTOKENS 0x0002
00116 #define CSLT_PRESERVEQUOTES 0x0004
00117 #define CSLT_PRESERVEESCAPES 0x0008
00118
00119 int CPL_DLL CSLPrint(char **papszStrList, FILE *fpOut);
00120 char CPL_DLL **CSLLoad(const char *pszFname);
00121 int CPL_DLL CSLSave(char **papszStrList, const char *pszFname);
00122
00123 char CPL_DLL **CSLInsertStrings(char **papszStrList, int nInsertAtLineNo,
00124 char **papszNewLines);
00125 char CPL_DLL **CSLInsertString(char **papszStrList, int nInsertAtLineNo,
00126 const char *pszNewLine);
00127 char CPL_DLL **CSLRemoveStrings(char **papszStrList, int nFirstLineToDelete,
00128 int nNumToRemove, char ***ppapszRetStrings);
00129 int CPL_DLL CSLFindString( char **, const char * );
00130 int CPL_DLL CSLTestBoolean( const char *pszValue );
00131 int CPL_DLL CSLFetchBoolean( char **papszStrList, const char *pszKey,
00132 int bDefault );
00133
00134 const char CPL_DLL *CPLSPrintf(char *fmt, ...);
00135 char CPL_DLL **CSLAppendPrintf(char **papszStrList, char *fmt, ...);
00136
00137 const char CPL_DLL *
00138 CPLParseNameValue(const char *pszNameValue, char **ppszKey );
00139 const char CPL_DLL *
00140 CSLFetchNameValue(char **papszStrList, const char *pszName);
00141 char CPL_DLL **
00142 CSLFetchNameValueMultiple(char **papszStrList, const char *pszName);
00143 char CPL_DLL **
00144 CSLAddNameValue(char **papszStrList,
00145 const char *pszName, const char *pszValue);
00146 char CPL_DLL **
00147 CSLSetNameValue(char **papszStrList,
00148 const char *pszName, const char *pszValue);
00149 void CPL_DLL CSLSetNameValueSeparator( char ** papszStrList,
00150 const char *pszSeparator );
00151
00152 #define CPLES_BackslashQuotable 0
00153 #define CPLES_XML 1
00154 #define CPLES_URL 2
00155 #define CPLES_SQL 3
00156 #define CPLES_CSV 4
00157
00158 char CPL_DLL *CPLEscapeString( const char *pszString, int nLength,
00159 int nScheme );
00160 char CPL_DLL *CPLUnescapeString( const char *pszString, int *pnLength,
00161 int nScheme );
00162
00163 char CPL_DLL *CPLBinaryToHex( int nBytes, const GByte *pabyData );
00164 GByte CPL_DLL *CPLHexToBinary( const char *pszHex, int *pnBytes );
00165
00166 CPL_C_END
00167
00168
00169
00170
00171
00172 #ifdef __cplusplus
00173
00174 #include <string>
00175
00176
00177
00178
00179
00180
00181
00182
00183
00184
00185
00186
00187
00188
00189 #if (_MSC_VER <= 1202)
00190 # define MSVC_OLD_STUPID_BEHAVIOUR
00191 #endif
00192
00193
00194
00195 #ifdef MSVC_OLD_STUPID_BEHAVIOUR
00196 using std::string;
00197 # define std_string string
00198 #else
00199 # define std_string std::string
00200 #endif
00201
00202
00203 #if defined(WIN32CE)
00204 # pragma warning(disable:4786)
00205 #endif
00206
00207
00208
00209
00210 class CPL_DLL CPLString : public std_string
00211 {
00212 public:
00213 CPLString(void) {}
00214 CPLString( const std::string &oStr ) : std_string( oStr ) {}
00215 CPLString( const char *pszStr ) : std_string( pszStr ) {}
00216
00217 operator const char* (void) const { return c_str(); }
00218
00219 CPLString &Printf( const char *pszFormat, ... );
00220 CPLString &vPrintf( const char *pszFormat, va_list args );
00221 };
00222
00223 #endif
00224
00225 #endif