GDAL
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 spatialys.com>
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
39#include <stdbool.h>
40
64
65char CPL_DLL **CSLAddString(char **papszStrList,
66 const char *pszNewString) CPL_WARN_UNUSED_RESULT;
67char CPL_DLL **CSLAddStringMayFail(
68 char **papszStrList, const char *pszNewString) CPL_WARN_UNUSED_RESULT;
69int CPL_DLL CSLCount(CSLConstList papszStrList);
70const char CPL_DLL *CSLGetField( CSLConstList, int );
71void CPL_DLL CPL_STDCALL CSLDestroy(char **papszStrList);
72char CPL_DLL **CSLDuplicate(CSLConstList papszStrList) CPL_WARN_UNUSED_RESULT;
73char CPL_DLL **CSLMerge( char **papszOrig,
75
76char CPL_DLL **CSLTokenizeString(const char *pszString ) CPL_WARN_UNUSED_RESULT;
77char CPL_DLL **CSLTokenizeStringComplex(
78 const char *pszString, const char *pszDelimiter, int bHonourStrings,
79 int bAllowEmptyTokens ) CPL_WARN_UNUSED_RESULT;
80char CPL_DLL **CSLTokenizeString2( const char *pszString,
81 const char *pszDelimiter,
82 int nCSLTFlags ) CPL_WARN_UNUSED_RESULT;
83
85#define CSLT_HONOURSTRINGS 0x0001
87#define CSLT_ALLOWEMPTYTOKENS 0x0002
89#define CSLT_PRESERVEQUOTES 0x0004
91#define CSLT_PRESERVEESCAPES 0x0008
93#define CSLT_STRIPLEADSPACES 0x0010
95#define CSLT_STRIPENDSPACES 0x0020
96
97int CPL_DLL CSLPrint(CSLConstList papszStrList, FILE *fpOut);
98char CPL_DLL **CSLLoad(const char *pszFname) CPL_WARN_UNUSED_RESULT;
99char CPL_DLL **CSLLoad2(
100 const char *pszFname, int nMaxLines, int nMaxCols,
102int CPL_DLL CSLSave(CSLConstList papszStrList, const char *pszFname);
103
104char CPL_DLL **CSLInsertStrings(char **papszStrList, int nInsertAtLineNo,
106char CPL_DLL **CSLInsertString(char **papszStrList, int nInsertAtLineNo,
107 const char *pszNewLine) CPL_WARN_UNUSED_RESULT;
108char CPL_DLL **CSLRemoveStrings(
109 char **papszStrList, int nFirstLineToDelete,
110 int nNumToRemove, char ***ppapszRetStrings) CPL_WARN_UNUSED_RESULT;
111int CPL_DLL CSLFindString( CSLConstList papszList, const char *pszTarget );
112int CPL_DLL CSLFindStringCaseSensitive( CSLConstList papszList,
113 const char *pszTarget );
114int CPL_DLL CSLPartialFindString( CSLConstList papszHaystack,
115 const char *pszNeedle );
116int CPL_DLL CSLFindName(CSLConstList papszStrList, const char *pszName);
117int CPL_DLL CSLFetchBoolean( CSLConstList papszStrList, const char *pszKey,
118 int bDefault );
119
120/* TODO: Deprecate CSLTestBoolean. Remove in GDAL 3.x. */
121int CPL_DLL CSLTestBoolean( const char *pszValue );
122/* Do not use CPLTestBoolean in C++ code. Use CPLTestBool. */
123int CPL_DLL CPLTestBoolean( const char *pszValue );
124
125bool CPL_DLL CPLTestBool( const char *pszValue );
126bool CPL_DLL CPLFetchBool( CSLConstList papszStrList, const char *pszKey,
127 bool bDefault );
128
129const char CPL_DLL *
130 CPLParseNameValue( const char *pszNameValue, char **ppszKey );
131
132const char CPL_DLL *
133 CSLFetchNameValue( CSLConstList papszStrList, const char *pszName);
134const char CPL_DLL *
136 const char *pszName,
137 const char *pszDefault );
138char CPL_DLL **
139 CSLFetchNameValueMultiple(CSLConstList papszStrList, const char *pszName);
140char CPL_DLL **
141 CSLAddNameValue(char **papszStrList,
142 const char *pszName,
143 const char *pszValue) CPL_WARN_UNUSED_RESULT;
144char CPL_DLL **
145 CSLSetNameValue(char **papszStrList,
146 const char *pszName,
147 const char *pszValue) CPL_WARN_UNUSED_RESULT;
148void CPL_DLL CSLSetNameValueSeparator( char ** papszStrList,
149 const char *pszSeparator );
150
151char CPL_DLL ** CSLParseCommandLine(const char* pszCommandLine);
152
154#define CPLES_BackslashQuotable 0
156#define CPLES_XML 1
158#define CPLES_URL 2
160#define CPLES_SQL 3
162#define CPLES_CSV 4
164#define CPLES_XML_BUT_QUOTES 5
166#define CPLES_CSV_FORCE_QUOTING 6
168#define CPLES_SQLI 7
169
170char CPL_DLL *CPLEscapeString( const char *pszString, int nLength,
171 int nScheme ) CPL_WARN_UNUSED_RESULT;
172char CPL_DLL *CPLUnescapeString( const char *pszString, int *pnLength,
173 int nScheme ) CPL_WARN_UNUSED_RESULT;
174
175char CPL_DLL *CPLBinaryToHex( int nBytes,
176 const GByte *pabyData ) CPL_WARN_UNUSED_RESULT;
177GByte CPL_DLL *CPLHexToBinary( const char *pszHex,
178 int *pnBytes ) CPL_WARN_UNUSED_RESULT;
179
180char CPL_DLL *CPLBase64Encode( int nBytes,
181 const GByte *pabyData ) CPL_WARN_UNUSED_RESULT;
182int CPL_DLL CPLBase64DecodeInPlace( GByte* pszBase64 ) CPL_WARN_UNUSED_RESULT;
183
185typedef enum
186{
191
192CPLValueType CPL_DLL CPLGetValueType(const char* pszValue);
193
194size_t CPL_DLL CPLStrlcpy(char* pszDest, const char* pszSrc, size_t nDestSize);
195size_t CPL_DLL CPLStrlcat(char* pszDest, const char* pszSrc, size_t nDestSize);
196size_t CPL_DLL CPLStrnlen(const char *pszStr, size_t nMaxLen);
197
198/* -------------------------------------------------------------------- */
199/* Locale independent formatting functions. */
200/* -------------------------------------------------------------------- */
201int CPL_DLL CPLvsnprintf( char *str, size_t size,
202 CPL_FORMAT_STRING(const char* fmt),
203 va_list args )
205
206/* ALIAS_CPLSNPRINTF_AS_SNPRINTF might be defined to enable GCC 7 */
207/* -Wformat-truncation= warnings, but shouldn't be set for normal use */
208#if defined(ALIAS_CPLSNPRINTF_AS_SNPRINTF)
209#define CPLsnprintf snprintf
210#else
211int CPL_DLL CPLsnprintf( char *str, size_t size,
212 CPL_FORMAT_STRING(const char* fmt), ... )
214#endif
215
217#if defined(GDAL_COMPILATION) && !defined(DONT_DEPRECATE_SPRINTF)
218int CPL_DLL CPLsprintf( char *str, CPL_FORMAT_STRING(const char* fmt), ... )
220 CPL_WARN_DEPRECATED("Use CPLsnprintf instead");
221#else
222int CPL_DLL CPLsprintf( char *str, CPL_FORMAT_STRING(const char* fmt), ... )
224#endif
226int CPL_DLL CPLprintf( CPL_FORMAT_STRING(const char* fmt), ... )
228
229/* For some reason Doxygen_Suppress is needed to avoid warning. Not sure why */
231/* caution: only works with limited number of formats */
232int CPL_DLL CPLsscanf( const char* str,
233 CPL_SCANF_FORMAT_STRING(const char* fmt), ... )
237const char CPL_DLL *CPLSPrintf( CPL_FORMAT_STRING(const char *fmt), ... )
239char CPL_DLL **CSLAppendPrintf( char **papszStrList,
240 CPL_FORMAT_STRING(const char *fmt), ... )
242int CPL_DLL CPLVASPrintf( char **buf,
243 CPL_FORMAT_STRING(const char *fmt), va_list args )
245
246/* -------------------------------------------------------------------- */
247/* RFC 23 character set conversion/recoding API (cpl_recode.cpp). */
248/* -------------------------------------------------------------------- */
250#define CPL_ENC_LOCALE ""
252#define CPL_ENC_UTF8 "UTF-8"
254#define CPL_ENC_UTF16 "UTF-16"
256#define CPL_ENC_UCS2 "UCS-2"
258#define CPL_ENC_UCS4 "UCS-4"
260#define CPL_ENC_ASCII "ASCII"
262#define CPL_ENC_ISO8859_1 "ISO-8859-1"
263
264int CPL_DLL CPLEncodingCharSize( const char *pszEncoding );
266void CPL_DLL CPLClearRecodeWarningFlags( void );
268char CPL_DLL *CPLRecode(
269 const char *pszSource, const char *pszSrcEncoding,
270 const char *pszDstEncoding ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
271char CPL_DLL *CPLRecodeFromWChar(
272 const wchar_t *pwszSource, const char *pszSrcEncoding,
273 const char *pszDstEncoding ) CPL_WARN_UNUSED_RESULT;
274wchar_t CPL_DLL *CPLRecodeToWChar(
275 const char *pszSource, const char *pszSrcEncoding,
276 const char *pszDstEncoding ) CPL_WARN_UNUSED_RESULT;
277int CPL_DLL CPLIsUTF8( const char* pabyData, int nLen );
278bool CPL_DLL CPLIsASCII( const char* pabyData, size_t nLen );
279char CPL_DLL *CPLForceToASCII(
280 const char* pabyData, int nLen,
281 char chReplacementChar ) CPL_WARN_UNUSED_RESULT;
282int CPL_DLL CPLStrlenUTF8( const char *pszUTF8Str );
283int CPL_DLL CPLCanRecode(
284 const char *pszTestStr, const char *pszSrcEncoding,
285 const char *pszDstEncoding) CPL_WARN_UNUSED_RESULT;
287
288/************************************************************************/
289/* CPLString */
290/************************************************************************/
291
292#if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
293
294extern "C++"
295{
296#ifndef DOXYGEN_SKIP
297#include <string>
298#endif
299
300// VC++ implicitly applies __declspec(dllexport) to template base classes
301// of classes marked with __declspec(dllexport).
302// Hence, if marked with CPL_DLL, VC++ would export symbols for the specialization
303// of std::basic_string<char>, since it is a base class of CPLString.
304// As a result, if an application linked both gdal.dll and a static library that
305// (implicitly) instantiates std::string (almost all do!), then the linker would
306// emit an error concerning duplicate symbols for std::string.
307// The least intrusive solution is to not mark the whole class with
308// __declspec(dllexport) for VC++, but only its non-inline methods.
309#ifdef _MSC_VER
310# define CPLSTRING_CLASS_DLL
311# define CPLSTRING_METHOD_DLL CPL_DLL
312#else
314# define CPLSTRING_CLASS_DLL CPL_DLL
315# define CPLSTRING_METHOD_DLL
317#endif
318
320class CPLSTRING_CLASS_DLL CPLString : public std::string
321{
322public:
323
325 CPLString(void) {}
327 // cppcheck-suppress noExplicitConstructor
328 CPLString( const std::string &oStr ) : std::string( oStr ) {}
330 // cppcheck-suppress noExplicitConstructor
331 CPLString( const char *pszStr ) : std::string( pszStr ) {}
333 CPLString( const char *pszStr, size_t n ) : std::string( pszStr, n ) {}
334
336 operator const char* (void) const { return c_str(); }
337
339 char& operator[](std::string::size_type i)
340 {
341 return std::string::operator[](i);
342 }
343
345 const char& operator[](std::string::size_type i) const
346 {
347 return std::string::operator[](i);
348 }
349
351 char& operator[](int i)
352 {
353 return std::string::operator[](
354 static_cast<std::string::size_type>(i));
355 }
356
358 const char& operator[](int i) const
359 {
360 return std::string::operator[](
361 static_cast<std::string::size_type>(i));
362 }
363
365 void Clear() { resize(0); }
366
370 void Seize( char *pszValue )
371 {
372 if (pszValue == nullptr )
373 Clear();
374 else
375 {
376 *this = pszValue;
377 CPLFree(pszValue);
378 }
379 }
380
381 /* There seems to be a bug in the way the compiler count indices...
382 * Should be CPL_PRINT_FUNC_FORMAT (1, 2) */
383 CPLSTRING_METHOD_DLL CPLString &Printf(
384 CPL_FORMAT_STRING(const char *pszFormat), ... )
386 CPLSTRING_METHOD_DLL CPLString &vPrintf(
387 CPL_FORMAT_STRING(const char *pszFormat), va_list args )
389 CPLSTRING_METHOD_DLL CPLString &FormatC( double dfValue, const char *pszFormat = nullptr );
390 CPLSTRING_METHOD_DLL CPLString &Trim();
391 CPLSTRING_METHOD_DLL CPLString &Recode( const char *pszSrcEncoding, const char *pszDstEncoding );
392 CPLSTRING_METHOD_DLL CPLString &replaceAll(
393 const std::string &osBefore, const std::string& osAfter );
394 CPLSTRING_METHOD_DLL CPLString &replaceAll( const std::string &osBefore, char chAfter );
395 CPLSTRING_METHOD_DLL CPLString &replaceAll( char chBefore, const std::string &osAfter );
396 CPLSTRING_METHOD_DLL CPLString &replaceAll( char chBefore, char chAfter );
397
398 /* case insensitive find alternates */
399 CPLSTRING_METHOD_DLL size_t ifind( const std::string & str, size_t pos = 0 ) const;
400 CPLSTRING_METHOD_DLL size_t ifind( const char * s, size_t pos = 0 ) const;
401 CPLSTRING_METHOD_DLL CPLString &toupper( void );
402 CPLSTRING_METHOD_DLL CPLString &tolower( void );
403
404 CPLSTRING_METHOD_DLL bool endsWith( const std::string& osStr ) const;
405};
406
407#undef CPLSTRING_CLASS_DLL
408#undef CPLSTRING_METHOD_DLL
409
410CPLString CPL_DLL CPLOPrintf(CPL_FORMAT_STRING(const char *pszFormat), ... )
412CPLString CPL_DLL CPLOvPrintf(
413 CPL_FORMAT_STRING(const char *pszFormat), va_list args)
415CPLString CPL_DLL CPLQuotedSQLIdentifier(const char *pszIdent);
416
417/* -------------------------------------------------------------------- */
418/* URL processing functions, here since they depend on CPLString. */
419/* -------------------------------------------------------------------- */
420CPLString CPL_DLL CPLURLGetValue(const char* pszURL, const char* pszKey);
421CPLString CPL_DLL CPLURLAddKVP(const char* pszURL, const char* pszKey,
422 const char* pszValue);
423
424/************************************************************************/
425/* CPLStringList */
426/************************************************************************/
427
429class CPL_DLL CPLStringList
430{
431 char **papszList = nullptr;
432 mutable int nCount = 0;
433 mutable int nAllocation = 0;
434 bool bOwnList = false;
435 bool bIsSorted = false;
436
437 bool MakeOurOwnCopy();
438 bool EnsureAllocation( int nMaxLength );
439 int FindSortedInsertionPoint( const char *pszLine );
440
441 public:
443 explicit CPLStringList( char **papszList, int bTakeOwnership=TRUE );
444 explicit CPLStringList( CSLConstList papszList );
445 CPLStringList( const CPLStringList& oOther );
447
448 CPLStringList &Clear();
449
451 int size() const { return Count(); }
452 int Count() const;
453
455 bool empty() const { return Count() == 0; }
456
457 CPLStringList &AddString( const char *pszNewString );
458 CPLStringList &AddStringDirectly( char *pszNewString );
459
460 CPLStringList &InsertString( int nInsertAtLineNo, const char *pszNewLine )
461 { return InsertStringDirectly( nInsertAtLineNo, CPLStrdup(pszNewLine) ); }
462 CPLStringList &InsertStringDirectly( int nInsertAtLineNo, char *pszNewLine);
463
464 // CPLStringList &InsertStrings( int nInsertAtLineNo, char **papszNewLines );
465 // CPLStringList &RemoveStrings( int nFirstLineToDelete, int nNumToRemove=1 );
466
468 int FindString( const char *pszTarget ) const
469 { return CSLFindString( papszList, pszTarget ); }
471 int PartialFindString( const char *pszNeedle ) const
472 { return CSLPartialFindString( papszList, pszNeedle ); }
473
474 int FindName( const char *pszName ) const;
475 bool FetchBool( const char *pszKey, bool bDefault ) const;
476 // Deprecated.
477 int FetchBoolean( const char *pszKey, int bDefault ) const;
478 const char *FetchNameValue( const char *pszKey ) const;
479 const char *FetchNameValueDef(
480 const char *pszKey, const char *pszDefault ) const;
481 CPLStringList &AddNameValue( const char *pszKey, const char *pszValue );
482 CPLStringList &SetNameValue( const char *pszKey, const char *pszValue );
483
484 CPLStringList &Assign( char **papszListIn, int bTakeOwnership=TRUE );
486 CPLStringList &operator=(char **papszListIn) {
487 return Assign( papszListIn, TRUE ); }
489 CPLStringList &operator=(const CPLStringList& oOther);
493 CPLStringList &operator=(CPLStringList&& oOther);
494
496 char * operator[](int i);
498 char * operator[](size_t i) { return (*this)[static_cast<int>(i)]; }
500 const char * operator[](int i) const;
502 const char * operator[](size_t i) const {
503 return (*this)[static_cast<int>(i)]; }
505 const char * operator[](const char* pszKey) const {
506 return FetchNameValue(pszKey); }
507
509 char** List() { return papszList; }
511 CSLConstList List() const { return papszList; }
512 char **StealList();
513
514 CPLStringList &Sort();
516 int IsSorted() const { return bIsSorted; }
517
519 operator char**(void) { return List(); }
521 operator CSLConstList(void) const { return List(); }
522};
523
524#ifdef GDAL_COMPILATION
525
526#include <memory>
527
529struct CPL_DLL CSLDestroyReleaser
530{
531 void operator()(char** papszStr) const { CSLDestroy(papszStr); }
532};
536using CSLUniquePtr = std::unique_ptr< char*, CSLDestroyReleaser>;
537
539struct CPL_DLL CPLFreeReleaser
540{
541 void operator()(void* p) const { CPLFree(p); }
542};
546using CPLCharUniquePtr = std::unique_ptr<char, CPLFreeReleaser>;
547
548#endif
549
550} // extern "C++"
551
552#endif /* def __cplusplus && !CPL_SUPRESS_CPLUSPLUS */
553
554#endif /* CPL_STRING_H_INCLUDED */
String list class designed around our use of C "char**" string lists.
Definition: cpl_string.h:430
const char * operator[](size_t i) const
Return string at specified index.
Definition: cpl_string.h:502
const char * operator[](const char *pszKey) const
Return value corresponding to pszKey, or nullptr.
Definition: cpl_string.h:505
int IsSorted() const
Returns whether the list is sorted.
Definition: cpl_string.h:516
bool empty() const
Return whether the list is empty.
Definition: cpl_string.h:455
CPLStringList & operator=(CSLConstList papszListIn)
Assignment operator.
char ** List()
Return list.
Definition: cpl_string.h:509
CPLStringList & InsertString(int nInsertAtLineNo, const char *pszNewLine)
Insert into the list at identified location.
Definition: cpl_string.h:460
CPLStringList & operator=(char **papszListIn)
Assignment operator.
Definition: cpl_string.h:486
char * operator[](size_t i)
Return string at specified index.
Definition: cpl_string.h:498
int size() const
Return size of list.
Definition: cpl_string.h:451
CSLConstList List() const
Return list.
Definition: cpl_string.h:511
int FindString(const char *pszTarget) const
Return index of pszTarget in the list, or -1.
Definition: cpl_string.h:468
int PartialFindString(const char *pszNeedle) const
Return index of pszTarget in the list (using partial search), or -1.
Definition: cpl_string.h:471
Convenient string class based on std::string.
Definition: cpl_string.h:321
void Clear()
Clear the string.
Definition: cpl_string.h:365
CPLString(void)
Constructor.
Definition: cpl_string.h:325
const char & operator[](std::string::size_type i) const
Return character at specified index.
Definition: cpl_string.h:345
CPLString(const std::string &oStr)
Constructor.
Definition: cpl_string.h:328
void Seize(char *pszValue)
Assign specified string and take ownership of it (assumed to be allocated with CPLMalloc()).
Definition: cpl_string.h:370
char & operator[](int i)
Return character at specified index.
Definition: cpl_string.h:351
const char & operator[](int i) const
Return character at specified index.
Definition: cpl_string.h:358
char & operator[](std::string::size_type i)
Return character at specified index.
Definition: cpl_string.h:339
CPLString(const char *pszStr, size_t n)
Constructor.
Definition: cpl_string.h:333
CPLString(const char *pszStr)
Constructor.
Definition: cpl_string.h:331
Various convenience functions for CPL.
#define CPLFree
Alias of VSIFree()
Definition: cpl_conv.h:83
char * CPLStrdup(const char *)
Safe version of strdup() function.
Definition: cpl_conv.cpp:302
CPL error handling services.
#define CPL_SCAN_FUNC_FORMAT(format_idx, arg_idx)
Tag a function to have scanf() formatting.
Definition: cpl_port.h:846
#define CPL_C_END
Macro to end a block of C symbols.
Definition: cpl_port.h:306
#define CPL_C_START
Macro to start a block of C symbols.
Definition: cpl_port.h:304
#define CPL_FORMAT_STRING(arg)
Macro into which to wrap the format argument of a printf-like function.
Definition: cpl_port.h:859
#define CPL_RETURNS_NONNULL
Qualifier for a function that does not return NULL.
Definition: cpl_port.h:902
#define CPL_PRINT_FUNC_FORMAT(format_idx, arg_idx)
Tag a function to have printf() formatting.
Definition: cpl_port.h:844
char ** CSLConstList
Type of a constant null-terminated list of nul terminated strings.
Definition: cpl_port.h:1056
#define CPL_WARN_UNUSED_RESULT
Qualifier to warn when the return value of a function is not used.
Definition: cpl_port.h:869
#define CPL_SCANF_FORMAT_STRING(arg)
Macro into which to wrap the format argument of a sscanf-like function.
Definition: cpl_port.h:861
unsigned char GByte
Unsigned byte type.
Definition: cpl_port.h:203
int CSLFindStringCaseSensitive(CSLConstList papszList, const char *pszTarget)
Find a string within a string list(case sensitive)
Definition: cpl_string.cpp:711
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:1157
char * CPLEscapeString(const char *pszString, int nLength, int nScheme)
Apply escaping to string to preserve special characters.
Definition: cpl_string.cpp:2057
char * CPLBinaryToHex(int nBytes, const GByte *pabyData)
Binary to hexadecimal translation.
Definition: cpl_string.cpp:2642
char ** CSLTokenizeStringComplex(const char *pszString, const char *pszDelimiter, int bHonourStrings, int bAllowEmptyTokens)
Obsolete tokenizing api.
Definition: cpl_string.cpp:776
int CPLprintf(const char *fmt,...)
printf() wrapper that is not sensitive to LC_NUMERIC settings.
Definition: cpl_string.cpp:1410
int CPLBase64DecodeInPlace(GByte *pszBase64)
Decode base64 string "pszBase64" (null terminated) in place.
Definition: cpl_base64.cpp:93
char ** CSLAddNameValue(char **papszStrList, const char *pszName, const char *pszValue)
Add a new entry to a StringList of "Name=Value" pairs, ("Name:Value" pairs are also supported for bac...
Definition: cpl_string.cpp:1859
CPLString CPLQuotedSQLIdentifier(const char *pszIdent)
Return a CPLString of the SQL quoted identifier.
Definition: cplstring.cpp:537
CPLString CPLOPrintf(const char *pszFormat,...)
Return a CPLString with the content of sprintf()
Definition: cplstring.cpp:505
size_t CPLStrlcat(char *pszDest, const char *pszSrc, size_t nDestSize)
Appends a source string to a destination buffer.
Definition: cpl_string.cpp:2928
int CSLPrint(CSLConstList papszStrList, FILE *fpOut)
Print a StringList to fpOut.
Definition: cpl_string.cpp:468
char * CPLForceToASCII(const char *pabyData, int nLen, char chReplacementChar)
Return a new string that is made only of ASCII characters.
Definition: cpl_recode.cpp:336
char ** CSLTokenizeString2(const char *pszString, const char *pszDelimiter, int nCSLTFlags)
Tokenize a string.
Definition: cpl_string.cpp:843
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:422
size_t CPLStrlcpy(char *pszDest, const char *pszSrc, size_t nDestSize)
Copy source string to a destination buffer.
Definition: cpl_string.cpp:2871
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:1695
char * CPLRecodeFromWChar(const wchar_t *pwszSource, const char *pszSrcEncoding, const char *pszDstEncoding)
Convert wchar_t string to UTF-8.
Definition: cpl_recode.cpp:183
int CPLsnprintf(char *str, size_t size, const char *fmt,...)
snprintf() wrapper that is not sensitive to LC_NUMERIC settings.
Definition: cpl_string.cpp:1354
bool CPLIsASCII(const char *pabyData, size_t nLen)
Test if a string is encoded as ASCII.
Definition: cpl_recode.cpp:304
CPLValueType
Type of value.
Definition: cpl_string.h:186
@ CPL_VALUE_INTEGER
Integer.
Definition: cpl_string.h:189
@ CPL_VALUE_STRING
String.
Definition: cpl_string.h:187
@ CPL_VALUE_REAL
Real number.
Definition: cpl_string.h:188
void CSLDestroy(char **papszStrList)
Free string list.
Definition: cpl_string.cpp:202
bool CPLFetchBool(CSLConstList papszStrList, const char *pszKey, bool bDefault)
Check for boolean key value.
Definition: cpl_string.cpp:1621
int CSLFindName(CSLConstList papszStrList, const char *pszName)
Find StringList entry with given key name.
Definition: cpl_string.cpp:1729
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:1065
int CPLCanRecode(const char *pszTestStr, const char *pszSrcEncoding, const char *pszDstEncoding)
Checks if it is possible to recode a string from one encoding to another.
Definition: cpl_recode.cpp:451
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:175
int CSLFindString(CSLConstList papszList, const char *pszTarget)
Find a string within a string list (case insensitive).
Definition: cpl_string.cpp:677
int CSLSave(CSLConstList papszStrList, const char *pszFname)
Write a StringList to a text file.
Definition: cpl_string.cpp:419
bool CPLTestBool(const char *pszValue)
Test what boolean value contained in the string.
Definition: cpl_string.cpp:1547
char ** CSLParseCommandLine(const char *pszCommandLine)
Tokenize command line arguments in a list of strings.
Definition: cpl_string.cpp:2987
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:1667
int CSLCount(CSLConstList papszStrList)
Return number of items in a string list.
Definition: cpl_string.cpp:149
char ** CSLAddString(char **papszStrList, const char *pszNewString)
Append a string to a StringList and return a pointer to the modified StringList.
Definition: cpl_string.cpp:85
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:2963
char ** CSLInsertString(char **papszStrList, int nInsertAtLineNo, const char *pszNewLine)
Insert a string at a given line number inside a StringList.
Definition: cpl_string.cpp:569
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:1978
int CPLIsUTF8(const char *pabyData, int nLen)
Test if a string is encoded as UTF-8.
Definition: cpl_recode.cpp:285
int CSLPartialFindString(CSLConstList papszHaystack, const char *pszNeedle)
Find a substring within a string list.
Definition: cpl_string.cpp:744
char ** CSLTokenizeString(const char *pszString)
Tokenizes a string and returns a StringList with one string for each token.
Definition: cpl_string.cpp:766
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:1822
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:2739
char ** CSLSetNameValue(char **papszStrList, const char *pszName, const char *pszValue)
Assign value to name in StringList.
Definition: cpl_string.cpp:1898
char ** CSLRemoveStrings(char **papszStrList, int nFirstLineToDelete, int nNumToRemove, char ***ppapszRetStrings)
Remove strings inside a StringList.
Definition: cpl_string.cpp:595
char ** CSLLoad(const char *pszFname)
Load a text file into a string list.
Definition: cpl_string.cpp:404
char * CPLRecode(const char *pszSource, const char *pszSrcEncoding, const char *pszDstEncoding)
Convert a string from a source encoding to a destination encoding.
Definition: cpl_recode.cpp:81
char ** CSLLoad2(const char *pszFname, int nMaxLines, int nMaxCols, CSLConstList papszOptions)
Load a text file into a string list.
Definition: cpl_string.cpp:323
CPLString CPLURLAddKVP(const char *pszURL, const char *pszKey, const char *pszValue)
Return a new URL with a new key=value pair.
Definition: cplstring.cpp:455
int CSLFetchBoolean(CSLConstList papszStrList, const char *pszKey, int bDefault)
DEPRECATED.
Definition: cpl_string.cpp:1656
int CPLStrlenUTF8(const char *pszUTF8Str)
Return the number of UTF-8 characters of a nul-terminated string.
Definition: cpl_recode.cpp:425
char ** CSLAppendPrintf(char **papszStrList, const char *fmt,...)
Use CPLSPrintf() to append a new line at the end of a StringList.
Definition: cpl_string.cpp:1046
char ** CSLInsertStrings(char **papszStrList, int nInsertAtLineNo, CSLConstList papszNewLines)
Copies the contents of a StringList inside another StringList before the specified line.
Definition: cpl_string.cpp:504
CPLString CPLOvPrintf(const char *pszFormat, va_list args)
Return a CPLString with the content of vsprintf()
Definition: cplstring.cpp:524
char ** CSLDuplicate(CSLConstList papszStrList)
Clone a string list.
Definition: cpl_string.cpp:230
const char * CPLParseNameValue(const char *pszNameValue, char **ppszKey)
Parse NAME=VALUE string into name and value components.
Definition: cpl_string.cpp:1775
int CSLTestBoolean(const char *pszValue)
Test what boolean value contained in the string.
Definition: cpl_string.cpp:1574
const char * CPLSPrintf(const char *fmt,...)
CPLSPrintf() that works with 10 static buffer.
Definition: cpl_string.cpp:994
GByte * CPLHexToBinary(const char *pszHex, int *pnBytes)
Hexadecimal to binary translation.
Definition: cpl_string.cpp:2700
char ** CSLMerge(char **papszOrig, CSLConstList papszOverride)
Merge two lists.
Definition: cpl_string.cpp:275
char ** CSLAddStringMayFail(char **papszStrList, const char *pszNewString)
Same as CSLAddString() but may return NULL in case of (memory) failure.
Definition: cpl_string.cpp:94
int CPLEncodingCharSize(const char *pszEncoding)
Return bytes per character for encoding.
Definition: cpl_recode.cpp:378
char * CPLUnescapeString(const char *pszString, int *pnLength, int nScheme)
Unescape a string.
Definition: cpl_string.cpp:2415
char * CPLBase64Encode(int nBytes, const GByte *pabyData)
Base64 encode a buffer.
Definition: cpl_base64.cpp:199
int CPLTestBoolean(const char *pszValue)
Test what boolean value contained in the string.
Definition: cpl_string.cpp:1596
wchar_t * CPLRecodeToWChar(const char *pszSource, const char *pszSrcEncoding, const char *pszDstEncoding)
Convert UTF-8 string to a wchar_t string.
Definition: cpl_recode.cpp:242
Standard C Covers.