308 lines
15 KiB
C++
308 lines
15 KiB
C++
/******************************************************************************
|
|
* $Id: cpl_conv.h 33666 2016-03-07 05:21:07Z goatbar $
|
|
*
|
|
* Project: CPL - Common Portability Library
|
|
* Purpose: Convenience functions declarations.
|
|
* This is intended to remain light weight.
|
|
* Author: Frank Warmerdam, warmerdam@pobox.com
|
|
*
|
|
******************************************************************************
|
|
* Copyright (c) 1998, Frank Warmerdam
|
|
* Copyright (c) 2007-2013, Even Rouault <even dot rouault at mines-paris dot org>
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a
|
|
* copy of this software and associated documentation files (the "Software"),
|
|
* to deal in the Software without restriction, including without limitation
|
|
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
* and/or sell copies of the Software, and to permit persons to whom the
|
|
* Software is furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included
|
|
* in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
|
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
|
* DEALINGS IN THE SOFTWARE.
|
|
****************************************************************************/
|
|
|
|
#ifndef CPL_CONV_H_INCLUDED
|
|
#define CPL_CONV_H_INCLUDED
|
|
|
|
#include "cpl_port.h"
|
|
#include "cpl_vsi.h"
|
|
#include "cpl_error.h"
|
|
|
|
/**
|
|
* \file cpl_conv.h
|
|
*
|
|
* Various convenience functions for CPL.
|
|
*
|
|
*/
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Runtime check of various configuration items. */
|
|
/* -------------------------------------------------------------------- */
|
|
CPL_C_START
|
|
|
|
void CPL_DLL CPLVerifyConfiguration(void);
|
|
|
|
const char CPL_DLL * CPL_STDCALL
|
|
CPLGetConfigOption( const char *, const char * ) CPL_WARN_UNUSED_RESULT;
|
|
const char CPL_DLL * CPL_STDCALL
|
|
CPLGetThreadLocalConfigOption( const char *, const char * ) CPL_WARN_UNUSED_RESULT;
|
|
void CPL_DLL CPL_STDCALL CPLSetConfigOption( const char *, const char * );
|
|
void CPL_DLL CPL_STDCALL CPLSetThreadLocalConfigOption( const char *pszKey,
|
|
const char *pszValue );
|
|
void CPL_DLL CPL_STDCALL CPLFreeConfig(void);
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Safe malloc() API. Thin cover over VSI functions with fatal */
|
|
/* error reporting if memory allocation fails. */
|
|
/* -------------------------------------------------------------------- */
|
|
void CPL_DLL *CPLMalloc( size_t ) CPL_WARN_UNUSED_RESULT;
|
|
void CPL_DLL *CPLCalloc( size_t, size_t ) CPL_WARN_UNUSED_RESULT;
|
|
void CPL_DLL *CPLRealloc( void *, size_t ) CPL_WARN_UNUSED_RESULT;
|
|
char CPL_DLL *CPLStrdup( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
char CPL_DLL *CPLStrlwr( char *);
|
|
|
|
#define CPLFree VSIFree
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Read a line from a text file, and strip of CR/LF. */
|
|
/* -------------------------------------------------------------------- */
|
|
char CPL_DLL *CPLFGets( char *, int, FILE *);
|
|
const char CPL_DLL *CPLReadLine( FILE * );
|
|
const char CPL_DLL *CPLReadLineL( VSILFILE * );
|
|
const char CPL_DLL *CPLReadLine2L( VSILFILE * , int nMaxCols, char** papszOptions);
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Convert ASCII string to floating point number */
|
|
/* (THESE FUNCTIONS ARE NOT LOCALE AWARE!). */
|
|
/* -------------------------------------------------------------------- */
|
|
double CPL_DLL CPLAtof(const char *);
|
|
double CPL_DLL CPLAtofDelim(const char *, char);
|
|
double CPL_DLL CPLStrtod(const char *, char **);
|
|
double CPL_DLL CPLStrtodDelim(const char *, char **, char);
|
|
float CPL_DLL CPLStrtof(const char *, char **);
|
|
float CPL_DLL CPLStrtofDelim(const char *, char **, char);
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Convert number to string. This function is locale agnostic */
|
|
/* (i.e. it will support "," or "." regardless of current locale) */
|
|
/* -------------------------------------------------------------------- */
|
|
double CPL_DLL CPLAtofM(const char *);
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Read a numeric value from an ASCII character string. */
|
|
/* -------------------------------------------------------------------- */
|
|
char CPL_DLL *CPLScanString( const char *, int, int, int );
|
|
double CPL_DLL CPLScanDouble( const char *, int );
|
|
long CPL_DLL CPLScanLong( const char *, int );
|
|
unsigned long CPL_DLL CPLScanULong( const char *, int );
|
|
GUIntBig CPL_DLL CPLScanUIntBig( const char *, int );
|
|
GIntBig CPL_DLL CPLAtoGIntBig( const char* pszString );
|
|
GIntBig CPL_DLL CPLAtoGIntBigEx( const char* pszString, int bWarn, int *pbOverflow );
|
|
void CPL_DLL *CPLScanPointer( const char *, int );
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Print a value to an ASCII character string. */
|
|
/* -------------------------------------------------------------------- */
|
|
int CPL_DLL CPLPrintString( char *, const char *, int );
|
|
int CPL_DLL CPLPrintStringFill( char *, const char *, int );
|
|
int CPL_DLL CPLPrintInt32( char *, GInt32 , int );
|
|
int CPL_DLL CPLPrintUIntBig( char *, GUIntBig , int );
|
|
int CPL_DLL CPLPrintDouble( char *, const char *, double, const char * );
|
|
int CPL_DLL CPLPrintTime( char *, int , const char *, const struct tm *,
|
|
const char * );
|
|
int CPL_DLL CPLPrintPointer( char *, void *, int );
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Fetch a function from DLL / so. */
|
|
/* -------------------------------------------------------------------- */
|
|
|
|
void CPL_DLL *CPLGetSymbol( const char *, const char * );
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Fetch executable path. */
|
|
/* -------------------------------------------------------------------- */
|
|
int CPL_DLL CPLGetExecPath( char *pszPathBuf, int nMaxLength );
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Filename handling functions. */
|
|
/* -------------------------------------------------------------------- */
|
|
const char CPL_DLL *CPLGetPath( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
const char CPL_DLL *CPLGetDirname( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
const char CPL_DLL *CPLGetFilename( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
const char CPL_DLL *CPLGetBasename( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
const char CPL_DLL *CPLGetExtension( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
char CPL_DLL *CPLGetCurrentDir(void);
|
|
const char CPL_DLL *CPLFormFilename( const char *pszPath,
|
|
const char *pszBasename,
|
|
const char *pszExtension ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
const char CPL_DLL *CPLFormCIFilename( const char *pszPath,
|
|
const char *pszBasename,
|
|
const char *pszExtension ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
const char CPL_DLL *CPLResetExtension( const char *, const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
const char CPL_DLL *CPLProjectRelativeFilename( const char *pszProjectDir,
|
|
const char *pszSecondaryFilename ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
int CPL_DLL CPLIsFilenameRelative( const char *pszFilename );
|
|
const char CPL_DLL *CPLExtractRelativePath(const char *, const char *, int *) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
const char CPL_DLL *CPLCleanTrailingSlash( const char * ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
char CPL_DLL **CPLCorrespondingPaths( const char *pszOldFilename,
|
|
const char *pszNewFilename,
|
|
char **papszFileList ) CPL_WARN_UNUSED_RESULT;
|
|
int CPL_DLL CPLCheckForFile( char *pszFilename, char **papszSiblingList );
|
|
|
|
const char CPL_DLL *CPLGenerateTempFilename( const char *pszStem ) CPL_WARN_UNUSED_RESULT CPL_RETURNS_NONNULL;
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Find File Function */
|
|
/* -------------------------------------------------------------------- */
|
|
typedef const char *(*CPLFileFinder)(const char *, const char *);
|
|
|
|
const char CPL_DLL *CPLFindFile(const char *pszClass,
|
|
const char *pszBasename);
|
|
const char CPL_DLL *CPLDefaultFindFile(const char *pszClass,
|
|
const char *pszBasename);
|
|
void CPL_DLL CPLPushFileFinder( CPLFileFinder pfnFinder );
|
|
CPLFileFinder CPL_DLL CPLPopFileFinder(void);
|
|
void CPL_DLL CPLPushFinderLocation( const char * );
|
|
void CPL_DLL CPLPopFinderLocation(void);
|
|
void CPL_DLL CPLFinderClean(void);
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Safe version of stat() that works properly on stuff like "C:". */
|
|
/* -------------------------------------------------------------------- */
|
|
int CPL_DLL CPLStat( const char *, VSIStatBuf * ) CPL_WARN_UNUSED_RESULT;
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Reference counted file handle manager. Makes sharing file */
|
|
/* handles more practical. */
|
|
/* -------------------------------------------------------------------- */
|
|
typedef struct {
|
|
FILE *fp;
|
|
int nRefCount;
|
|
int bLarge;
|
|
char *pszFilename;
|
|
char *pszAccess;
|
|
} CPLSharedFileInfo;
|
|
|
|
FILE CPL_DLL *CPLOpenShared( const char *, const char *, int );
|
|
void CPL_DLL CPLCloseShared( FILE * );
|
|
CPLSharedFileInfo CPL_DLL *CPLGetSharedList( int * );
|
|
void CPL_DLL CPLDumpSharedList( FILE * );
|
|
void CPL_DLL CPLCleanupSharedFileMutex( void );
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* DMS to Dec to DMS conversion. */
|
|
/* -------------------------------------------------------------------- */
|
|
double CPL_DLL CPLDMSToDec( const char *is );
|
|
const char CPL_DLL *CPLDecToDMS( double dfAngle, const char * pszAxis,
|
|
int nPrecision );
|
|
double CPL_DLL CPLPackedDMSToDec( double );
|
|
double CPL_DLL CPLDecToPackedDMS( double dfDec );
|
|
|
|
void CPL_DLL CPLStringToComplex( const char *pszString,
|
|
double *pdfReal, double *pdfImag );
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Misc other functions. */
|
|
/* -------------------------------------------------------------------- */
|
|
int CPL_DLL CPLUnlinkTree( const char * );
|
|
int CPL_DLL CPLCopyFile( const char *pszNewPath, const char *pszOldPath );
|
|
int CPL_DLL CPLCopyTree( const char *pszNewPath, const char *pszOldPath );
|
|
int CPL_DLL CPLMoveFile( const char *pszNewPath, const char *pszOldPath );
|
|
int CPL_DLL CPLSymlink( const char* pszOldPath, const char* pszNewPath, char** papszOptions );
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* ZIP Creation. */
|
|
/* -------------------------------------------------------------------- */
|
|
#define CPL_ZIP_API_OFFERED
|
|
void CPL_DLL *CPLCreateZip( const char *pszZipFilename, char **papszOptions );
|
|
CPLErr CPL_DLL CPLCreateFileInZip( void *hZip, const char *pszFilename,
|
|
char **papszOptions );
|
|
CPLErr CPL_DLL CPLWriteFileInZip( void *hZip, const void *pBuffer, int nBufferSize );
|
|
CPLErr CPL_DLL CPLCloseFileInZip( void *hZip );
|
|
CPLErr CPL_DLL CPLCloseZip( void *hZip );
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* ZLib compression */
|
|
/* -------------------------------------------------------------------- */
|
|
|
|
void CPL_DLL *CPLZLibDeflate( const void* ptr, size_t nBytes, int nLevel,
|
|
void* outptr, size_t nOutAvailableBytes,
|
|
size_t* pnOutBytes );
|
|
void CPL_DLL *CPLZLibInflate( const void* ptr, size_t nBytes,
|
|
void* outptr, size_t nOutAvailableBytes,
|
|
size_t* pnOutBytes );
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* XML validation. */
|
|
/* -------------------------------------------------------------------- */
|
|
int CPL_DLL CPLValidateXML(const char* pszXMLFilename,
|
|
const char* pszXSDFilename,
|
|
char** papszOptions);
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* Locale handling. Prevents parallel executions of setlocale(). */
|
|
/* -------------------------------------------------------------------- */
|
|
char* CPLsetlocale (int category, const char* locale);
|
|
void CPLCleanupSetlocaleMutex(void);
|
|
|
|
CPL_C_END
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/* C++ object for temporarily forcing a LC_NUMERIC locale to "C". */
|
|
/* -------------------------------------------------------------------- */
|
|
|
|
#if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
|
|
|
|
class CPL_DLL CPLLocaleC
|
|
{
|
|
public:
|
|
CPLLocaleC();
|
|
~CPLLocaleC();
|
|
|
|
private:
|
|
char *pszOldLocale;
|
|
|
|
/* Make it non-copyable */
|
|
CPLLocaleC(const CPLLocaleC&);
|
|
CPLLocaleC& operator=(const CPLLocaleC&);
|
|
};
|
|
|
|
// Does the same as CPLLocaleC except that, when available, it tries to
|
|
// only affect the current thread. But code that would be dependent of
|
|
// setlocale(LC_NUMERIC, NULL) returning "C", such as current proj.4 versions,
|
|
// will not work depending on the actual implementation
|
|
class CPL_DLL CPLThreadLocaleC
|
|
{
|
|
public:
|
|
CPLThreadLocaleC();
|
|
~CPLThreadLocaleC();
|
|
|
|
private:
|
|
#ifdef HAVE_USELOCALE
|
|
locale_t nNewLocale;
|
|
locale_t nOldLocale;
|
|
#else
|
|
#if defined(_MSC_VER)
|
|
int nOldValConfigThreadLocale;
|
|
#endif
|
|
char *pszOldLocale;
|
|
#endif
|
|
|
|
/* Make it non-copyable */
|
|
CPLThreadLocaleC(const CPLThreadLocaleC&);
|
|
CPLThreadLocaleC& operator=(const CPLThreadLocaleC&);
|
|
};
|
|
|
|
#endif /* def __cplusplus */
|
|
|
|
|
|
#endif /* ndef CPL_CONV_H_INCLUDED */
|