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))
 
//------------------------------------------------------------------------