GDAL
cpl_conv.h
Go to the documentation of this file.
1/******************************************************************************
2 * $Id$
3 *
4 * Project: CPL - Common Portability Library
5 * Purpose: Convenience functions declarations.
6 * This is intended to remain light weight.
7 * Author: Frank Warmerdam, warmerdam@pobox.com
8 *
9 ******************************************************************************
10 * Copyright (c) 1998, Frank Warmerdam
11 * Copyright (c) 2007-2013, 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
24 * OR 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_CONV_H_INCLUDED
33#define CPL_CONV_H_INCLUDED
34
35#include "cpl_port.h"
36#include "cpl_vsi.h"
37#include "cpl_error.h"
38
46/* -------------------------------------------------------------------- */
47/* Runtime check of various configuration items. */
48/* -------------------------------------------------------------------- */
50
52void CPL_DLL CPLVerifyConfiguration(void);
55const char CPL_DLL * CPL_STDCALL
56CPLGetConfigOption( const char *, const char * ) CPL_WARN_UNUSED_RESULT;
57const char CPL_DLL * CPL_STDCALL
58CPLGetThreadLocalConfigOption( const char *, const char * ) CPL_WARN_UNUSED_RESULT;
59void CPL_DLL CPL_STDCALL CPLSetConfigOption( const char *, const char * );
60void CPL_DLL CPL_STDCALL CPLSetThreadLocalConfigOption( const char *pszKey,
61 const char *pszValue );
63void CPL_DLL CPL_STDCALL CPLFreeConfig(void);
65char CPL_DLL** CPLGetConfigOptions(void);
66void CPL_DLL CPLSetConfigOptions(const char* const * papszConfigOptions);
67char CPL_DLL** CPLGetThreadLocalConfigOptions(void);
68void CPL_DLL CPLSetThreadLocalConfigOptions(const char* const * papszConfigOptions);
69void CPL_DLL CPLLoadConfigOptionsFromFile(const char* pszFilename, int bOverrideEnvVars);
71
72/* -------------------------------------------------------------------- */
73/* Safe malloc() API. Thin cover over VSI functions with fatal */
74/* error reporting if memory allocation fails. */
75/* -------------------------------------------------------------------- */
76void CPL_DLL *CPLMalloc( size_t ) CPL_WARN_UNUSED_RESULT;
77void CPL_DLL *CPLCalloc( size_t, size_t ) CPL_WARN_UNUSED_RESULT;
78void CPL_DLL *CPLRealloc( void *, size_t ) CPL_WARN_UNUSED_RESULT;
79char CPL_DLL *CPLStrdup( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
80char CPL_DLL *CPLStrlwr( char *);
81
83#define CPLFree VSIFree
84
85/* -------------------------------------------------------------------- */
86/* Read a line from a text file, and strip of CR/LF. */
87/* -------------------------------------------------------------------- */
88char CPL_DLL *CPLFGets( char *, int, FILE *);
89const char CPL_DLL *CPLReadLine( FILE * );
90const char CPL_DLL *CPLReadLineL( VSILFILE * );
91const char CPL_DLL *CPLReadLine2L( VSILFILE *, int, CSLConstList );
92const char CPL_DLL *CPLReadLine3L( VSILFILE *, int, int *, CSLConstList );
93
94/* -------------------------------------------------------------------- */
95/* Convert ASCII string to floating point number */
96/* (THESE FUNCTIONS ARE NOT LOCALE AWARE!). */
97/* -------------------------------------------------------------------- */
98double CPL_DLL CPLAtof(const char *);
99double CPL_DLL CPLAtofDelim(const char *, char);
100double CPL_DLL CPLStrtod(const char *, char **);
101double CPL_DLL CPLStrtodDelim(const char *, char **, char);
102float CPL_DLL CPLStrtof(const char *, char **);
103float CPL_DLL CPLStrtofDelim(const char *, char **, char);
104
105/* -------------------------------------------------------------------- */
106/* Convert number to string. This function is locale agnostic */
107/* (i.e. it will support "," or "." regardless of current locale) */
108/* -------------------------------------------------------------------- */
109double CPL_DLL CPLAtofM(const char *);
110
111/* -------------------------------------------------------------------- */
112/* Read a numeric value from an ASCII character string. */
113/* -------------------------------------------------------------------- */
114char CPL_DLL *CPLScanString( const char *, int, int, int );
115double CPL_DLL CPLScanDouble( const char *, int );
116long CPL_DLL CPLScanLong( const char *, int );
117unsigned long CPL_DLL CPLScanULong( const char *, int );
118GUIntBig CPL_DLL CPLScanUIntBig( const char *, int );
119GIntBig CPL_DLL CPLAtoGIntBig( const char* pszString );
120GIntBig CPL_DLL CPLAtoGIntBigEx( const char* pszString, int bWarn, int *pbOverflow );
121void CPL_DLL *CPLScanPointer( const char *, int );
122
123/* -------------------------------------------------------------------- */
124/* Print a value to an ASCII character string. */
125/* -------------------------------------------------------------------- */
126int CPL_DLL CPLPrintString( char *, const char *, int );
127int CPL_DLL CPLPrintStringFill( char *, const char *, int );
128int CPL_DLL CPLPrintInt32( char *, GInt32 , int );
129int CPL_DLL CPLPrintUIntBig( char *, GUIntBig , int );
130int CPL_DLL CPLPrintDouble( char *, const char *, double, const char * );
131int CPL_DLL CPLPrintTime( char *, int , const char *, const struct tm *,
132 const char * );
133int CPL_DLL CPLPrintPointer( char *, void *, int );
134
135/* -------------------------------------------------------------------- */
136/* Fetch a function from DLL / so. */
137/* -------------------------------------------------------------------- */
138
139void CPL_DLL *CPLGetSymbol( const char *, const char * );
140
141/* -------------------------------------------------------------------- */
142/* Fetch executable path. */
143/* -------------------------------------------------------------------- */
144int CPL_DLL CPLGetExecPath( char *pszPathBuf, int nMaxLength );
145
146/* -------------------------------------------------------------------- */
147/* Filename handling functions. */
148/* -------------------------------------------------------------------- */
149const char CPL_DLL *CPLGetPath( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
150const char CPL_DLL *CPLGetDirname( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
151const char CPL_DLL *CPLGetFilename( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
152const char CPL_DLL *CPLGetBasename( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
153const char CPL_DLL *CPLGetExtension( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
154char CPL_DLL *CPLGetCurrentDir(void);
155const char CPL_DLL *CPLFormFilename( const char *pszPath,
156 const char *pszBasename,
157 const char *pszExtension ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
158const char CPL_DLL *CPLFormCIFilename( const char *pszPath,
159 const char *pszBasename,
160 const char *pszExtension ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
161const char CPL_DLL *CPLResetExtension( const char *, const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
162const char CPL_DLL *CPLProjectRelativeFilename( const char *pszProjectDir,
163 const char *pszSecondaryFilename ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
164int CPL_DLL CPLIsFilenameRelative( const char *pszFilename );
165const char CPL_DLL *CPLExtractRelativePath(const char *, const char *, int *) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
166const char CPL_DLL *CPLCleanTrailingSlash( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
167char CPL_DLL **CPLCorrespondingPaths( const char *pszOldFilename,
168 const char *pszNewFilename,
169 char **papszFileList ) CPL_WARN_UNUSED_RESULT;
170int CPL_DLL CPLCheckForFile( char *pszFilename, char **papszSiblingList );
171
172const char CPL_DLL *CPLGenerateTempFilename( const char *pszStem ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
173const char CPL_DLL *CPLExpandTilde( const char *pszFilename ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
174const char CPL_DLL *CPLGetHomeDir(void) CPL_WARN_UNUSED_RESULT;
175const char CPL_DLL *CPLLaunderForFilename(const char* pszName,
176 const char* pszOutputPath ) CPL_WARN_UNUSED_RESULT;
177
178/* -------------------------------------------------------------------- */
179/* Find File Function */
180/* -------------------------------------------------------------------- */
181
183typedef char const *(*CPLFileFinder)(const char *, const char *);
184
185const char CPL_DLL *CPLFindFile(const char *pszClass,
186 const char *pszBasename);
187const char CPL_DLL *CPLDefaultFindFile(const char *pszClass,
188 const char *pszBasename);
189void CPL_DLL CPLPushFileFinder( CPLFileFinder pfnFinder );
190CPLFileFinder CPL_DLL CPLPopFileFinder(void);
191void CPL_DLL CPLPushFinderLocation( const char * );
192void CPL_DLL CPLPopFinderLocation(void);
193void CPL_DLL CPLFinderClean(void);
194
195/* -------------------------------------------------------------------- */
196/* Safe version of stat() that works properly on stuff like "C:". */
197/* -------------------------------------------------------------------- */
198int CPL_DLL CPLStat( const char *, VSIStatBuf * ) CPL_WARN_UNUSED_RESULT;
199
200/* -------------------------------------------------------------------- */
201/* Reference counted file handle manager. Makes sharing file */
202/* handles more practical. */
203/* -------------------------------------------------------------------- */
204
206typedef struct {
207 FILE *fp;
209 int bLarge;
211 char *pszAccess;
213
214FILE CPL_DLL *CPLOpenShared( const char *, const char *, int );
215void CPL_DLL CPLCloseShared( FILE * );
216CPLSharedFileInfo CPL_DLL *CPLGetSharedList( int * );
217void CPL_DLL CPLDumpSharedList( FILE * );
219void CPL_DLL CPLCleanupSharedFileMutex( void );
222/* -------------------------------------------------------------------- */
223/* DMS to Dec to DMS conversion. */
224/* -------------------------------------------------------------------- */
225double CPL_DLL CPLDMSToDec( const char *is );
226const char CPL_DLL *CPLDecToDMS( double dfAngle, const char * pszAxis,
227 int nPrecision );
228double CPL_DLL CPLPackedDMSToDec( double );
229double CPL_DLL CPLDecToPackedDMS( double dfDec );
230
231void CPL_DLL CPLStringToComplex( const char *pszString,
232 double *pdfReal, double *pdfImag );
233
234/* -------------------------------------------------------------------- */
235/* Misc other functions. */
236/* -------------------------------------------------------------------- */
237int CPL_DLL CPLUnlinkTree( const char * );
238int CPL_DLL CPLCopyFile( const char *pszNewPath, const char *pszOldPath );
239int CPL_DLL CPLCopyTree( const char *pszNewPath, const char *pszOldPath );
240int CPL_DLL CPLMoveFile( const char *pszNewPath, const char *pszOldPath );
241int CPL_DLL CPLSymlink( const char* pszOldPath, const char* pszNewPath, CSLConstList papszOptions );
242
243/* -------------------------------------------------------------------- */
244/* ZIP Creation. */
245/* -------------------------------------------------------------------- */
246
248#define CPL_ZIP_API_OFFERED
250void CPL_DLL *CPLCreateZip( const char *pszZipFilename, char **papszOptions );
251CPLErr CPL_DLL CPLCreateFileInZip( void *hZip, const char *pszFilename,
252 char **papszOptions );
253CPLErr CPL_DLL CPLWriteFileInZip( void *hZip, const void *pBuffer, int nBufferSize );
254CPLErr CPL_DLL CPLCloseFileInZip( void *hZip );
255CPLErr CPL_DLL CPLCloseZip( void *hZip );
256
257/* -------------------------------------------------------------------- */
258/* ZLib compression */
259/* -------------------------------------------------------------------- */
260
261void CPL_DLL *CPLZLibDeflate( const void* ptr, size_t nBytes, int nLevel,
262 void* outptr, size_t nOutAvailableBytes,
263 size_t* pnOutBytes );
264void CPL_DLL *CPLZLibInflate( const void* ptr, size_t nBytes,
265 void* outptr, size_t nOutAvailableBytes,
266 size_t* pnOutBytes );
267
268/* -------------------------------------------------------------------- */
269/* XML validation. */
270/* -------------------------------------------------------------------- */
271int CPL_DLL CPLValidateXML(const char* pszXMLFilename,
272 const char* pszXSDFilename,
273 CSLConstList papszOptions);
274
275/* -------------------------------------------------------------------- */
276/* Locale handling. Prevents parallel executions of setlocale(). */
277/* -------------------------------------------------------------------- */
278char* CPLsetlocale (int category, const char* locale);
280void CPLCleanupSetlocaleMutex(void);
288int CPL_DLL CPLIsPowerOfTwo( unsigned int i );
289
291
292/* -------------------------------------------------------------------- */
293/* C++ object for temporarily forcing a LC_NUMERIC locale to "C". */
294/* -------------------------------------------------------------------- */
295
297#if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
298
299extern "C++"
300{
301class CPL_DLL CPLLocaleC
302{
303 CPL_DISALLOW_COPY_ASSIGN(CPLLocaleC)
304public:
305 CPLLocaleC();
306 ~CPLLocaleC();
307
308private:
309 char *pszOldLocale;
310};
311
312// Does the same as CPLLocaleC except that, when available, it tries to
313// only affect the current thread. But code that would be dependent of
314// setlocale(LC_NUMERIC, NULL) returning "C", such as current proj.4 versions,
315// will not work depending on the actual implementation
316class CPLThreadLocaleCPrivate;
317class CPL_DLL CPLThreadLocaleC
318{
319 CPL_DISALLOW_COPY_ASSIGN(CPLThreadLocaleC)
320
321public:
322 CPLThreadLocaleC();
323 ~CPLThreadLocaleC();
324
325private:
326 CPLThreadLocaleCPrivate* m_private;
327};
328}
329
330#endif /* def __cplusplus */
332
333
334
335/* -------------------------------------------------------------------- */
336/* C++ object for temporarily forcing a config option */
337/* -------------------------------------------------------------------- */
338
340#if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
341
342extern "C++"
343{
344class CPL_DLL CPLConfigOptionSetter
345{
346 CPL_DISALLOW_COPY_ASSIGN(CPLConfigOptionSetter)
347public:
348 CPLConfigOptionSetter(const char* pszKey, const char* pszValue,
349 bool bSetOnlyIfUndefined);
350 ~CPLConfigOptionSetter();
351
352private:
353 char* m_pszKey;
354 char *m_pszOldValue;
355 bool m_bRestoreOldValue;
356};
357}
358
359#endif /* def __cplusplus */
361
362#if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
363
364extern "C++"
365{
366
367#ifndef DOXYGEN_SKIP
368#include <type_traits> // for std::is_base_of
369#endif
370
371namespace cpl
372{
382 template<typename To, typename From> inline To down_cast(From* f)
383 {
384 static_assert(
385 (std::is_base_of<From,
386 typename std::remove_pointer<To>::type>::value),
387 "target type not derived from source type");
388 CPLAssert(f == nullptr || dynamic_cast<To>(f) != nullptr);
389 return static_cast<To>(f);
390 }
391}
392} // extern "C++"
393
394#endif /* def __cplusplus */
395
396
397#if defined(__cplusplus) && defined(GDAL_COMPILATION)
398
399extern "C++"
400{
401#include <memory> // for std::unique_ptr
402namespace cpl
403{
405 template <typename T, typename... Args>
406 std::unique_ptr<T> make_unique(Args &&... args) {
407 return std::unique_ptr<T>(new T(std::forward<Args>(args)...));
408 }
409}
410} // extern "C++"
411
412#endif /* def __cplusplus */
413
414#endif /* ndef CPL_CONV_H_INCLUDED */
const char * CPLGetHomeDir(void)
Return the path to the home directory.
Definition: cpl_path.cpp:1191
const char * CPLExpandTilde(const char *pszFilename)
Expands ~/ at start of filename.
Definition: cpl_path.cpp:1163
void * CPLCreateZip(const char *pszZipFilename, char **papszOptions)
Create ZIP file.
Definition: cpl_conv.cpp:3378
double CPLAtofDelim(const char *, char)
Converts ASCII string to floating point number.
Definition: cpl_strtod.cpp:65
int CPLPrintStringFill(char *, const char *, int)
Copy the string pointed to by pszSrc, NOT including the terminating ‘\0’ character,...
Definition: cpl_conv.cpp:1256
void * CPLGetSymbol(const char *, const char *)
Fetch a function pointer from a shared library / DLL.
Definition: cplgetsymbol.cpp:89
int CPLIsFilenameRelative(const char *pszFilename)
Is filename relative or absolute?
Definition: cpl_path.cpp:829
const char * CPLReadLine2L(VSILFILE *, int, CSLConstList)
Simplified line reading from text file.
Definition: cpl_conv.cpp:661
int CPLPrintUIntBig(char *, GUIntBig, int)
Print GUIntBig value into specified string buffer.
Definition: cpl_conv.cpp:1339
int CPLCopyTree(const char *pszNewPath, const char *pszOldPath)
Recursively copy a tree.
Definition: cpl_conv.cpp:2993
void CPLCloseShared(FILE *)
Close shared file.
Definition: cpl_conv.cpp:2695
float CPLStrtof(const char *, char **)
Converts ASCII string to floating point number.
Definition: cpl_strtod.cpp:388
char * CPLsetlocale(int category, const char *locale)
Prevents parallel executions of setlocale().
Definition: cpl_conv.cpp:3279
const char * CPLReadLine3L(VSILFILE *, int, int *, CSLConstList)
Simplified line reading from text file.
Definition: cpl_conv.cpp:691
double CPLStrtod(const char *, char **)
Converts ASCII string to floating point number.
Definition: cpl_strtod.cpp:318
const char * CPLGetExtension(const char *)
Extract filename extension from full filename.
Definition: cpl_path.cpp:345
void CPLLoadConfigOptionsFromFile(const char *pszFilename, int bOverrideEnvVars)
Load configuration from a given configuration file.
Definition: cpl_conv.cpp:2058
int CPLMoveFile(const char *pszNewPath, const char *pszOldPath)
Move a file.
Definition: cpl_conv.cpp:3071
char ** CPLGetThreadLocalConfigOptions(void)
Return the list of thread local configuration options as KEY=VALUE pairs.
Definition: cpl_conv.cpp:1938
int CPLPrintInt32(char *, GInt32, int)
Print GInt32 value into specified string buffer.
Definition: cpl_conv.cpp:1300
long CPLScanLong(const char *, int)
Scan up to a maximum number of characters from a string and convert the result to a long.
Definition: cpl_conv.cpp:915
void CPLSetConfigOptions(const char *const *papszConfigOptions)
Replace the full list of configuration options with the passed list of KEY=VALUE pairs.
Definition: cpl_conv.cpp:1765
void * CPLRealloc(void *, size_t)
Safe version of realloc().
Definition: cpl_conv.cpp:234
char const *(* CPLFileFinder)(const char *, const char *)
Callback for CPLPushFileFinder.
Definition: cpl_conv.h:183
float CPLStrtofDelim(const char *, char **, char)
Converts ASCII string to floating point number using specified delimiter.
Definition: cpl_strtod.cpp:344
void * CPLZLibInflate(const void *ptr, size_t nBytes, void *outptr, size_t nOutAvailableBytes, size_t *pnOutBytes)
Uncompress a buffer compressed with ZLib compression.
Definition: cpl_conv.cpp:3403
int CPLSymlink(const char *pszOldPath, const char *pszNewPath, CSLConstList papszOptions)
Create a symbolic link.
Definition: cpl_conv.cpp:3092
const char * CPLGetBasename(const char *)
Extract basename (non-directory, non-extension) portion of filename.
Definition: cpl_path.cpp:292
const char * CPLLaunderForFilename(const char *pszName, const char *pszOutputPath)
Launder a string to be compatible of a filename.
Definition: cpl_path.cpp:1218
void * CPLMalloc(size_t)
Safe version of malloc().
Definition: cpl_conv.cpp:177
const char * CPLGetDirname(const char *)
Extract directory path portion of filename.
Definition: cpl_path.cpp:208
int CPLGetExecPath(char *pszPathBuf, int nMaxLength)
Fetch path of executable.
Definition: cpl_getexecpath.cpp:132
const char * CPLFormCIFilename(const char *pszPath, const char *pszBasename, const char *pszExtension)
Case insensitive file searching, returning full path.
Definition: cpl_path.cpp:670
char * CPLScanString(const char *, int, int, int)
Scan up to a maximum number of characters from a given string, allocate a buffer for a new string and...
Definition: cpl_conv.cpp:855
int CPLPrintTime(char *, int, const char *, const struct tm *, const char *)
Print specified time value accordingly to the format options and specified locale name.
Definition: cpl_conv.cpp:1489
void CPLFinderClean(void)
CPLFinderClean.
Definition: cpl_findfile.cpp:134
void * CPLCalloc(size_t, size_t)
Safe version of calloc().
Definition: cpl_conv.cpp:147
GIntBig CPLAtoGIntBigEx(const char *pszString, int bWarn, int *pbOverflow)
Convert a string to a 64 bit signed integer.
Definition: cpl_conv.cpp:1045
void * CPLScanPointer(const char *, int)
Extract pointer from string.
Definition: cpl_conv.cpp:1094
const char * CPLGenerateTempFilename(const char *pszStem)
Generate temporary file name.
Definition: cpl_path.cpp:1120
const char * CPLGetPath(const char *)
Extract directory path portion of filename.
Definition: cpl_path.cpp:153
char ** CPLCorrespondingPaths(const char *pszOldFilename, const char *pszNewFilename, char **papszFileList)
Identify corresponding paths.
Definition: cpl_path.cpp:1015
char * CPLStrdup(const char *)
Safe version of strdup() function.
Definition: cpl_conv.cpp:302
CPLErr CPLCreateFileInZip(void *hZip, const char *pszFilename, char **papszOptions)
Create a file in a ZIP file.
Definition: cpl_conv.cpp:3386
void CPLLoadConfigOptionsFromPredefinedFiles(void)
Load configuration from a set of predefined files.
Definition: cpl_conv.cpp:2250
char ** CPLGetConfigOptions(void)
Return the list of configuration options as KEY=VALUE pairs.
Definition: cpl_conv.cpp:1739
double CPLDMSToDec(const char *is)
CPLDMSToDec.
Definition: cpl_conv.cpp:2334
const char * CPLCleanTrailingSlash(const char *)
Remove trailing forward/backward slash from the path for UNIX/Windows resp.
Definition: cpl_path.cpp:964
const char * CPLReadLineL(VSILFILE *)
Simplified line reading from text file.
Definition: cpl_conv.cpp:639
const char * CPLReadLine(FILE *)
Simplified line reading from text file.
Definition: cpl_conv.cpp:575
int CPLValidateXML(const char *pszXMLFilename, const char *pszXSDFilename, CSLConstList papszOptions)
Validate a XML file against a XML schema.
Definition: cpl_xml_validate.cpp:1081
CPLErr CPLCloseZip(void *hZip)
Close ZIP file.
Definition: cpl_conv.cpp:3392
const char * CPLResetExtension(const char *, const char *)
Replace the extension with the provided one.
Definition: cpl_path.cpp:443
FILE * CPLOpenShared(const char *, const char *, int)
Open a shared file handle.
Definition: cpl_conv.cpp:2622
void CPLPushFinderLocation(const char *)
CPLPushFinderLocation.
Definition: cpl_findfile.cpp:248
char * CPLGetCurrentDir(void)
Get the current working directory name.
Definition: cpl_path.cpp:425
void CPLPushFileFinder(CPLFileFinder pfnFinder)
CPLPushFileFinder.
Definition: cpl_findfile.cpp:200
int CPLStat(const char *, VSIStatBuf *)
Same as VSIStat() except it works on "C:" as if it were "C:\".
Definition: cpl_conv.cpp:2285
double CPLDecToPackedDMS(double dfDec)
Convert decimal degrees into packed DMS value (DDDMMMSSS.SS).
Definition: cpl_conv.cpp:2543
const char * CPLExtractRelativePath(const char *, const char *, int *)
Get relative path from directory to target file.
Definition: cpl_path.cpp:872
const char * CPLGetThreadLocalConfigOption(const char *, const char *)
Same as CPLGetConfigOption() but only with options set with CPLSetThreadLocalConfigOption()
Definition: cpl_conv.cpp:1780
void CPLPopFinderLocation(void)
CPLPopFinderLocation.
Definition: cpl_findfile.cpp:287
double CPLAtofM(const char *)
Converts ASCII string to floating point number using any numeric locale.
Definition: cpl_strtod.cpp:134
void CPLSetConfigOption(const char *, const char *)
Set a configuration option for GDAL/OGR use.
Definition: cpl_conv.cpp:1844
char * CPLFGets(char *, int, FILE *)
Reads in at most one less than nBufferSize characters from the fp stream and stores them into the buf...
Definition: cpl_conv.cpp:373
GIntBig CPLAtoGIntBig(const char *pszString)
Convert a string to a 64 bit signed integer.
Definition: cpl_conv.cpp:999
double CPLPackedDMSToDec(double)
Convert a packed DMS value (DDDMMMSSS.SS) into decimal degrees.
Definition: cpl_conv.cpp:2509
void CPLDumpSharedList(FILE *)
Report open shared files.
Definition: cpl_conv.cpp:2808
int CPLUnlinkTree(const char *)
Recursively unlink a directory.
Definition: cpl_conv.cpp:2846
const char * CPLProjectRelativeFilename(const char *pszProjectDir, const char *pszSecondaryFilename)
Find a file relative to a project file.
Definition: cpl_path.cpp:763
GUIntBig CPLScanUIntBig(const char *, int)
Extract big integer from string.
Definition: cpl_conv.cpp:973
const char * CPLDecToDMS(double dfAngle, const char *pszAxis, int nPrecision)
Translate a decimal degrees value to a DMS string with hemisphere.
Definition: cpl_conv.cpp:2416
const char * CPLFindFile(const char *pszClass, const char *pszBasename)
CPLFindFile.
Definition: cpl_findfile.cpp:177
double CPLScanDouble(const char *, int)
Extract double from string.
Definition: cpl_conv.cpp:1160
int CPLIsPowerOfTwo(unsigned int i)
Definition: cpl_conv.cpp:3305
const char * CPLGetConfigOption(const char *, const char *)
Get the value of a configuration option.
Definition: cpl_conv.cpp:1679
unsigned long CPLScanULong(const char *, int)
Scan up to a maximum number of characters from a string and convert the result to a unsigned long.
Definition: cpl_conv.cpp:943
void CPLSetThreadLocalConfigOption(const char *pszKey, const char *pszValue)
Set a configuration option for GDAL/OGR use.
Definition: cpl_conv.cpp:1899
double CPLStrtodDelim(const char *, char **, char)
Converts ASCII string to floating point number using specified delimiter.
Definition: cpl_strtod.cpp:226
To down_cast(From *f)
Use cpl::down_cast<Derived*>(pointer_to_base) as equivalent of static_cast<Derived*>(pointer_to_base)...
Definition: cpl_conv.h:382
const char * CPLGetFilename(const char *)
Extract non-directory portion of filename.
Definition: cpl_path.cpp:260
char * CPLStrlwr(char *)
Convert each characters of the string to lower case.
Definition: cpl_conv.cpp:328
int CPLCopyFile(const char *pszNewPath, const char *pszOldPath)
Copy a file.
Definition: cpl_conv.cpp:2931
const char * CPLFormFilename(const char *pszPath, const char *pszBasename, const char *pszExtension)
Build a full file path from a passed path, file basename and extension.
Definition: cpl_path.cpp:550
int CPLPrintDouble(char *, const char *, double, const char *)
Print double value into specified string buffer.
Definition: cpl_conv.cpp:1431
void * CPLZLibDeflate(const void *ptr, size_t nBytes, int nLevel, void *outptr, size_t nOutAvailableBytes, size_t *pnOutBytes)
Compress a buffer with ZLib compression.
Definition: cpl_conv.cpp:3394
int CPLPrintString(char *, const char *, int)
Copy the string pointed to by pszSrc, NOT including the terminating ‘\0’ character,...
Definition: cpl_conv.cpp:1212
CPLErr CPLCloseFileInZip(void *hZip)
Close current file inside ZIP file.
Definition: cpl_conv.cpp:3390
const char * CPLDefaultFindFile(const char *pszClass, const char *pszBasename)
CPLDefaultFindFile.
Definition: cpl_findfile.cpp:149
CPLErr CPLWriteFileInZip(void *hZip, const void *pBuffer, int nBufferSize)
Write in current file inside a ZIP file.
Definition: cpl_conv.cpp:3388
CPLFileFinder CPLPopFileFinder(void)
CPLPopFileFinder.
Definition: cpl_findfile.cpp:237
int CPLPrintPointer(char *, void *, int)
Print pointer value into specified string buffer.
Definition: cpl_conv.cpp:1387
void CPLStringToComplex(const char *pszString, double *pdfReal, double *pdfImag)
Fetch the real and imaginary part of a serialized complex number.
Definition: cpl_conv.cpp:2560
void CPLSetThreadLocalConfigOptions(const char *const *papszConfigOptions)
Replace the full list of thread local configuration options with the passed list of KEY=VALUE pairs.
Definition: cpl_conv.cpp:1968
int CPLCheckForFile(char *pszFilename, char **papszSiblingList)
Check for file existence.
Definition: cpl_conv.cpp:3340
CPLSharedFileInfo * CPLGetSharedList(int *)
Fetch list of open shared files.
Definition: cpl_conv.cpp:2786
double CPLAtof(const char *)
Converts ASCII string to floating point number.
Definition: cpl_strtod.cpp:109
CPL error handling services.
#define CPLAssert(expr)
Assert on an expression.
Definition: cpl_error.h:198
CPLErr
Error category.
Definition: cpl_error.h:53
Core portability definitions for CPL.
unsigned long long GUIntBig
Large unsigned integer type (generally 64-bit unsigned integer type).
Definition: cpl_port.h:233
#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_RETURNS_NONNULL
Qualifier for a function that does not return NULL.
Definition: cpl_port.h:902
#define CPL_DISALLOW_COPY_ASSIGN(ClassName)
Helper to remove the copy and assignment constructors so that the compiler will not generate the defa...
Definition: cpl_port.h:930
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
int GInt32
Int32 type.
Definition: cpl_port.h:193
long long GIntBig
Large signed integer type (generally 64-bit integer type).
Definition: cpl_port.h:230
Standard C Covers.
FILE VSILFILE
Opaque type for a FILE that implements the VSIVirtualHandle API.
Definition: cpl_vsi.h:158
Information on a shared file.
Definition: cpl_conv.h:206
char * pszAccess
Access mode.
Definition: cpl_conv.h:211
FILE * fp
File pointer.
Definition: cpl_conv.h:207
int nRefCount
Reference counter.
Definition: cpl_conv.h:208
char * pszFilename
Filename.
Definition: cpl_conv.h:210
int bLarge
Whether fp must be interpreted as VSIFILE*.
Definition: cpl_conv.h:209