ustring.h

Go to the documentation of this file.

//-----------------------------------------------------------------------------
// Project     : SDK Core
// Version     : 1.0
//
// Category    : Helpers
// Filename    : ustring.h
// Created by  : Steinberg, 12/2005
// Modified    : $Date: 2008/01/09 12:51:43 $
// Description : UTF-16 String class
//
//-----------------------------------------------------------------------------
// LICENSE
// © 2008, Steinberg Media Technologies GmbH, All Rights Reserved
//-----------------------------------------------------------------------------
// This Software Development Kit may not be distributed in parts or its entirety  
// without prior written agreement by Steinberg Media Technologies GmbH. 
// This SDK must not be used to re-engineer or manipulate any technology used  
// in any Steinberg or Third-party application or software module, 
// unless permitted by law.
// Neither the name of the Steinberg Media Technologies nor the names of its
// contributors may be used to endorse or promote products derived from this 
// software without specific prior written permission.
// 
// THIS SDK IS PROVIDED BY STEINBERG MEDIA TECHNOLOGIES GMBH "AS IS" AND
// ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
// WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
// IN NO EVENT SHALL STEINBERG MEDIA TECHNOLOGIES GMBH BE LIABLE FOR ANY DIRECT, 
// INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 
// BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
// LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 
// OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
// OF THE POSSIBILITY OF SUCH DAMAGE.
//-----------------------------------------------------------------------------

#ifndef __ustring__
#define __ustring__

#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);

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

//------------------------------------------------------------------------
#define USTRING(asciiString)    Steinberg::UString256 (asciiString)
#define USTRINGSIZE(var)                (sizeof (var) / sizeof (char16))

//------------------------------------------------------------------------
} // namespace Steinberg

#endif

---

Copyright ©2008 Steinberg Media Technologies. All Rights Reserved.