String.h

Go to the documentation of this file.

/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2006 Robert Osfield
 *
 * This library is open source and may be redistributed and/or modified under
 * the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or
 * (at your option) any later version.  The full license is in LICENSE file
 * included with this distribution, and on the openscenegraph.org website.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * OpenSceneGraph Public License for more details.
*/

#ifndef OSGTEXT_STRING
#define OSGTEXT_STRING 1

#include <vector>
#include <set>
#include <string>

#include <osgText/Export>

namespace osgText {

// ********************************  HACK  **********************************
// Following class is needed to work around a DLL export problem. See file
// include/osg/PrimitiveSet for details.

class VectorUInt: public std::vector<unsigned int>
{
    typedef std::vector<value_type> vector_type;
public:
    VectorUInt(): vector_type() {}
    VectorUInt(const VectorUInt &copy): vector_type(copy) {}
    VectorUInt(unsigned int* beg, unsigned int* end): vector_type(beg, end) {}
    explicit VectorUInt(unsigned int n): vector_type(n) {}
};

// **************************************************************************

class Text;

class OSGTEXT_EXPORT String : public VectorUInt
{
    public:

        typedef VectorUInt vector_type;

        enum Encoding
        {
            ENCODING_UNDEFINED,                 
            ENCODING_ASCII = ENCODING_UNDEFINED,
            ENCODING_UTF8,                      
            ENCODING_UTF16,                     
            ENCODING_UTF16_BE,                  
            ENCODING_UTF16_LE,                  
            ENCODING_UTF32,                     
            ENCODING_UTF32_BE,                  
            ENCODING_UTF32_LE,                  
            ENCODING_SIGNATURE                  
        };


        String() {}
        String(const String& str);
        String(const std::string& str) { set(str); }
        String(const wchar_t* text) { set(text); }
        String(const std::string& text,Encoding encoding) { set(text,encoding); }

        String& operator = (const String& str);

        void set(const std::string& str);

        void set(const wchar_t* text);

        void set(const std::string& text,Encoding encoding);

        std::string createUTF8EncodedString() const;

    protected:

};

}


#endif