blob: fbb96c3d5591f201c91a6e76b25f3a558ab01bce (
plain)
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
|
// -*- C++ -*-
//=========================================================================
/**
* @file UTF8_Encoding_Converter.h
*
* This class contains declarations for methods that convert between
* UTF-8 and the native ACE_TCHAR representation.
*
* @author Chad Elliott <elliott_c@ociweb.com>
*/
//=========================================================================
#ifndef ACE_UTF8_ENCODING_CONVERTER_H
#define ACE_UTF8_ENCODING_CONVERTER_H
#include /**/ "ace/pre.h"
#include "ace/Encoding_Converter.h"
#if defined (ACE_USES_WCHAR)
ACE_BEGIN_VERSIONED_NAMESPACE_DECL
/** Convert from UTF-16 or UTF-32 to UTF-8.
* This class implements the ACE_Encoding_Converter interface.
*/
class ACE_UTF8_Encoding_Converter: public ACE_Encoding_Converter
{
public:
/// Allocate the converter to be used by the from_utf8() method based
/// on the size of the native wide character.
ACE_UTF8_Encoding_Converter ();
/// De-allocate the native converter.
virtual ~ACE_UTF8_Encoding_Converter ();
/// Since the source *must be* UTF-8, there is no conversion required.
/// This method just copies the source to the target given that there
/// is enough space.
virtual Result to_utf8 (const void* source,
size_t source_size,
ACE_Byte* target,
size_t target_size,
bool strict = true);
/// Utilize the native converter to convert the UTF-8 source into an
/// alternate encoding and store it in the provided target buffer.
virtual Result from_utf8 (const ACE_Byte* source,
size_t source_size,
void* target,
size_t target_size,
bool strict = true);
/// This factory helper method determines if the source stream is UTF-8
/// encoded. If it is, allocate an ACE_UTF8_Encoding_Converter and
/// return it. The caller then owns the allocated object.
static ACE_UTF8_Encoding_Converter* encoded (const ACE_Byte* source,
size_t source_size);
private:
ACE_Encoding_Converter* native_;
};
ACE_END_VERSIONED_NAMESPACE_DECL
#endif /* ACE_USES_WCHAR */
#include /**/ "ace/post.h"
#endif /* ACE_UTF8_ENCODING_CONVERTER_H */
|