opencollada-dev 0.1.0~20140703.ddf8f47+dfsg1-2 / usr / include / opencollada / COLLADABaseUtils / COLLADABUStringUtils.h

/*
    Copyright (c) 2008-2009 NetAllied Systems GmbH

	This file is part of COLLADABaseUtils.

    Licensed under the MIT Open Source License,
    for details please see LICENSE file or the website
    http://www.opensource.org/licenses/mit-license.php
*/

#ifndef __COLLADABU_STRINGUTILS_H__
#define __COLLADABU_STRINGUTILS_H__

#include "COLLADABUPrerequisites.h"
#include "COLLADABUNativeString.h"

#include <sstream>
#include <fstream>
#include <map>

namespace COLLADABU
{

	/** A class that holds some static COLLADA utility functions*/
	class StringUtils
    {


    public:
       /**
         * Returns true, if both strings are equal. The comparison is case sensitive.
         */
		template<class StringType>
		static bool equals ( const StringType &str1, const StringType &str2 )
		{
			if ( str1.length() != str2.length() )
				return false;
			return ( strcmp ( str1.c_str(), str2.c_str() ) == 0 );
		}

        /**
        * Returns true, if both strings are equal. The comparison is case intensitive.
        */
        static bool equalsIgnoreCase ( const WideString& s1, const WideString& s2 );

		/** Checks for a valid xs:NCName.
		1. replaces all not allowed characters
		2. forces that the string begins with a letter or an _
		@param ncName The string to convert to a valid xs:NCName.
		@return The checked string
		*/
		static WideString checkNCName ( const WideString &ncName );
//		static UTF8String checkNCName ( const UTF8String &ncName ){return UTF8String();};

		/** Checks for a valid xs:ID.
		1. replaces all not allowed characters
		2. forces that the string begins with a letter or an _
		@param ncName The string to convert to a valid xs:ID.
		@return The checked string
		*/
        static WideString checkID ( const WideString &id );

//		static UTF8String checkID ( const UTF8String &id ){return UTF8String();};

		/** Checks if @a c is name start character according to http://www.w3.org/TR/xml11/#NT-NameStartChar */
		static bool isNameStartChar ( wchar_t c );

		/** Checks if @a c is name character according to http://www.w3.org/TR/xml11/#NT-NameChar */
		static bool isNameChar ( wchar_t c );

        /** Checks if @a c is an upper ASCII character*/
        static bool isUpperAsciiChar ( char c )
        {
            return ( c >= 'A' ) && ( c <= 'Z' ) ;
        }

        /** Checks if @a c is a lower ASCII character*/
        static bool isLowerAsciiChar ( char c )
        {
            return ( c >= 'a' ) && ( c <= 'z' ) ;
        }

        /** Checks if @a c is an ASCII character*/
        static bool isAsciiAlphaChar ( char c )
        {
            return isLowerAsciiChar ( c ) || isUpperAsciiChar ( c ) ;
        }

        /** Checks if @a c is a digit*/
        static bool isDigit ( char c )
        {
            return ( c >= '0' ) && ( c <= '9' ) ;
        }

        /** Checks if @a c is an xs:id character, but not alpha numeric*/
        static bool isIDExtraChar ( char c )
        {
            return ( c == '.' ) || ( c == '-' ) || ( c == '_' ) ;
        }

        /** Checks if @a c is an xs:id character, but not alpha numeric*/
        static bool isIDChar ( char c )
        {
            return isAsciiAlphaChar ( c ) || isDigit ( c ) || isIDExtraChar ( c ) ;
        }

		/** If @a c is a lower case ascii character, the corresponding upper character is returned.*/
		static char toUpperASCIIChar( char c );

        static String uriEncode ( const String & sSrc );

		/** Escapes all the characters not allowed in xml text elements.
		@param srcString The string to translate.
		@return The translated string.*/
		static String translateToXML ( const String &srcString );

		/** Escapes all the characters not allowed in xml text elements.
		@param srcString The string to translate.
		@return The translated string.*/
		static WideString translateToXML ( const WideString &srcString );


		/**  Returns @a text with all dots replaced by underlines*/
        static String replaceDot ( const String &text );

		/** Converts @a value to a NativeString.
		@param T The type of the value to convert.
		@param value The value of type @a T to convert to a NativeString.
		*/
        template<class T>
        static NativeString toNativeString ( const T & value )
        {
            std::stringstream stream;
            stream << value;
            return NativeString(stream.str());
        }


		/** Converts @a value to a UTF8String.
		@param T The type of the value to convert.
		@param value The value of type @a T to convert to a UTF8String.
		*/
		template<class T>
		static String toUTF8String( const T & value )
		{
			std::stringstream stream;
			stream << value;
			return String(stream.str());
		}


		/** Converts @a value to a String.
		@param T The type of the value to convert.
		@param value The value of type @a T to convert to a string.
		*/
		template<class T>
		static WideString toWideString ( const T & value )
		{
			std::wstringstream stream;
			stream << value;
			return WideString(stream.str());
		}


		/**
		* Searches all search strings in the source string and replace it with the replaceString.
		* @param source Reference to the source string.
		* @param searchString The search string.
		* @param replaceString The replace string.
		*/
		template<class StringType>
		static void stringFindAndReplace ( StringType &source, const StringType searchString, const StringType replaceString )
		{
			size_t found = source.find ( searchString );
			if ( found != StringType::npos )
			{
				size_t searchStrLength = searchString.length();
				size_t replaceStrLength = replaceString.length();
				do
				{
					source.replace ( found, searchStrLength, replaceString );
					found = source.find (searchString, found + replaceStrLength );
				} while ( found != StringType::npos );
			}

		}


		/** Converts the utf8 encoded string @a utf8String to a unicode encoded widestring.*/
		static WideString utf8String2WideString( const String& utf8String );

		/** Converts the unicode encoded string @a wideString to a UTF encoded string.*/
		static String wideString2utf8String( const WideString& wideString );

    };
}

#endif // __COLLADABU_STRINGUTILS_H__