/usr/include/Ice/StringConverter.h is in libzeroc-ice35-dev 3.5.1-6.4ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 | // **********************************************************************
//
// Copyright (c) 2003-2013 ZeroC, Inc. All rights reserved.
//
// This copy of Ice is licensed to you under the terms described in the
// ICE_LICENSE file included in this distribution.
//
// **********************************************************************
#ifndef ICE_STRING_CONVERTER_H
#define ICE_STRING_CONVERTER_H
#include <Ice/Config.h>
#include <Ice/CommunicatorF.h>
#include <Ice/Plugin.h>
#include <IceUtil/Exception.h>
#include <IceUtil/Shared.h>
#include <IceUtil/Handle.h>
#include <IceUtil/Unicode.h>
#include <string>
namespace Ice
{
//
// Provides bytes to toUTF8. Raises MemoryLimitException when too many
// bytes are requested.
//
class ICE_API UTF8Buffer
{
public:
virtual Byte* getMoreBytes(size_t howMany, Byte* firstUnused) = 0;
virtual ~UTF8Buffer() {}
};
//
// A StringConverter converts narrow or wide-strings to and from UTF-8 byte sequences.
// It's used by the communicator during marshaling (toUTF8) and unmarshaling (fromUTF8).
// It report errors by raising StringConversionFailed or MemoryLimitException.
//
template<typename charT>
class BasicStringConverter : public IceUtil::Shared
{
public:
//
// Returns a pointer to byte after the last written byte (which may be
// past the last byte returned by getMoreBytes).
//
virtual Byte* toUTF8(const charT* sourceStart, const charT* sourceEnd,
UTF8Buffer&) const = 0;
//
// Unmarshals a UTF-8 sequence into a basic_string
//
virtual void fromUTF8(const Byte* sourceStart, const Byte* sourceEnd,
std::basic_string<charT>& target) const = 0;
};
typedef BasicStringConverter<char> StringConverter;
typedef IceUtil::Handle<StringConverter> StringConverterPtr;
typedef BasicStringConverter<wchar_t> WstringConverter;
typedef IceUtil::Handle<WstringConverter> WstringConverterPtr;
//
// Converts to and from UTF-16 or UTF-32 depending on sizeof(wchar_t)
//
class ICE_API UnicodeWstringConverter : public WstringConverter
{
public:
UnicodeWstringConverter(IceUtil::ConversionFlags = IceUtil::lenientConversion);
virtual Byte* toUTF8(const wchar_t*, const wchar_t*, UTF8Buffer&) const;
virtual void fromUTF8(const Byte*, const Byte*, std::wstring&) const;
private:
const IceUtil::ConversionFlags _conversionFlags;
};
#ifdef _WIN32
//
// Converts to/from UTF-8 using MultiByteToWideChar and WideCharToMultiByte
//
class ICE_API WindowsStringConverter : public StringConverter
{
public:
explicit WindowsStringConverter(unsigned int);
virtual Byte* toUTF8(const char*, const char*, UTF8Buffer&) const;
virtual void fromUTF8(const Byte*, const Byte*, std::string& target) const;
private:
unsigned int _cp;
UnicodeWstringConverter _unicodeWstringConverter;
};
#endif
//
// A special plug-in that sets stringConverter and wstringConverter during
// construction (when the provided stringConverter resp. wstringConverter
// are not null). Both initialize and destroy are no-op. See Ice::InitializationData.
//
class ICE_API StringConverterPlugin : public Ice::Plugin
{
public:
StringConverterPlugin(const CommunicatorPtr& communicator,
const StringConverterPtr&, const WstringConverterPtr& = 0);
virtual void initialize();
virtual void destroy();
};
//
// Converts the given string from the native narrow string encoding to
// UTF8 using the given converter. If the converter is null, returns
// the given string.
//
ICE_API std::string
nativeToUTF8(const Ice::StringConverterPtr&, const std::string&);
//
// Converts the given string from the native narrow string encoding to
// UTF8 using the communicator's converter. If the converter is null,
// returns the given string.
//
ICE_API std::string
nativeToUTF8(const Ice::CommunicatorPtr&, const std::string&);
//
// Converts the given string from UTF8 to the native narrow string
// encoding using the given converter. If the converter is null,
// returns the given string.
//
ICE_API std::string
UTF8ToNative(const Ice::StringConverterPtr&, const std::string&);
//
// Converts the given string from UTF8 to the native narrow string
// encoding using the communicator's converter. If the converter is
// null, returns the given string.
//
ICE_API std::string
UTF8ToNative(const Ice::CommunicatorPtr&, const std::string&);
}
#endif
|