Apache Log4cxx  Version 1.1.0
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 
24 namespace log4cxx
25 {
26 namespace helpers
27 {
28 class ByteBuffer;
29 class Pool;
36 class 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 wchar_t * wencode(const LogString &src, log4cxx::helpers::Pool &p)
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 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 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 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 char * encodeUTF8(const LogString &src, log4cxx::helpers::Pool &p)
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 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: appender.h:27
std::basic_string< logchar > LogString
Definition: logstring.h:60