/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2003 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 <osg/Referenced>
#include <osgText/Export>

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

namespace osgText {

class Text;

class OSGTEXT_EXPORT String : public osg::Referenced, public std::vector<unsigned int>
{
public:

    /**
     * Types of string encodings supported
     */
    enum Encoding
    {
        ENCODING_UNDEFINED,                 /// not using Unicode
        ENCODING_ASCII = ENCODING_UNDEFINED,/// unsigned char ASCII
        ENCODING_UTF8,                      /// 8-bit unicode transformation format
        ENCODING_UTF16,                     /// 16-bit signature
        ENCODING_UTF16_BE,                  /// 16-bit big-endian
        ENCODING_UTF16_LE,                  /// 16-bit little-endian
        ENCODING_UTF32,                     /// 32-bit signature
        ENCODING_UTF32_BE,                  /// 32-bit big-endian
        ENCODING_UTF32_LE,                  /// 32-bit little-endian
        ENCODING_SIGNATURE                  /// detect encoding from 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); }

    virtual ~String() {} // public temporily while osgText is still in flux.

    String& operator = (const String& str);

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

    /** Set the text using a wchar_t string, 
      * which is converted to an internal TextString.*/
    void set(const wchar_t* text);

    /** Set the text using a Unicode encoded std::string, which is converted to an internal TextString.
      * The encoding parameter specificies which Unicode encodeding is used in the std::string. */
    void set(const std::string& text,Encoding encoding);

    /** returns a UTF8 encoded version of this osgText::String.*/
    std::string createUTF8EncodedString() const;

protected:

};

}


#endif
