ustring.h

Go to the documentation of this file.

//-----------------------------------------------------------------------------
// Project     : SDK Core
//
// Category    : Helpers
// Filename    : pluginterfaces/base/ustring.h
// Created by  : Steinberg, 12/2005
// Description : UTF-16 String class
//
//-----------------------------------------------------------------------------
// This file is part of a Steinberg SDK. It is subject to the license terms
// in the LICENSE file found in the top-level directory of this distribution
// and at www.steinberg.net/sdklicenses. 
// No part of the SDK, including this file, may be copied, modified, propagated,
// or distributed except according to the terms contained in the LICENSE file.
//-----------------------------------------------------------------------------
 
#pragma once
 
#include "ftypes.h"
 
//------------------------------------------------------------------------
namespace Steinberg {
 
//------------------------------------------------------------------------
class UString
{
public:
//------------------------------------------------------------------------
        UString (char16* buffer, int32 size) : thisBuffer (buffer), thisSize (size) {}

        int32 getSize () const { return thisSize; }
        
        operator const char16* () const { return thisBuffer; }

        int32 getLength () const;

        UString& assign (const char16* src, int32 srcSize = -1);

        UString& append (const char16* src, int32 srcSize = -1);

        const UString& copyTo (char16* dst, int32 dstSize) const;

        UString& fromAscii (const char* src, int32 srcSize = -1);
        UString& assign (const char* src, int32 srcSize = -1) { return fromAscii (src, srcSize); }

        const UString& toAscii (char* dst, int32 dstSize) const;

        bool scanInt (int64& value) const;

        bool printInt (int64 value);

        bool scanFloat (double& value) const;

        bool printFloat (double value, int32 precision = 4);
//------------------------------------------------------------------------
protected:
        char16* thisBuffer;
        int32 thisSize; 
};
 
//------------------------------------------------------------------------
template <int32 maxSize>
class UStringBuffer : public UString
{
public:
//------------------------------------------------------------------------
        UStringBuffer () : UString (data, maxSize) { data[0] = 0; }

        UStringBuffer (const char16* src, int32 srcSize = -1) : UString (data, maxSize)
        {
                data[0] = 0;
                if (src)
                        assign (src, srcSize);
        }

        UStringBuffer (const char* src, int32 srcSize = -1) : UString (data, maxSize)
        {
                data[0] = 0;
                if (src)
                        fromAscii (src, srcSize);
        }
//------------------------------------------------------------------------
protected:
        char16 data[maxSize];
};
 
//------------------------------------------------------------------------
typedef UStringBuffer<128> UString128; 
typedef UStringBuffer<256> UString256; 
} // namespace Steinberg
 
//------------------------------------------------------------------------
#define USTRING(asciiString) Steinberg::UString256 (asciiString)
#define USTRINGSIZE(var) (sizeof (var) / sizeof (Steinberg::char16))
 
//------------------------------------------------------------------------