/usr/include/ace/Encoding_Converter.h is in libace-dev 6.3.3+dfsg-1.
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 | // -*- C++ -*-
//=========================================================================
/**
* @file Encoding_Converter.h
*
* This class is the base class for all encoding converters that convert
* to and from UTF-8.
*
* @author Chad Elliott <elliott_c@ociweb.com>
*/
//=========================================================================
#ifndef ACE_ENCODING_CONVERTER_H
#define ACE_ENCODING_CONVERTER_H
#include /**/ "ace/pre.h"
#include "ace/Basic_Types.h"
#if defined (ACE_USES_WCHAR)
#include /**/ "ace/ACE_export.h"
ACE_BEGIN_VERSIONED_NAMESPACE_DECL
/** The base class for all ACE UTF Encoding Converters.
* This class provides a generic interface that is used to implement
* various UTF encoding conversion classes.
*/
class ACE_Export ACE_Encoding_Converter
{
public:
/// This enum describes the various states that can be returned
/// from the to_utf8() and from_utf8() methods which depends on
/// both the source buffer and the size of the target buffer.
enum Result {CONVERSION_OK,
SOURCE_EXHAUSTED,
TARGET_EXHAUSTED,
SOURCE_ILLEGAL
};
/// This destructor is here (and virtual) because we have virtual
/// functions.
virtual ~ACE_Encoding_Converter (void);
/// Convert the source (which can be in any encoding) to UTF-8 and
/// store it in the provided target buffer.
virtual Result to_utf8 (const void* source,
size_t source_size,
ACE_Byte* target,
size_t target_size,
bool strict = true) = 0;
/// 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) = 0;
};
ACE_END_VERSIONED_NAMESPACE_DECL
#endif /* ACE_USES_WCHAR */
#include /**/ "ace/post.h"
#endif /* ACE_ENCODING_CONVERTER_H */
|