Apache Log4cxx Version 1.0.0
Loading...
Searching...
No Matches
transcoder.h
Go to the documentation of this file.
1/*
2 * Licensed to the Apache Software Foundation (ASF) under one or more
3 * contributor license agreements. See the NOTICE file distributed with
4 * this work for additional information regarding copyright ownership.
5 * The ASF licenses this file to You under the Apache License, Version 2.0
6 * (the "License"); you may not use this file except in compliance with
7 * the License. You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17
18#ifndef _LOG4CXX_HELPERS_TRANSCODER_H
19#define _LOG4CXX_HELPERS_TRANSCODER_H
20
21#include <log4cxx/logstring.h>
22
23
24namespace log4cxx
25{
26namespace helpers
27{
28class ByteBuffer;
29class Pool;
36class LOG4CXX_EXPORT Transcoder
37{
38 public:
39
40
44 static void decodeUTF8(const std::string& src, LogString& dst);
48 static void encodeUTF8(const LogString& src, std::string& dst);
52 static char* encodeUTF8(const LogString& src, log4cxx::helpers::Pool& p);
56 static void encodeUTF8(unsigned int sv, ByteBuffer& dst);
60 static void encodeUTF16LE(unsigned int sv, ByteBuffer& dst);
64 static void encodeUTF16BE(unsigned int sv, ByteBuffer& dst);
65
66
74 static unsigned int decode(const std::string& in,
75 std::string::const_iterator& iter);
76
82 static void encode(unsigned int ch, std::string& dst);
83
88 static void decode(const std::string& src, LogString& dst);
94 static void encode(const LogString& src, std::string& dst);
95
103 static char* encode(const LogString& src, log4cxx::helpers::Pool& p);
104
105
106
107#if LOG4CXX_WCHAR_T_API || LOG4CXX_LOGCHAR_IS_WCHAR_T || defined(WIN32) || defined(_WIN32)
108 static void decode(const std::wstring& src, LogString& dst);
109 static void encode(const LogString& src, std::wstring& dst);
110 static wchar_t* wencode(const LogString& src, log4cxx::helpers::Pool& p);
111
119 static unsigned int decode(const std::wstring& in,
120 std::wstring::const_iterator& iter);
121
127 static void encode(unsigned int ch, std::wstring& dst);
128
129#endif
130
131
132#if LOG4CXX_UNICHAR_API || LOG4CXX_CFSTRING_API || LOG4CXX_LOGCHAR_IS_UNICHAR
133 static void decode(const std::basic_string<UniChar>& src, LogString& dst);
134 static void encode(const LogString& src, std::basic_string<UniChar>& dst);
135
143 static unsigned int decode(const std::basic_string<UniChar>& in,
144 std::basic_string<UniChar>::const_iterator& iter);
145
151 static void encode(unsigned int ch, std::basic_string<UniChar>& dst);
152
153#endif
154
155#if LOG4CXX_CFSTRING_API
156 static void decode(const CFStringRef& src, LogString& dst);
157 static CFStringRef encode(const LogString& src);
158#endif
159
160 enum { LOSSCHAR = 0x3F };
161
166 static logchar decode(char v);
171 static LogString decode(const char* v);
172
177 static std::string encodeCharsetName(const LogString& charsetName);
178
179 private:
180
181 private:
182 Transcoder();
183 Transcoder(const Transcoder&);
184 Transcoder& operator=(const Transcoder&);
185 enum { BUFSIZE = 256 };
186 static size_t encodeUTF8(unsigned int ch, char* dst);
187 static size_t encodeUTF16BE(unsigned int ch, char* dst);
188 static size_t encodeUTF16LE(unsigned int ch, char* dst);
189
190};
191}
192}
193
194#define LOG4CXX_ENCODE_CHAR(var, src) \
195 std::string var; \
196 log4cxx::helpers::Transcoder::encode(src, var)
197
198#define LOG4CXX_DECODE_CHAR(var, src) \
199 log4cxx::LogString var; \
200 log4cxx::helpers::Transcoder::decode(src, var)
201
202#define LOG4CXX_DECODE_CFSTRING(var, src) \
203 log4cxx::LogString var; \
204 log4cxx::helpers::Transcoder::decode(src, var)
205
206#define LOG4CXX_ENCODE_CFSTRING(var, src) \
207 CFStringRef var = log4cxx::helpers::Transcoder::encode(src)
208
209
210#if LOG4CXX_LOGCHAR_IS_WCHAR
211
212#define LOG4CXX_ENCODE_WCHAR(var, src) \
213 const std::wstring& var = src
214
215#define LOG4CXX_DECODE_WCHAR(var, src) \
216 const log4cxx::LogString& var = src
217
218#else
219
220#define LOG4CXX_ENCODE_WCHAR(var, src) \
221 std::wstring var; \
222 log4cxx::helpers::Transcoder::encode(src, var)
223
224#define LOG4CXX_DECODE_WCHAR(var, src) \
225 log4cxx::LogString var; \
226 log4cxx::helpers::Transcoder::decode(src, var)
227
228#endif
229
230#if LOG4CXX_LOGCHAR_IS_UNICHAR
231
232#define LOG4CXX_ENCODE_UNICHAR(var, src) \
233 const std::basic_string<UniChar>& var = src
234
235#define LOG4CXX_DECODE_UNICHAR(var, src) \
236 const log4cxx::LogString& var = src
237
238#else
239
240#define LOG4CXX_ENCODE_UNICHAR(var, src) \
241 std::basic_string<UniChar> var; \
242 log4cxx::helpers::Transcoder::encode(src, var)
243
244#define LOG4CXX_DECODE_UNICHAR(var, src) \
245 log4cxx::LogString var; \
246 log4cxx::helpers::Transcoder::decode(src, var)
247
248#endif
249
250#endif //_LOG4CXX_HELPERS_TRANSCODER_H
A byte buffer.
Definition: bytebuffer.h:34
Definition: pool.h:33
Simple transcoder for converting between external char and wchar_t strings and internal strings.
Definition: transcoder.h:37
static void decode(const std::basic_string< UniChar > &src, LogString &dst)
static unsigned int decode(const std::string &in, std::string::const_iterator &iter)
Decodes next character from a UTF-8 string.
static void encode(const LogString &src, std::basic_string< UniChar > &dst)
static void encodeUTF16LE(unsigned int sv, ByteBuffer &dst)
Append UCS-4 code point to a byte buffer as UTF-16LE.
static void encodeUTF16BE(unsigned int sv, ByteBuffer &dst)
Append UCS-4 code point to a byte buffer as UTF-16BE.
static void decode(const std::wstring &src, LogString &dst)
static wchar_t * wencode(const LogString &src, log4cxx::helpers::Pool &p)
static void encode(const LogString &src, std::wstring &dst)
static void encode(const LogString &src, std::string &dst)
Appends a LogString to a string in the current code-page.
static void encodeUTF8(const LogString &src, std::string &dst)
Converts the LogString to a UTF-8 string.
static char * encode(const LogString &src, log4cxx::helpers::Pool &p)
Encodes the specified LogString to the current character set.
static unsigned int decode(const std::wstring &in, std::wstring::const_iterator &iter)
Decodes next character from a wstring.
static std::string encodeCharsetName(const LogString &charsetName)
Encodes a charset name in the default encoding without using a CharsetEncoder (which could trigger re...
static char * encodeUTF8(const LogString &src, log4cxx::helpers::Pool &p)
Converts the LogString to a UTF-8 string.
static CFStringRef encode(const LogString &src)
static void decodeUTF8(const std::string &src, LogString &dst)
Appends this specified string of UTF-8 characters to LogString.
static unsigned int decode(const std::basic_string< UniChar > &in, std::basic_string< UniChar >::const_iterator &iter)
Decodes next character from a UniChar string.
static void encode(unsigned int ch, std::basic_string< UniChar > &dst)
Appends UCS-4 value to a UTF-8 string.
static logchar decode(char v)
Returns a logchar value given a character literal in the ASCII charset.
static void encode(unsigned int ch, std::wstring &dst)
Appends UCS-4 value to a UTF-8 string.
static LogString decode(const char *v)
Returns a LogString given a string literal in the ASCII charset.
static void encode(unsigned int ch, std::string &dst)
Appends UCS-4 value to a UTF-8 string.
static void decode(const CFStringRef &src, LogString &dst)
static void decode(const std::string &src, LogString &dst)
Appends string in the current code-page to a LogString.
static void encodeUTF8(unsigned int sv, ByteBuffer &dst)
Append UCS-4 code point to a byte buffer as UTF-8.
const struct __CFString * CFStringRef
Definition: logstring.h:30
Definition: configuration.h:25
std::basic_string< logchar > LogString
Definition: logstring.h:60