/usr/include/IceUtil/StringConverter.h is in libzeroc-ice-dev 3.7.0-5.
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 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 | // **********************************************************************
//
// Copyright (c) 2003-2017 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_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
{
//
// Provides bytes to toUTF8. Can raise std::bad_alloc or Ice::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 IllegalConversionException or an exception raised
// by UTF8Buffer
//
template<typename charT>
class BasicStringConverter
#ifndef ICE_CPP11_MAPPING
: public IceUtil::Shared
#endif
{
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;
virtual ~BasicStringConverter()
{
}
};
#ifdef __clang__
//
// 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);
//
// Create a WstringConverter that converts to and from UTF-16 or UTF-32
// depending on sizeof(wchar_t).
//
//
ICE_API WstringConverterPtr createUnicodeWstringConverter();
//
// Retrieve the per process narrow string converter.
//
ICE_API StringConverterPtr getProcessStringConverter();
//
// Set the per process narrow string converter.
//
ICE_API void setProcessStringConverter(const StringConverterPtr&);
//
// Retrieve the per process wide string converter.
//
ICE_API WstringConverterPtr getProcessWstringConverter();
//
// Set the per process wide string converter.
//
ICE_API void setProcessWstringConverter(const WstringConverterPtr&);
//
// Converts the given wide string to a narrow string
//
// If the StringConverter parameter is null, the result's narrow
// string encoding is UTF-8.
// If the WstringConverter parameter is null, the input's wstring
// encoding is UTF-16 or UTF-32 depending on the size of wchar_t.
//
ICE_API std::string
wstringToString(const std::wstring&,
const StringConverterPtr& = 0,
const WstringConverterPtr& = 0);
//
// Converts the given narrow string to a wide string
//
// If the StringConverter parameter is null, the input's narrow string
// encoding is UTF-8.
// If the WstringConverter parameter is null, the result's wstring
// encoding is UTF-16 or UTF-32 depending on the size of wchar_t.
//
ICE_API std::wstring
stringToWstring(const std::string&,
const StringConverterPtr& = 0,
const WstringConverterPtr& = 0);
//
// Converts the given string from the native narrow string encoding to
// UTF-8 using the given converter. If the converter is null, returns
// the given string.
//
ICE_API std::string
nativeToUTF8(const std::string&, const StringConverterPtr&);
//
// Converts the given string from UTF-8 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 std::string&, const StringConverterPtr&);
}
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
{
//
// Create a StringConverter that converts to and from narrow chars
// in the given code page, using MultiByteToWideChar and WideCharToMultiByte
//
ICE_API StringConverterPtr createWindowsStringConverter(unsigned int);
}
#endif
#endif
|