GDAL

- Main Page
- Related Pages
- Classes
- Files
- Download
- Issue Tracker

- File List
- File Members

cpl_string.h
Go to the documentation of this file.
1 /**********************************************************************
2 * $Id$
3 *
4 * Name: cpl_string.h
5 * Project: CPL - Common Portability Library
6 * Purpose: String and StringList functions.
7 * Author: Daniel Morissette, dmorissette@mapgears.com
8 *
9 **********************************************************************
10 * Copyright (c) 1998, Daniel Morissette
11 * Copyright (c) 2008-2014, Even Rouault <even dot rouault at mines-paris dot org>
12 *
13 * Permission is hereby granted, free of charge, to any person obtaining a
14 * copy of this software and associated documentation files (the "Software"),
15 * to deal in the Software without restriction, including without limitation
16 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
17 * and/or sell copies of the Software, and to permit persons to whom the
18 * Software is furnished to do so, subject to the following conditions:
19 *
20 * The above copyright notice and this permission notice shall be included
21 * in all copies or substantial portions of the Software.
22 *
23 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
24 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
25 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
26 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
27 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
28 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
29 * DEALINGS IN THE SOFTWARE.
30 ****************************************************************************/
31
32 #ifndef CPL_STRING_H_INCLUDED
33 #define CPL_STRING_H_INCLUDED
34
35 #include "cpl_error.h"
36 #include "cpl_conv.h"
37 #include "cpl_vsi.h"
38
61 CPL_C_START
62
63 char CPL_DLL **CSLAddString(char **papszStrList,
64 const char *pszNewString) CPL_WARN_UNUSED_RESULT;
65 char CPL_DLL **CSLAddStringMayFail(
66 char **papszStrList, const char *pszNewString) CPL_WARN_UNUSED_RESULT;
67 int CPL_DLL CSLCount(CSLConstList papszStrList);
68 const char CPL_DLL *CSLGetField( CSLConstList, int );
69 void CPL_DLL CPL_STDCALL CSLDestroy(char **papszStrList);
70 char CPL_DLL **CSLDuplicate(CSLConstList papszStrList) CPL_WARN_UNUSED_RESULT;
71 char CPL_DLL **CSLMerge( char **papszOrig,
72 CSLConstList papszOverride ) CPL_WARN_UNUSED_RESULT;
73
74 char CPL_DLL **CSLTokenizeString(const char *pszString ) CPL_WARN_UNUSED_RESULT;
75 char CPL_DLL **CSLTokenizeStringComplex(
76 const char *pszString, const char *pszDelimiter, int bHonourStrings,
77 int bAllowEmptyTokens ) CPL_WARN_UNUSED_RESULT;
78 char CPL_DLL **CSLTokenizeString2( const char *pszString,
79 const char *pszDelimiter,
80 int nCSLTFlags ) CPL_WARN_UNUSED_RESULT;
81
83 #define CSLT_HONOURSTRINGS 0x0001
84
85 #define CSLT_ALLOWEMPTYTOKENS 0x0002
86
87 #define CSLT_PRESERVEQUOTES 0x0004
88
89 #define CSLT_PRESERVEESCAPES 0x0008
90
91 #define CSLT_STRIPLEADSPACES 0x0010
92
93 #define CSLT_STRIPENDSPACES 0x0020
94
95 int CPL_DLL CSLPrint(CSLConstList papszStrList, FILE *fpOut);
96 char CPL_DLL **CSLLoad(const char *pszFname) CPL_WARN_UNUSED_RESULT;
97 char CPL_DLL **CSLLoad2(
98 const char *pszFname, int nMaxLines, int nMaxCols,
99 CSLConstList papszOptions) CPL_WARN_UNUSED_RESULT;
100 int CPL_DLL CSLSave(CSLConstList papszStrList, const char *pszFname);
101
102 char CPL_DLL **CSLInsertStrings(char **papszStrList, int nInsertAtLineNo,
103 CSLConstList papszNewLines) CPL_WARN_UNUSED_RESULT;
104 char CPL_DLL **CSLInsertString(char **papszStrList, int nInsertAtLineNo,
105 const char *pszNewLine) CPL_WARN_UNUSED_RESULT;
106 char CPL_DLL **CSLRemoveStrings(
107 char **papszStrList, int nFirstLineToDelete,
108 int nNumToRemove, char ***ppapszRetStrings) CPL_WARN_UNUSED_RESULT;
109 int CPL_DLL CSLFindString( CSLConstList papszList, const char *pszTarget );
110 int CPL_DLL CSLFindStringCaseSensitive( CSLConstList papszList,
111 const char *pszTarget );
112 int CPL_DLL CSLPartialFindString( CSLConstList papszHaystack,
113 const char *pszNeedle );
114 int CPL_DLL CSLFindName(CSLConstList papszStrList, const char *pszName);
115 int CPL_DLL CSLFetchBoolean( CSLConstList papszStrList, const char *pszKey,
116 int bDefault );
117
118 /* TODO: Deprecate CSLTestBoolean. Remove in GDAL 3.x. */
119 int CPL_DLL CSLTestBoolean( const char *pszValue );
120 /* Do not use CPLTestBoolean in C++ code. Use CPLTestBool. */
121 int CPL_DLL CPLTestBoolean( const char *pszValue );
122
123 #if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
124 #ifdef DO_NOT_USE_DEBUG_BOOL
125 #define CPLTestBool(x) CPL_TO_BOOL(CPLTestBoolean(x))
126 #define CPLFetchBool(list,key,default) \
127 CPL_TO_BOOL(CSLFetchBoolean(list,key,default))
128 #else /* DO_NOT_USE_DEBUG_BOOL */
129 /* Prefer these for C++ code. */
130 #ifdef DEBUG_BOOL
131 extern "C++" {
132 #endif
133 bool CPL_DLL CPLTestBool( const char *pszValue );
134 bool CPL_DLL CPLFetchBool( CSLConstList papszStrList, const char *pszKey,
135 bool bDefault );
136 #ifdef DEBUG_BOOL
137 }
138 #endif
139 #endif
140 #endif /* __cplusplus */
141
142 const char CPL_DLL *
143 CPLParseNameValue( const char *pszNameValue, char **ppszKey );
144
145 const char CPL_DLL *
146 CSLFetchNameValue( CSLConstList papszStrList, const char *pszName);
147 const char CPL_DLL *
148 CSLFetchNameValueDef( CSLConstList papszStrList,
149 const char *pszName,
150 const char *pszDefault );
151 char CPL_DLL **
152 CSLFetchNameValueMultiple(CSLConstList papszStrList, const char *pszName);
153 char CPL_DLL **
154 CSLAddNameValue(char **papszStrList,
155 const char *pszName,
156 const char *pszValue) CPL_WARN_UNUSED_RESULT;
157 char CPL_DLL **
158 CSLSetNameValue(char **papszStrList,
159 const char *pszName,
160 const char *pszValue) CPL_WARN_UNUSED_RESULT;
161 void CPL_DLL CSLSetNameValueSeparator( char ** papszStrList,
162 const char *pszSeparator );
163
164 char CPL_DLL ** CSLParseCommandLine(const char* pszCommandLine);
165
167 #define CPLES_BackslashQuotable 0
168
169 #define CPLES_XML 1
170
171 #define CPLES_URL 2
172
173 #define CPLES_SQL 3
174
175 #define CPLES_CSV 4
176
177 #define CPLES_XML_BUT_QUOTES 5
178
179 #define CPLES_CSV_FORCE_QUOTING 6
180
181 char CPL_DLL *CPLEscapeString( const char *pszString, int nLength,
182 int nScheme ) CPL_WARN_UNUSED_RESULT;
183 char CPL_DLL *CPLUnescapeString( const char *pszString, int *pnLength,
184 int nScheme ) CPL_WARN_UNUSED_RESULT;
185
186 char CPL_DLL *CPLBinaryToHex( int nBytes,
187 const GByte *pabyData ) CPL_WARN_UNUSED_RESULT;
188 GByte CPL_DLL *CPLHexToBinary( const char *pszHex,
189 int *pnBytes ) CPL_WARN_UNUSED_RESULT;
190
191 char CPL_DLL *CPLBase64Encode( int nBytes,
192 const GByte *pabyData ) CPL_WARN_UNUSED_RESULT;
193 int CPL_DLL CPLBase64DecodeInPlace( GByte* pszBase64 ) CPL_WARN_UNUSED_RESULT;
194
196 typedef enum
197 {
198 CPL_VALUE_STRING,
199 CPL_VALUE_REAL,
200 CPL_VALUE_INTEGER
201 } CPLValueType;
202
203 CPLValueType CPL_DLL CPLGetValueType(const char* pszValue);
204
205 size_t CPL_DLL CPLStrlcpy(char* pszDest, const char* pszSrc, size_t nDestSize);
206 size_t CPL_DLL CPLStrlcat(char* pszDest, const char* pszSrc, size_t nDestSize);
207 size_t CPL_DLL CPLStrnlen(const char *pszStr, size_t nMaxLen);
208
209 /* -------------------------------------------------------------------- */
210 /* Locale independent formatting functions. */
211 /* -------------------------------------------------------------------- */
212 int CPL_DLL CPLvsnprintf( char *str, size_t size,
213 CPL_FORMAT_STRING(const char* fmt),
214 va_list args )
215 CPL_PRINT_FUNC_FORMAT(3, 0 );
216
217 /* ALIAS_CPLSNPRINTF_AS_SNPRINTF might be defined to enable GCC 7 */
218 /* -Wformat-truncation= warnings, but shouldn't be set for normal use */
219 #if defined(ALIAS_CPLSNPRINTF_AS_SNPRINTF)
220 #define CPLsnprintf snprintf
221 #else
222 int CPL_DLL CPLsnprintf( char *str, size_t size,
223 CPL_FORMAT_STRING(const char* fmt), ... )
224 CPL_PRINT_FUNC_FORMAT(3, 4);
225 #endif
226
228 #if defined(GDAL_COMPILATION) && !defined(DONT_DEPRECATE_SPRINTF)
229 int CPL_DLL CPLsprintf( char *str, CPL_FORMAT_STRING(const char* fmt), ... )
230 CPL_PRINT_FUNC_FORMAT(2, 3)
231 CPL_WARN_DEPRECATED("Use CPLsnprintf instead");
232 #else
233 int CPL_DLL CPLsprintf( char *str, CPL_FORMAT_STRING(const char* fmt), ... )
234 CPL_PRINT_FUNC_FORMAT(2, 3);
235 #endif
236
237 int CPL_DLL CPLprintf( CPL_FORMAT_STRING(const char* fmt), ... )
238 CPL_PRINT_FUNC_FORMAT(1, 2);
239
240 /* For some reason Doxygen_Suppress is needed to avoid warning. Not sure why */
242 /* caution: only works with limited number of formats */
243 int CPL_DLL CPLsscanf( const char* str,
244 CPL_SCANF_FORMAT_STRING(const char* fmt), ... )
245 CPL_SCAN_FUNC_FORMAT(2, 3);
248 const char CPL_DLL *CPLSPrintf( CPL_FORMAT_STRING(const char *fmt), ... )
249 CPL_PRINT_FUNC_FORMAT(1, 2) CPL_WARN_UNUSED_RESULT;
250 char CPL_DLL **CSLAppendPrintf( char **papszStrList,
251 CPL_FORMAT_STRING(const char *fmt), ... )
252 CPL_PRINT_FUNC_FORMAT(2, 3) CPL_WARN_UNUSED_RESULT;
253 int CPL_DLL CPLVASPrintf( char **buf,
254 CPL_FORMAT_STRING(const char *fmt), va_list args )
255 CPL_PRINT_FUNC_FORMAT(2, 0);
256
257 /* -------------------------------------------------------------------- */
258 /* RFC 23 character set conversion/recoding API (cpl_recode.cpp). */
259 /* -------------------------------------------------------------------- */
261 #define CPL_ENC_LOCALE ""
262
263 #define CPL_ENC_UTF8 "UTF-8"
264
265 #define CPL_ENC_UTF16 "UTF-16"
266
267 #define CPL_ENC_UCS2 "UCS-2"
268
269 #define CPL_ENC_UCS4 "UCS-4"
270
271 #define CPL_ENC_ASCII "ASCII"
272
273 #define CPL_ENC_ISO8859_1 "ISO-8859-1"
274
275 int CPL_DLL CPLEncodingCharSize( const char *pszEncoding );
277 void CPL_DLL CPLClearRecodeWarningFlags( void );
279 char CPL_DLL *CPLRecode(
280 const char *pszSource, const char *pszSrcEncoding,
281 const char *pszDstEncoding ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
282 char CPL_DLL *CPLRecodeFromWChar(
283 const wchar_t *pwszSource, const char *pszSrcEncoding,
284 const char *pszDstEncoding ) CPL_WARN_UNUSED_RESULT;
285 wchar_t CPL_DLL *CPLRecodeToWChar(
286 const char *pszSource, const char *pszSrcEncoding,
287 const char *pszDstEncoding ) CPL_WARN_UNUSED_RESULT;
288 int CPL_DLL CPLIsUTF8( const char* pabyData, int nLen );
289 char CPL_DLL *CPLForceToASCII(
290 const char* pabyData, int nLen,
291 char chReplacementChar ) CPL_WARN_UNUSED_RESULT;
292 int CPL_DLL CPLStrlenUTF8( const char *pszUTF8Str );
293 CPL_C_END
294
295 /************************************************************************/
296 /* CPLString */
297 /************************************************************************/
298
299 #if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
300
301 extern "C++"
302 {
303 #ifndef DOXYGEN_SKIP
304 #include <string>
305 #endif
306
307 // VC++ implicitly applies __declspec(dllexport) to template base
308 // classes of classes marked with __declspec(dllexport).
309 // Hence, VC++ would export symbols for the specialization of std::basic_string<char>,
310 // since it is a base class of CPLString, which is marked with CPL_DLL.
311 // As a result, if an application linked both gdal.dll and a static library that
312 // (implicitly) instantiates std::string (almost all do!), then the linker would
313 // emit an error concerning duplicate symbols for std::string.
314 // The least intrusive solution is to turn CPLString into a template class
315 // (that is not marked with CPL_DLL), make CPLString a typedef for a specialization
316 // of that template class, and mark only the few non-inline member functions of
317 // CPLStringT with CPL_DLL.
318 #ifdef _MSC_VER
319
320 # define CPLSTRING_DLL CPL_DLL
321
322 template< class Dummy = void > class CPLStringT;
323 typedef CPLStringT<> CPLString;
324
325 template< class Dummy >
326 class CPLStringT : public std::string
327
328 #else
329
331 # define CPLSTRING_DLL
332 # define CPLStringT CPLString
333
335 class CPL_DLL CPLString : public std::string
337
338 #endif
339 {
340 public:
341
343 CPLStringT(void) {}
345 // cppcheck-suppress noExplicitConstructor
346 CPLStringT( const std::string &oStr ) : std::string( oStr ) {}
348 // cppcheck-suppress noExplicitConstructor
349 CPLStringT( const char *pszStr ) : std::string( pszStr ) {}
351 CPLStringT( const char *pszStr, size_t n ) : std::string( pszStr, n ) {}
352
354 operator const char* (void) const { return c_str(); }
355
357 char& operator[](std::string::size_type i)
358 {
359 return std::string::operator[](i);
360 }
361
363 const char& operator[](std::string::size_type i) const
364 {
365 return std::string::operator[](i);
366 }
367
369 char& operator[](int i)
370 {
371 return std::string::operator[](
372 static_cast<std::string::size_type>(i));
373 }
374
376 const char& operator[](int i) const
377 {
378 return std::string::operator[](
379 static_cast<std::string::size_type>(i));
380 }
381
383 void Clear() { resize(0); }
384
388 void Seize( char *pszValue )
389 {
390 if (pszValue == nullptr )
391 Clear();
392 else
393 {
394 *this = pszValue;
395 CPLFree(pszValue);
396 }
397 }
398
399 /* There seems to be a bug in the way the compiler count indices...
400 * Should be CPL_PRINT_FUNC_FORMAT (1, 2) */
401 CPLSTRING_DLL CPLString &Printf(
402 CPL_FORMAT_STRING(const char *pszFormat), ... )
403 CPL_PRINT_FUNC_FORMAT (2, 3);
404 CPLSTRING_DLL CPLString &vPrintf(
405 CPL_FORMAT_STRING(const char *pszFormat), va_list args )
406 CPL_PRINT_FUNC_FORMAT(2, 0);
407 CPLSTRING_DLL CPLString &FormatC( double dfValue, const char *pszFormat = nullptr );
408 CPLSTRING_DLL CPLString &Trim();
409 CPLSTRING_DLL CPLString &Recode( const char *pszSrcEncoding, const char *pszDstEncoding );
410 CPLSTRING_DLL CPLString &replaceAll(
411 const std::string &osBefore, const std::string& osAfter );
412 CPLSTRING_DLL CPLString &replaceAll( const std::string &osBefore, char chAfter );
413 CPLSTRING_DLL CPLString &replaceAll( char chBefore, const std::string &osAfter );
414 CPLSTRING_DLL CPLString &replaceAll( char chBefore, char chAfter );
415
416 /* case insensitive find alternates */
417 CPLSTRING_DLL size_t ifind( const std::string & str, size_t pos = 0 ) const;
418 CPLSTRING_DLL size_t ifind( const char * s, size_t pos = 0 ) const;
419 CPLSTRING_DLL CPLString &toupper( void );
420 CPLSTRING_DLL CPLString &tolower( void );
421
422 CPLSTRING_DLL bool endsWith( const std::string& osStr ) const;
423 };
424
425 #ifndef _MSC_VER
426 # undef CPLStringT
427 #endif
428
429 CPLString CPL_DLL CPLOPrintf(CPL_FORMAT_STRING(const char *pszFormat), ... )
430 CPL_PRINT_FUNC_FORMAT (1, 2);
431 CPLString CPL_DLL CPLOvPrintf(
432 CPL_FORMAT_STRING(const char *pszFormat), va_list args)
433 CPL_PRINT_FUNC_FORMAT (1, 0);
434
435 /* -------------------------------------------------------------------- */
436 /* URL processing functions, here since they depend on CPLString. */
437 /* -------------------------------------------------------------------- */
438 CPLString CPL_DLL CPLURLGetValue(const char* pszURL, const char* pszKey);
439 CPLString CPL_DLL CPLURLAddKVP(const char* pszURL, const char* pszKey,
440 const char* pszValue);
441
442 /************************************************************************/
443 /* CPLStringList */
444 /************************************************************************/
445
447 class CPL_DLL CPLStringList
448 {
449 char **papszList;
450 mutable int nCount;
451 mutable int nAllocation;
452 bool bOwnList;
453 bool bIsSorted;
454
455 void Initialize();
456 void MakeOurOwnCopy();
457 void EnsureAllocation( int nMaxLength );
458 int FindSortedInsertionPoint( const char *pszLine );
459
460 public:
461 CPLStringList();
462 CPLStringList( char **papszList, int bTakeOwnership=TRUE );
463 // cppcheck-suppress noExplicitConstructor
464 CPLStringList( CSLConstList papszList );
465 CPLStringList( const CPLStringList& oOther );
466 ~CPLStringList();
467
468 CPLStringList &Clear();
469
471 int size() const { return Count(); }
472 int Count() const;
473
475 bool empty() const { return Count() == 0; }
476
477 CPLStringList &AddString( const char *pszNewString );
478 CPLStringList &AddStringDirectly( char *pszNewString );
479
480 CPLStringList &InsertString( int nInsertAtLineNo, const char *pszNewLine )
481 { return InsertStringDirectly( nInsertAtLineNo, CPLStrdup(pszNewLine) ); }
482 CPLStringList &InsertStringDirectly( int nInsertAtLineNo, char *pszNewLine);
483
484 // CPLStringList &InsertStrings( int nInsertAtLineNo, char **papszNewLines );
485 // CPLStringList &RemoveStrings( int nFirstLineToDelete, int nNumToRemove=1 );
486
488 int FindString( const char *pszTarget ) const
489 { return CSLFindString( papszList, pszTarget ); }
491 int PartialFindString( const char *pszNeedle ) const
492 { return CSLPartialFindString( papszList, pszNeedle ); }
493
494 int FindName( const char *pszName ) const;
495 bool FetchBool( const char *pszKey, bool bDefault ) const;
496 // Deprecated.
497 int FetchBoolean( const char *pszKey, int bDefault ) const;
498 const char *FetchNameValue( const char *pszKey ) const;
499 const char *FetchNameValueDef(
500 const char *pszKey, const char *pszDefault ) const;
501 CPLStringList &AddNameValue( const char *pszKey, const char *pszValue );
502 CPLStringList &SetNameValue( const char *pszKey, const char *pszValue );
503
504 CPLStringList &Assign( char **papszListIn, int bTakeOwnership=TRUE );
506 CPLStringList &operator=(char **papszListIn) {
507 return Assign( papszListIn, TRUE ); }
509 CPLStringList &operator=(const CPLStringList& oOther);
511 CPLStringList &operator=(CSLConstList papszListIn);
512
514 char * operator[](int i);
516 char * operator[](size_t i) { return (*this)[static_cast<int>(i)]; }
518 const char * operator[](int i) const;
520 const char * operator[](size_t i) const {
521 return (*this)[static_cast<int>(i)]; }
523 const char * operator[](const char* pszKey) const {
524 return FetchNameValue(pszKey); }
525
527 char** List() { return papszList; }
529 CSLConstList List() const { return papszList; }
530 char **StealList();
531
532 CPLStringList &Sort();
534 int IsSorted() const { return bIsSorted; }
535
537 operator char**(void) { return List(); }
539 operator CSLConstList(void) const { return List(); }
540 };
541
542 #ifdef GDAL_COMPILATION
543
544 #include <memory>
545
547 struct CSLDestroyReleaser
548 {
549 void operator()(char** papszStr) const { CSLDestroy(papszStr); }
550 };
554 using CSLUniquePtr = std::unique_ptr< char*, CSLDestroyReleaser>;
555
556 #endif
557
558 } // extern "C++"
559
560 #endif /* def __cplusplus && !CPL_SUPRESS_CPLUSPLUS */
561
562 #endif /* CPL_STRING_H_INCLUDED */
CPLEncodingCharSize
int CPLEncodingCharSize(const char *pszEncoding)
Return bytes per character for encoding.
Definition: cpl_recode.cpp:318
CSLFindName
int CSLFindName(CSLConstList papszStrList, const char *pszName)
Find StringList entry with given key name.
Definition: cpl_string.cpp:1708
CPLBase64Encode
char * CPLBase64Encode(int nBytes, const GByte *pabyData) CPL_WARN_UNUSED_RESULT
Base64 encode a buffer.
Definition: cpl_base64.cpp:199
CPLStrlcat
size_t CPLStrlcat(char *pszDest, const char *pszSrc, size_t nDestSize)
Appends a source string to a destination buffer.
Definition: cpl_string.cpp:2755
cpl_vsi.h
Standard C Covers.
CSLTokenizeString
char ** CSLTokenizeString(const char *pszString) CPL_WARN_UNUSED_RESULT
Tokenizes a string and returns a StringList with one string for each token.
Definition: cpl_string.cpp:759
CSLTestBoolean
int CSLTestBoolean(const char *pszValue)
Test what boolean value contained in the string.
Definition: cpl_string.cpp:1553
CPLStringList::empty
bool empty() const
Return whether the list is empty.
Definition: cpl_string.h:475
CPL_C_START
#define CPL_C_START
Macro to start a block of C symbols.
Definition: cpl_port.h:335
CPLForceToASCII
char * CPLForceToASCII(const char *pabyData, int nLen, char chReplacementChar) CPL_WARN_UNUSED_RESULT
Return a new string that is made only of ASCII characters.
Definition: cpl_recode.cpp:276
CPLString::Clear
void Clear()
Clear the string.
Definition: cpl_string.h:383
CPLHexToBinary
GByte * CPLHexToBinary(const char *pszHex, int *pnBytes) CPL_WARN_UNUSED_RESULT
Hexadecimal to binary translation.
Definition: cpl_string.cpp:2527
CSLLoad2
char ** CSLLoad2(const char *pszFname, int nMaxLines, int nMaxCols, CSLConstList papszOptions) CPL_WARN_UNUSED_RESULT
Load a text file into a string list.
Definition: cpl_string.cpp:316
CSLCount
int CSLCount(CSLConstList papszStrList)
Return number of items in a string list.
Definition: cpl_string.cpp:147
CPLBase64DecodeInPlace
int CPLBase64DecodeInPlace(GByte *pszBase64) CPL_WARN_UNUSED_RESULT
Decode base64 string "pszBase64" (null terminated) in place.
Definition: cpl_base64.cpp:93
CPLOPrintf
CPLString CPLOPrintf(const char *pszFormat,...)
Return a CPLString with the content of sprintf()
Definition: cplstring.cpp:526
CPLRecode
char * CPLRecode(const char *pszSource, const char *pszSrcEncoding, const char *pszDstEncoding) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL
Convert a string from a source encoding to a destination encoding.
Definition: cpl_recode.cpp:81
CPLURLGetValue
CPLString CPLURLGetValue(const char *pszURL, const char *pszKey)
Return the value matching a key from a key=value pair in a URL.
Definition: cplstring.cpp:443
CPLSPrintf
const char * CPLSPrintf(const char *fmt,...) CPL_WARN_UNUSED_RESULT
CPLSPrintf() that works with 10 static buffer.
Definition: cpl_string.cpp:977
CSLAppendPrintf
char ** CSLAppendPrintf(char **papszStrList, const char *fmt,...) CPL_WARN_UNUSED_RESULT
Use CPLSPrintf() to append a new line at the end of a StringList.
Definition: cpl_string.cpp:1029
CPLValueType
CPLValueType
Type of value.
Definition: cpl_string.h:196
CSLFetchNameValueDef
const char * CSLFetchNameValueDef(CSLConstList papszStrList, const char *pszName, const char *pszDefault)
Same as CSLFetchNameValue() but return pszDefault in case of no match.
Definition: cpl_string.cpp:1646
CPL_VALUE_REAL
Real number.
Definition: cpl_string.h:199
GByte
unsigned char GByte
Unsigned byte type.
Definition: cpl_port.h:213
CSLSetNameValue
char ** CSLSetNameValue(char **papszStrList, const char *pszName, const char *pszValue) CPL_WARN_UNUSED_RESULT
Assign value to name in StringList.
Definition: cpl_string.cpp:1877
CPLStringList::FindString
int FindString(const char *pszTarget) const
Return index of pszTarget in the list, or -1.
Definition: cpl_string.h:488
CSLGetField
const char * CSLGetField(CSLConstList, int)
Fetches the indicated field, being careful not to crash if the field doesn't exist within this string...
Definition: cpl_string.cpp:173
CSLAddString
char ** CSLAddString(char **papszStrList, const char *pszNewString) CPL_WARN_UNUSED_RESULT
Append a string to a StringList and return a pointer to the modified StringList.
Definition: cpl_string.cpp:83
CSLInsertString
char ** CSLInsertString(char **papszStrList, int nInsertAtLineNo, const char *pszNewLine) CPL_WARN_UNUSED_RESULT
Insert a string at a given line number inside a StringList.
Definition: cpl_string.cpp:562
CPLString::operator[]
char & operator[](int i)
Return character at specified index.
Definition: cpl_string.h:369
CPLStringList::PartialFindString
int PartialFindString(const char *pszNeedle) const
Return index of pszTarget in the list (using partial search), or -1.
Definition: cpl_string.h:491
CPLString
Convenient string class based on std::string.
Definition: cpl_string.h:336
CSLAddNameValue
char ** CSLAddNameValue(char **papszStrList, const char *pszName, const char *pszValue) CPL_WARN_UNUSED_RESULT
Add a new entry to a StringList of "Name=Value" pairs, ("Name:Value" pairs are also supported for bac...
Definition: cpl_string.cpp:1838
CPL_PRINT_FUNC_FORMAT
#define CPL_PRINT_FUNC_FORMAT(format_idx, arg_idx)
Tag a function to have printf() formatting.
Definition: cpl_port.h:904
CPLStrlcpy
size_t CPLStrlcpy(char *pszDest, const char *pszSrc, size_t nDestSize)
Copy source string to a destination buffer.
Definition: cpl_string.cpp:2698
CPLStrdup
char * CPLStrdup(const char *) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL
Safe version of strdup() function.
Definition: cpl_conv.cpp:292
CPLEscapeString
char * CPLEscapeString(const char *pszString, int nLength, int nScheme) CPL_WARN_UNUSED_RESULT
Apply escaping to string to preserve special characters.
Definition: cpl_string.cpp:2032
CPLStringList::IsSorted
int IsSorted() const
Returns whether the list is sorted.
Definition: cpl_string.h:534
CSLFetchNameValueMultiple
char ** CSLFetchNameValueMultiple(CSLConstList papszStrList, const char *pszName)
In a StringList of "Name=Value" pairs, look for all the values with the specified name...
Definition: cpl_string.cpp:1801
CSLPrint
int CSLPrint(CSLConstList papszStrList, FILE *fpOut)
Print a StringList to fpOut.
Definition: cpl_string.cpp:461
CSLPartialFindString
int CSLPartialFindString(CSLConstList papszHaystack, const char *pszNeedle)
Find a substring within a string list.
Definition: cpl_string.cpp:737
CPLString::CPLStringT
CPLStringT(const char *pszStr)
Constructor.
Definition: cpl_string.h:349
CSLInsertStrings
char ** CSLInsertStrings(char **papszStrList, int nInsertAtLineNo, CSLConstList papszNewLines) CPL_WARN_UNUSED_RESULT
Copies the contents of a StringList inside another StringList before the specified line...
Definition: cpl_string.cpp:497
CSLSetNameValueSeparator
void CSLSetNameValueSeparator(char **papszStrList, const char *pszSeparator)
Replace the default separator (":" or "=") with the passed separator in the given name/value list...
Definition: cpl_string.cpp:1957
CPLStringList::operator=
CPLStringList & operator=(char **papszListIn)
Assignment operator.
Definition: cpl_string.h:506
CPLStringList::operator[]
const char * operator[](const char *pszKey) const
Return value corresponding to pszKey, or nullptr.
Definition: cpl_string.h:523
cpl_error.h
CPL error handling services.
CPLprintf
int CPLprintf(const char *fmt,...)
printf() wrapper that is not sensitive to LC_NUMERIC settings.
Definition: cpl_string.cpp:1393
CPLString::Seize
void Seize(char *pszValue)
Assign specified string and take ownership of it (assumed to be allocated with CPLMalloc()).
Definition: cpl_string.h:388
CSLConstList
char ** CSLConstList
Type of a constant null-terminated list of nul terminated strings.
Definition: cpl_port.h:1184
CSLLoad
char ** CSLLoad(const char *pszFname) CPL_WARN_UNUSED_RESULT
Load a text file into a string list.
Definition: cpl_string.cpp:397
CPLStringList
String list class designed around our use of C "char**" string lists.
Definition: cpl_string.h:447
CPLBinaryToHex
char * CPLBinaryToHex(int nBytes, const GByte *pabyData) CPL_WARN_UNUSED_RESULT
Binary to hexadecimal translation.
Definition: cpl_string.cpp:2469
CPLString::CPLStringT
CPLStringT(const char *pszStr, size_t n)
Constructor.
Definition: cpl_string.h:351
CSLAddStringMayFail
char ** CSLAddStringMayFail(char **papszStrList, const char *pszNewString) CPL_WARN_UNUSED_RESULT
Same as CSLAddString() but may return NULL in case of (memory) failure.
Definition: cpl_string.cpp:92
CPLFetchBool
bool CPLFetchBool(CSLConstList papszStrList, const char *pszKey, bool bDefault)
Check for boolean key value.
Definition: cpl_string.cpp:1600
CPLRecodeFromWChar
char * CPLRecodeFromWChar(const wchar_t *pwszSource, const char *pszSrcEncoding, const char *pszDstEncoding) CPL_WARN_UNUSED_RESULT
Convert wchar_t string to UTF-8.
Definition: cpl_recode.cpp:149
CPLFree
#define CPLFree
Alias of VSIFree()
Definition: cpl_conv.h:81
CPLStringList::size
int size() const
Return size of list.
Definition: cpl_string.h:471
CPLStringList::List
CSLConstList List() const
Return list.
Definition: cpl_string.h:529
CPLGetValueType
CPLValueType CPLGetValueType(const char *pszValue)
Detect the type of the value contained in a string, whether it is a real, an integer or a string Lead...
Definition: cpl_string.cpp:2566
cpl_conv.h
Various convenience functions for CPL.
CPLString::CPLStringT
CPLStringT(const std::string &oStr)
Constructor.
Definition: cpl_string.h:346
CPLsnprintf
int CPLsnprintf(char *str, size_t size, const char *fmt,...)
snprintf() wrapper that is not sensitive to LC_NUMERIC settings.
Definition: cpl_string.cpp:1337
CPLvsnprintf
int CPLvsnprintf(char *str, size_t size, const char *fmt, va_list args)
vsnprintf() wrapper that is not sensitive to LC_NUMERIC settings.
Definition: cpl_string.cpp:1140
CPLTestBoolean
int CPLTestBoolean(const char *pszValue)
Test what boolean value contained in the string.
Definition: cpl_string.cpp:1575
CPLStrnlen
size_t CPLStrnlen(const char *pszStr, size_t nMaxLen)
Returns the length of a NUL terminated string by reading at most the specified number of bytes...
Definition: cpl_string.cpp:2790
CPLStringList::operator[]
const char * operator[](size_t i) const
Return string at specified index.
Definition: cpl_string.h:520
CPLVASPrintf
int CPLVASPrintf(char **buf, const char *fmt, va_list args)
This is intended to serve as an easy to use C callable vasprintf() alternative.
Definition: cpl_string.cpp:1048
CPLString::Printf
CPLSTRING_DLL CPLString & Printf(const char *pszFormat,...)
Assign the content of the string using sprintf()
Definition: cplstring.cpp:67
CPL_FORMAT_STRING
#define CPL_FORMAT_STRING(arg)
Macro into which to wrap the format argument of a printf-like function.
Definition: cpl_port.h:919
CPLStringList::InsertString
CPLStringList & InsertString(int nInsertAtLineNo, const char *pszNewLine)
Insert into the list at identified location.
Definition: cpl_string.h:480
CPLURLAddKVP
CPLString CPLURLAddKVP(const char *pszURL, const char *pszKey, const char *pszValue)
Return a new URL with a new key=value pair.
Definition: cplstring.cpp:476
CPL_VALUE_STRING
String.
Definition: cpl_string.h:198
CPLString::operator[]
char & operator[](std::string::size_type i)
Return character at specified index.
Definition: cpl_string.h:357
CPL_RETURNS_NONNULL
#define CPL_RETURNS_NONNULL
Qualifier for a function that does not return NULL.
Definition: cpl_port.h:962
CPL_SCANF_FORMAT_STRING
#define CPL_SCANF_FORMAT_STRING(arg)
Macro into which to wrap the format argument of a sscanf-like function.
Definition: cpl_port.h:921
CPL_C_END
#define CPL_C_END
Macro to end a block of C symbols.
Definition: cpl_port.h:337
CSLSave
int CSLSave(CSLConstList papszStrList, const char *pszFname)
Write a StringList to a text file.
Definition: cpl_string.cpp:412
CPLString::operator[]
const char & operator[](std::string::size_type i) const
Return character at specified index.
Definition: cpl_string.h:363
CSLDuplicate
char ** CSLDuplicate(CSLConstList papszStrList) CPL_WARN_UNUSED_RESULT
Clone a string list.
Definition: cpl_string.cpp:228
CPLStringList::List
char ** List()
Return list.
Definition: cpl_string.h:527
CSLTokenizeString2
char ** CSLTokenizeString2(const char *pszString, const char *pszDelimiter, int nCSLTFlags) CPL_WARN_UNUSED_RESULT
Tokenize a string.
Definition: cpl_string.cpp:836
CPL_SCAN_FUNC_FORMAT
#define CPL_SCAN_FUNC_FORMAT(format_idx, arg_idx)
Tag a function to have scanf() formatting.
Definition: cpl_port.h:906
CPLTestBool
bool CPLTestBool(const char *pszValue)
Test what boolean value contained in the string.
Definition: cpl_string.cpp:1526
CSLFindString
int CSLFindString(CSLConstList papszList, const char *pszTarget)
Find a string within a string list (case insensitive).
Definition: cpl_string.cpp:670
CSLFindStringCaseSensitive
int CSLFindStringCaseSensitive(CSLConstList papszList, const char *pszTarget)
Find a string within a string list(case sensitive)
Definition: cpl_string.cpp:704
CPLParseNameValue
const char * CPLParseNameValue(const char *pszNameValue, char **ppszKey)
Parse NAME=VALUE string into name and value components.
Definition: cpl_string.cpp:1754
CSLFetchNameValue
const char * CSLFetchNameValue(CSLConstList papszStrList, const char *pszName)
In a StringList of "Name=Value" pairs, look for the first value associated with the specified name...
Definition: cpl_string.cpp:1674
CSLMerge
char ** CSLMerge(char **papszOrig, CSLConstList papszOverride) CPL_WARN_UNUSED_RESULT
Merge two lists.
Definition: cpl_string.cpp:268
CPLOvPrintf
CPLString CPLOvPrintf(const char *pszFormat, va_list args)
Return a CPLString with the content of vsprintf()
Definition: cplstring.cpp:545
CPLString::operator[]
const char & operator[](int i) const
Return character at specified index.
Definition: cpl_string.h:376
CSLDestroy
void CSLDestroy(char **papszStrList)
Free string list.
Definition: cpl_string.cpp:200
CPLIsUTF8
int CPLIsUTF8(const char *pabyData, int nLen)
Test if a string is encoded as UTF-8.
Definition: cpl_recode.cpp:251
CPLUnescapeString
char * CPLUnescapeString(const char *pszString, int *pnLength, int nScheme) CPL_WARN_UNUSED_RESULT
Unescape a string.
Definition: cpl_string.cpp:2243
CPLRecodeToWChar
wchar_t * CPLRecodeToWChar(const char *pszSource, const char *pszSrcEncoding, const char *pszDstEncoding) CPL_WARN_UNUSED_RESULT
Convert UTF-8 string to a wchar_t string.
Definition: cpl_recode.cpp:208
CSLParseCommandLine
char ** CSLParseCommandLine(const char *pszCommandLine)
Tokenize command line arguments in a list of strings.
Definition: cpl_string.cpp:2814
CPLStrlenUTF8
int CPLStrlenUTF8(const char *pszUTF8Str)
Return the number of UTF-8 characters of a nul-terminated string.
Definition: cpl_recode.cpp:363
CPLStringList::operator[]
char * operator[](size_t i)
Return string at specified index.
Definition: cpl_string.h:516
CSLTokenizeStringComplex
char ** CSLTokenizeStringComplex(const char *pszString, const char *pszDelimiter, int bHonourStrings, int bAllowEmptyTokens) CPL_WARN_UNUSED_RESULT
Obsolete tokenizing api.
Definition: cpl_string.cpp:769
CPL_WARN_UNUSED_RESULT
#define CPL_WARN_UNUSED_RESULT
Qualifier to warn when the return value of a function is not used.
Definition: cpl_port.h:929
CPLString::CPLStringT
CPLStringT(void)
Constructor.
Definition: cpl_string.h:343
CPL_VALUE_INTEGER
Integer.
Definition: cpl_string.h:200
CSLFetchBoolean
int CSLFetchBoolean(CSLConstList papszStrList, const char *pszKey, int bDefault)
DEPRECATED.
Definition: cpl_string.cpp:1635
CSLRemoveStrings
char ** CSLRemoveStrings(char **papszStrList, int nFirstLineToDelete, int nNumToRemove, char ***ppapszRetStrings) CPL_WARN_UNUSED_RESULT
Remove strings inside a StringList.
Definition: cpl_string.cpp:588

Generated for GDAL by 1.8.8.