StringConverter.h

Go to the documentation of this file.

//
// Copyright (c) ZeroC, Inc. All rights reserved.
//
 
#ifndef ICE_UTIL_STRING_CONVERTER_H
#define ICE_UTIL_STRING_CONVERTER_H
 
#include <IceUtil/Config.h>
#include <IceUtil/Exception.h>
#include <IceUtil/Shared.h>
#include <IceUtil/Handle.h>
 
#include <string>
 
namespace IceUtil
{

class ICE_API UTF8Buffer
{
public:

    virtual Byte* getMoreBytes(size_t howMany, Byte* firstUnused) = 0;
 
    virtual ~UTF8Buffer();
};

template<typename charT>
class BasicStringConverter
#ifndef ICE_CPP11_MAPPING
    : public IceUtil::Shared
#endif
{
public:

    virtual Byte* toUTF8(const charT* sourceStart, const charT* sourceEnd, UTF8Buffer& buf) const = 0;

    virtual void fromUTF8(const Byte* sourceStart, const Byte* sourceEnd, std::basic_string<charT>& target) const = 0;
 
    virtual ~BasicStringConverter()
    {
    }
};
 
#if defined(__clang__) && !defined(ICE_STATIC_LIBS)
//
// Explicit template instantiation so that dynamic_cast of derived exported
// classes works well with clang, see ICE-7473.
//
template class ICE_API BasicStringConverter<char>;
template class ICE_API BasicStringConverter<wchar_t>;
#endif

typedef BasicStringConverter<char> StringConverter;
ICE_DEFINE_PTR(StringConverterPtr, StringConverter);

typedef BasicStringConverter<wchar_t> WstringConverter;
ICE_DEFINE_PTR(WstringConverterPtr, WstringConverter);

ICE_API WstringConverterPtr createUnicodeWstringConverter();

ICE_API StringConverterPtr getProcessStringConverter();

ICE_API void setProcessStringConverter(const StringConverterPtr& c);

ICE_API WstringConverterPtr getProcessWstringConverter();

ICE_API void setProcessWstringConverter(const WstringConverterPtr& c);

ICE_API std::string
wstringToString(const std::wstring& str,
                const StringConverterPtr& nc = 0,
                const WstringConverterPtr& wc = 0);

ICE_API std::wstring
stringToWstring(const std::string& str,
                const StringConverterPtr& nc = 0,
                const WstringConverterPtr& wc = 0);

ICE_API std::string
nativeToUTF8(const std::string& str, const StringConverterPtr& nc);

ICE_API std::string
UTF8ToNative(const std::string& str, const StringConverterPtr& nc);
 
}
 
namespace IceUtilInternal
{
 
//
// Convert from UTF-8 to UTF-16/32
//
ICE_API std::vector<unsigned short> toUTF16(const std::vector<IceUtil::Byte>&);
ICE_API std::vector<unsigned int> toUTF32(const std::vector<IceUtil::Byte>&);
 
//
// Convert from UTF-32 to UTF-8
//
ICE_API std::vector<IceUtil::Byte> fromUTF32(const std::vector<unsigned int>&);
 
}
 
#ifdef _WIN32
namespace IceUtil
{

ICE_API StringConverterPtr createWindowsStringConverter(unsigned int page);
 
}
#endif
 
#endif