ossimCplUtil.cpp File Reference

#include <cstdlib>
#include <cstring>
#include <ossim/base/ossimCplUtil.h>
#include <ossim/base/ossimString.h>

Go to the source code of this file.

Macros
#define	OSSIM_CSLT_HONOURSTRINGS   0x0001
#define	OSSIM_CSLT_ALLOWEMPTYTOKENS   0x0002
#define	OSSIM_CSLT_PRESERVEQUOTES   0x0004
#define	OSSIM_CSLT_PRESERVEESCAPES   0x0008

Functions
int	ossimCSLFindString (char **papszList, const char *pszTarget)
char **	ossimCSLTokenizeString (const char *pszString)
char **	ossimCSLTokenizeStringComplex (const char *pszString, const char *pszDelimiters, int bHonourStrings, int bAllowEmptyTokens)
char **	ossimCSLTokenizeString2 (const char *pszString, const char *pszDelimiters, int nCSLTFlags)
int	ossimCSLCount (char **papszStrList)
void	ossimCSLDestroy (char **papszStrList)
void *	ossimCPLRealloc (void *pData, size_t nNewSize)

Macro Definition Documentation

OSSIM_CSLT_ALLOWEMPTYTOKENS

#define OSSIM_CSLT_ALLOWEMPTYTOKENS   0x0002

Definition at line 44 of file ossimCplUtil.cpp.

Referenced by ossimCSLTokenizeString2(), and ossimCSLTokenizeStringComplex().

OSSIM_CSLT_HONOURSTRINGS

#define OSSIM_CSLT_HONOURSTRINGS   0x0001

Definition at line 41 of file ossimCplUtil.cpp.

Referenced by ossimCSLTokenizeString(), ossimCSLTokenizeString2(), and ossimCSLTokenizeStringComplex().

OSSIM_CSLT_PRESERVEESCAPES

#define OSSIM_CSLT_PRESERVEESCAPES   0x0008

Definition at line 50 of file ossimCplUtil.cpp.

Referenced by ossimCSLTokenizeString2().

OSSIM_CSLT_PRESERVEQUOTES

#define OSSIM_CSLT_PRESERVEQUOTES   0x0004

Definition at line 47 of file ossimCplUtil.cpp.

Referenced by ossimCSLTokenizeString2().

Function Documentation

ossimCPLRealloc()

void* ossimCPLRealloc	(	void *	pData,
		size_t	nNewSize
	)

Definition at line 283 of file ossimCplUtil.cpp.

Referenced by ossimDDFModule::AddCloneRecord(), ossimDDFModule::AddField(), ossimCSLTokenizeString2(), and ossimDDFRecord::ResizeField().

{
    void        *pReturn;

    if ( nNewSize == 0 )
    {
        free(pData);
        return NULL;
    }

    if( pData == NULL )
        pReturn = malloc( nNewSize );
    else
        pReturn = realloc( pData, nNewSize );

    return pReturn;
}

ossimCSLCount()

int ossimCSLCount

(

char **

papszStrList

)

Definition at line 245 of file ossimCplUtil.cpp.

Referenced by ossimDDFFieldDefn::BuildSubfields().

{
    int nItems=0;

    if (papszStrList)
    {
        while(*papszStrList != NULL)
        {
            nItems++;
            papszStrList++;
        }
    }

    return nItems;
}

ossimCSLDestroy()

void ossimCSLDestroy

(

char **

papszStrList

)

Definition at line 266 of file ossimCplUtil.cpp.

Referenced by ossimDDFFieldDefn::ApplyFormats(), and ossimDDFFieldDefn::BuildSubfields().

{
    char **papszPtr;

    if (papszStrList)
    {
        papszPtr = papszStrList;
        while(*papszPtr != NULL)
        {
            free(*papszPtr);
            papszPtr++;
        }

        free(papszStrList);
    }
}

ossimCSLFindString()

int ossimCSLFindString	(	char **	papszList,
		const char *	pszTarget
	)

Definition at line 61 of file ossimCplUtil.cpp.

{
    int         i;

    if( papszList == NULL )
        return -1;

    for( i = 0; papszList[i] != NULL; i++ )
    {
       ossimString s = papszList[i];
       if( s == pszTarget)
            return i;
    }

    return -1;
}

ossimCSLTokenizeString()

char** ossimCSLTokenizeString

(

const char *

pszString

)

Definition at line 86 of file ossimCplUtil.cpp.

References OSSIM_CSLT_HONOURSTRINGS, and ossimCSLTokenizeString2().

{
    return ossimCSLTokenizeString2( pszString, " ", OSSIM_CSLT_HONOURSTRINGS );
}

ossimCSLTokenizeString2()

char** ossimCSLTokenizeString2	(	const char *	pszString,
		const char *	pszDelimiters,
		int	nCSLTFlags
	)

Definition at line 119 of file ossimCplUtil.cpp.

References OSSIM_CSLT_ALLOWEMPTYTOKENS, OSSIM_CSLT_HONOURSTRINGS, OSSIM_CSLT_PRESERVEESCAPES, OSSIM_CSLT_PRESERVEQUOTES, and ossimCPLRealloc().

Referenced by ossimCSLTokenizeString(), and ossimCSLTokenizeStringComplex().

{
    char        **papszRetList = NULL;
    int         nRetMax = 0, nRetLen = 0;
    char        *pszToken;
    int         nTokenMax, nTokenLen;
    int         bHonourStrings = (nCSLTFlags & OSSIM_CSLT_HONOURSTRINGS);
    int         bAllowEmptyTokens = (nCSLTFlags & OSSIM_CSLT_ALLOWEMPTYTOKENS);

    pszToken = (char *) calloc(10,1);
    nTokenMax = 10;
    
    while( pszString != NULL && *pszString != '\0' )
    {
        int     bInString = false;

        nTokenLen = 0;
        
        /* Try to find the next delimeter, marking end of token */
        for( ; *pszString != '\0'; pszString++ )
        {

            /* End if this is a delimeter skip it and break. */
            if( !bInString && strchr(pszDelimiters, *pszString) != NULL )
            {
                pszString++;
                break;
            }
            
            /* If this is a quote, and we are honouring constant
               strings, then process the constant strings, with out delim
               but don't copy over the quotes */
            if( bHonourStrings && *pszString == '"' )
            {
                if( nCSLTFlags & OSSIM_CSLT_PRESERVEQUOTES )
                {
                    pszToken[nTokenLen] = *pszString;
                    nTokenLen++;
                }

                if( bInString )
                {
                    bInString = false;
                    continue;
                }
                else
                {
                    bInString = true;
                    continue;
                }
            }

            /* Within string constants we allow for escaped quotes, but
               in processing them we will unescape the quotes */
            if( bInString && pszString[0] == '\\' && pszString[1] == '"' )
            {
                if( nCSLTFlags & OSSIM_CSLT_PRESERVEESCAPES )
                {
                    pszToken[nTokenLen] = *pszString;
                    nTokenLen++;
                }

                pszString++;
            }

            /* Within string constants a \\ sequence reduces to \ */
            else if( bInString 
                     && pszString[0] == '\\' && pszString[1] == '\\' )
            {
                if( nCSLTFlags & OSSIM_CSLT_PRESERVEESCAPES )
                {
                    pszToken[nTokenLen] = *pszString;
                    nTokenLen++;
                }
                pszString++;
            }

            if( nTokenLen >= nTokenMax-3 )
            {
                nTokenMax = nTokenMax * 2 + 10;
                pszToken = (char *) ossimCPLRealloc( pszToken, nTokenMax );
            }

            pszToken[nTokenLen] = *pszString;
            nTokenLen++;
        }

        pszToken[nTokenLen] = '\0';

        /*
         * If the last token is an empty token, then we have to catch
         * it now, otherwise we won't reenter the loop and it will be lost. 
         */

        if( (pszToken[0] != '\0' || bAllowEmptyTokens)
            || (*pszString == '\0' && bAllowEmptyTokens
                && strchr(pszDelimiters, *(pszString-1)) ) )
        {
            if( nRetLen >= nRetMax - 1 )
            {
                nRetMax = nRetMax * 2 + 10;
                papszRetList = (char **) 
                    ossimCPLRealloc(papszRetList, sizeof(char*) * nRetMax );
            }

            papszRetList[nRetLen++] = strdup( pszToken );
            papszRetList[nRetLen] = NULL;
        }
    }

    if( papszRetList == NULL )
        papszRetList = (char **) calloc(sizeof(char *),1);

    free( pszToken );

    return papszRetList;
}

ossimCSLTokenizeStringComplex()

char** ossimCSLTokenizeStringComplex	(	const char *	pszString,
		const char *	pszDelimiters,
		int	bHonourStrings,
		int	bAllowEmptyTokens
	)

Definition at line 97 of file ossimCplUtil.cpp.

References OSSIM_CSLT_ALLOWEMPTYTOKENS, OSSIM_CSLT_HONOURSTRINGS, and ossimCSLTokenizeString2().

Referenced by ossimDDFFieldDefn::ApplyFormats(), and ossimDDFFieldDefn::BuildSubfields().

{
    int         nFlags = 0;

    if( bHonourStrings )
        nFlags |= OSSIM_CSLT_HONOURSTRINGS;
    if( bAllowEmptyTokens )
        nFlags |= OSSIM_CSLT_ALLOWEMPTYTOKENS;

    return ossimCSLTokenizeString2( pszString, pszDelimiters, nFlags );
}