UTF-32 encoding. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...

Inherits System::Text::ICUEncoding.

Public Member Functions

ASPOSECPP_SHARED_API UTF32Encoding ()
 Constructor. More...
 
ASPOSECPP_SHARED_API UTF32Encoding (bool big_endian, bool byte_order_mark)
 Constructor. More...
 
ASPOSECPP_SHARED_API UTF32Encoding (bool big_endian, bool byte_order_mark, bool throw_on_invalid_characters)
 Constructor. More...
 
ASPOSECPP_SHARED_API bool operator== (const UTF32Encoding &other) const
 Compares encodings' parameters. More...
 
ASPOSECPP_SHARED_API int GetHashCode () const override
 Gets encoding hash code. More...
 
ASPOSECPP_SHARED_API bool Equals (SharedPtr< Object > obj) override
 Compares with object. More...
 
ASPOSECPP_SHARED_API ArrayPtr< uint8_t > GetPreamble () override
 Get codepage preamble. More...
 
ASPOSECPP_SHARED_API SharedPtr< ObjectClone () override
 Clones encoding object. More...
 
- Public Member Functions inherited from System::Text::ICUEncoding
 ICUEncoding (const Details::EncodingInfoInternal *encoding_info)
 Constructor. More...
 
ASPOSECPP_SHARED_API bool operator== (const ICUEncoding &other) const
 Compares encodings using codepages. More...
 
ASPOSECPP_SHARED_API int GetByteCount (const char_t *chars, int count) override
 Get the number of characters needed to encode a character buffer. More...
 
ASPOSECPP_SHARED_API int GetBytes (const char_t *chars, int char_count, uint8_t *bytes, int byte_count) override
 Get the bytes that result from encoding a character buffer. More...
 
ASPOSECPP_SHARED_API int GetCharCount (const uint8_t *bytes, int count) override
 Get the number of characters needed to decode a byte buffer. More...
 
ASPOSECPP_SHARED_API int GetChars (const uint8_t *bytes, int byte_count, char_t *chars, int char_count) override
 Get the characters that result from decoding a byte buffer. More...
 
ASPOSECPP_SHARED_API DecoderPtr GetDecoder () override
 Get a decoder that forwards requests to this object. More...
 
ASPOSECPP_SHARED_API EncoderPtr GetEncoder () override
 Get an encoder that forwards requests to this object. More...
 
ASPOSECPP_SHARED_API int GetMaxByteCount (int char_count) override
 Get the maximum number of bytes needed to encode a specified number of characters. More...
 
ASPOSECPP_SHARED_API int GetMaxCharCount (int byte_count) override
 Get the maximum number of characters needed to decode a specified number of bytes. More...
 
- Public Member Functions inherited from System::Text::Encoding
ASPOSECPP_SHARED_API bool Equals (SharedPtr< Object > obj) override
 Compares encodings. More...
 
virtual ASPOSECPP_SHARED_API int get_CodePage ()
 Gets Windows codepage ID. More...
 
virtual ASPOSECPP_SHARED_API int get_WindowsCodePage ()
 Gets Windows codepage ID. More...
 
virtual ASPOSECPP_SHARED_API String get_WebName ()
 Gets IANA-compatible encoding name. More...
 
virtual ASPOSECPP_SHARED_API String get_BodyName ()
 Gets mail agent body compatible encoding name. More...
 
virtual ASPOSECPP_SHARED_API String get_EncodingName ()
 Gets human-readable encoding name. More...
 
virtual ASPOSECPP_SHARED_API String get_HeaderName ()
 Gets mail agent header compatible encoding name. More...
 
virtual ASPOSECPP_SHARED_API bool get_IsSingleByte ()
 Checks whether encoding is single byte. More...
 
virtual ASPOSECPP_SHARED_API bool get_IsBrowserDisplay ()
 Checks whether encoding can be used in browser to display content. More...
 
virtual ASPOSECPP_SHARED_API bool get_IsBrowserSave ()
 Checks whether encoding can be used in browser to save content. More...
 
virtual ASPOSECPP_SHARED_API bool get_IsMailNewsDisplay ()
 Checks whether encoding can be used in mail client to display content. More...
 
virtual ASPOSECPP_SHARED_API bool get_IsMailNewsSave ()
 Checks whether encoding can be used in mail client to save content. More...
 
ASPOSECPP_SHARED_API bool get_IsReadOnly ()
 Checks whether encoding is read-only. More...
 
ASPOSECPP_SHARED_API DecoderFallbackPtr get_DecoderFallback () const
 Gets decoder fallback. More...
 
ASPOSECPP_SHARED_API void set_DecoderFallback (const DecoderFallbackPtr &value)
 Sets decoder fallback. More...
 
ASPOSECPP_SHARED_API const EncoderFallbackPtr get_EncoderFallback () const
 Gets encoder fallback. More...
 
ASPOSECPP_SHARED_API void set_EncoderFallback (const EncoderFallbackPtr &value)
 Sets encoder fallback. More...
 
virtual ASPOSECPP_SHARED_API int GetByteCount (ArrayPtr< char_t > chars, int index, int count)
 Get the number of characters needed to encode a character buffer. More...
 
virtual ASPOSECPP_SHARED_API int GetByteCount (System::Details::ArrayView< char_t > chars, int index, int count)
 Get the number of characters needed to encode a character buffer. More...
 
template<std::size_t N>
int GetByteCount (const System::Details::StackArray< char_t, N > &chars, int index, int count)
 Get the number of characters needed to encode a character buffer. More...
 
virtual ASPOSECPP_SHARED_API int GetByteCount (const String &s)
 Get the number of characters needed to encode a string. More...
 
virtual ASPOSECPP_SHARED_API int GetByteCount (ArrayPtr< char_t > chars)
 Get the number of characters needed to encode a character buffer. More...
 
virtual ASPOSECPP_SHARED_API int GetBytes (ArrayPtr< char_t > chars, int char_index, int char_count, ArrayPtr< uint8_t > bytes, int byte_index)
 Get the bytes that result from encoding a character buffer. More...
 
virtual ASPOSECPP_SHARED_API int GetBytes (System::Details::ArrayView< char_t > chars, int char_index, int char_count, System::Details::ArrayView< uint8_t > bytes, int byte_index)
 Get the bytes that result from encoding a character buffer. More...
 
template<std::size_t SC, std::size_t SB>
int GetBytes (System::Details::StackArray< char_t, SC > &chars, int char_index, int char_count, System::Details::StackArray< uint8_t, SB > &bytes, int byte_index)
 Get the bytes that result from encoding a character buffer. More...
 
virtual ASPOSECPP_SHARED_API int GetBytes (const String &s, int char_index, int char_count, ArrayPtr< uint8_t > bytes, int byte_index)
 Get the bytes that result from encoding a character buffer. More...
 
virtual ASPOSECPP_SHARED_API ArrayPtr< uint8_t > GetBytes (const String &s)
 Get the bytes that result from encoding a character buffer. More...
 
virtual ASPOSECPP_SHARED_API ArrayPtr< uint8_t > GetBytes (ArrayPtr< char_t > chars, int index, int count)
 Get the bytes that result from encoding a character buffer. More...
 
virtual ASPOSECPP_SHARED_API ArrayPtr< uint8_t > GetBytes (const System::Details::ArrayView< char_t > &chars, int index, int count)
 Get the bytes that result from encoding a character buffer. More...
 
template<std::size_t N>
ArrayPtr< uint8_t > GetBytes (const System::Details::StackArray< char_t, N > &chars, int index, int count)
 Get the bytes that result from encoding a character buffer. More...
 
virtual ASPOSECPP_SHARED_API ArrayPtr< uint8_t > GetBytes (ArrayPtr< char_t > chars)
 Get the bytes that result from encoding a character buffer. More...
 
virtual ASPOSECPP_SHARED_API int GetCharCount (ArrayPtr< uint8_t > bytes, int index, int count)
 Get the number of characters needed to decode a byte buffer. More...
 
virtual ASPOSECPP_SHARED_API int GetCharCount (ArrayPtr< uint8_t > bytes)
 Get the number of characters needed to decode a byte buffer. More...
 
virtual ASPOSECPP_SHARED_API int GetChars (ArrayPtr< uint8_t > bytes, int byte_index, int byte_count, ArrayPtr< char_t > chars, int char_index)
 Get the characters that result from decoding a byte buffer. More...
 
virtual ASPOSECPP_SHARED_API ArrayPtr< char_t > GetChars (ArrayPtr< uint8_t > bytes, int index, int count)
 Get the characters that result from decoding a byte buffer. More...
 
virtual ASPOSECPP_SHARED_API ArrayPtr< char_t > GetChars (ArrayPtr< uint8_t > bytes)
 Get the characters that result from decoding a byte buffer. More...
 
virtual ASPOSECPP_SHARED_API String GetString (uint8_t *bytes, int byte_count)
 Decodes a buffer of bytes into a string. More...
 
virtual ASPOSECPP_SHARED_API String GetString (ArrayPtr< uint8_t > bytes)
 Decodes a buffer of bytes into a string. More...
 
virtual ASPOSECPP_SHARED_API String GetString (const System::Details::ArrayView< uint8_t > &bytes)
 Decodes a buffer of bytes into a string. More...
 
template<std::size_t N>
String GetString (System::Details::StackArray< uint8_t, N > &bytes)
 Decodes a buffer of bytes into a string. More...
 
virtual ASPOSECPP_SHARED_API String GetString (ArrayPtr< uint8_t > bytes, int index, int count)
 Decodes a buffer of bytes into a string. More...
 
virtual ASPOSECPP_SHARED_API String GetString (const System::Details::ArrayView< uint8_t > &bytes, int index, int count)
 Decodes a buffer of bytes into a string. More...
 
template<std::size_t N>
String GetString (System::Details::StackArray< uint8_t, N > bytes, int index, int count)
 Decodes a buffer of bytes into a string. More...
 
- Public Member Functions inherited from System::Object
ASPOSECPP_SHARED_API Object ()
 Creates object. Initializes all internal data structures. More...
 
virtual ASPOSECPP_SHARED_API ~Object ()
 Destroys object. Frees all internal data structures. More...
 
ASPOSECPP_SHARED_API Object (Object const &x)
 Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
Objectoperator= (Object const &x)
 Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
ObjectSharedRefAdded ()
 Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int SharedRefRemovedSafe ()
 Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int RemovedSharedRefs (int count)
 Decreases shared reference count by specified value. More...
 
Detail::SmartPtrCounter * WeakRefAdded ()
 Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
void WeakRefRemoved ()
 Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
Detail::SmartPtrCounter * GetCounter ()
 Gets reference counter data structure associated with the object. More...
 
int SharedCount () const
 Gets current value of shared reference counter. More...
 
ASPOSECPP_SHARED_API void Lock ()
 Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...
 
ASPOSECPP_SHARED_API void Unlock ()
 Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...
 
virtual ASPOSECPP_SHARED_API bool Equals (ptr obj)
 Compares objects using C# Object.Equals semantics. More...
 
virtual ASPOSECPP_SHARED_API String ToString () const
 Analog of C# Object.ToString() method. Enables converting custom objects to string. More...
 
virtual ASPOSECPP_SHARED_API ptr MemberwiseClone () const
 Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...
 
virtual ASPOSECPP_SHARED_API const TypeInfoGetType () const
 Gets actual type of object. Analog of C# System.Object.GetType() call. More...
 
virtual ASPOSECPP_SHARED_API bool Is (const TypeInfo &targetType) const
 Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More...
 
virtual ASPOSECPP_SHARED_API void SetTemplateWeakPtr (uint32_t argument)
 Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More...
 
virtual ASPOSECPP_SHARED_API bool FastCast (const Details::FastRttiBase &helper, void **out_ptr) const
 For internal purposes only. More...
 
template<>
bool Equals (float const &objA, float const &objB)
 Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...
 
template<>
bool Equals (double const &objA, double const &objB)
 Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...
 
template<>
bool ReferenceEquals (String const &str, std::nullptr_t)
 Specialization of Object::ReferenceEquals for case of string and nullptr. More...
 
template<>
bool ReferenceEquals (String const &str1, String const &str2)
 Specialization of Object::ReferenceEquals for case of strings. More...
 

Static Public Attributes

static constexpr int UTF32_CODE_PAGE = 12000
 Magic number used by Windows for little endian UTF-32 codepage id. More...
 
static constexpr int BIG_UTF32_CODE_PAGE = 12001
 Magic number used by Windows for big endian UTF-32 codepage id. More...
 
- Static Public Attributes inherited from System::Text::Encoding
static constexpr int DEFAULT_CODE_PAGE = 0
 Default codepage value. More...
 

Protected Member Functions

ASPOSECPP_SHARED_API ~UTF32Encoding () override
 Destructor. More...
 
- Protected Member Functions inherited from System::Text::ICUEncoding
ASPOSECPP_SHARED_API ~ICUEncoding () override
 Destructor. More...
 
- Protected Member Functions inherited from System::Text::Encoding
ASPOSECPP_SHARED_API Encoding ()
 Default constructor. More...
 
ASPOSECPP_SHARED_API Encoding (int codepage)
 Constructor. More...
 
ASPOSECPP_SHARED_API Encoding (int codepage, const EncoderFallbackPtr &encoder_fallback, const DecoderFallbackPtr &decoder_fallback)
 Constructor. More...
 
 Encoding (const Details::EncodingInfoInternal *info)
 Internal constructor. More...
 

Additional Inherited Members

- Public Types inherited from System::Text::Encoding
typedef System::SharedPtr< EncodingPtr
 RTTI. More...
 
- Public Types inherited from System::Object
typedef SmartPtr< Objectptr
 Alias for smart pointer type. More...
 
- Static Public Member Functions inherited from System::Text::Encoding
static ASPOSECPP_SHARED_API ArrayPtr< uint8_t > Convert (const EncodingPtr &src_encoding, const EncodingPtr &dst_encoding, const ArrayPtr< uint8_t > &bytes)
 Converts bytes between two encodings. More...
 
static ASPOSECPP_SHARED_API ArrayPtr< uint8_t > Convert (const EncodingPtr &src_encoding, const EncodingPtr &dst_encoding, const ArrayPtr< uint8_t > &bytes, int index, int count)
 Converts bytes between two encodings. More...
 
static ASPOSECPP_SHARED_API EncodingPtr get_ASCII ()
 Gets ASCII encoding. More...
 
static ASPOSECPP_SHARED_API EncodingPtr get_BigEndianUnicode ()
 Gets the standard big-endian Unicode encoding object. More...
 
static ASPOSECPP_SHARED_API EncodingPtr get_Unicode ()
 Gets the standard Unicode encoding object. More...
 
static ASPOSECPP_SHARED_API EncodingPtr get_UTF8 ()
 Gets the standard UTF-8 encoding object. More...
 
static ASPOSECPP_SHARED_API EncodingPtr get_UTF8Unmarked ()
 Only internal, to be used by the class libraries: Unmarked and non-input-validating. More...
 
static ASPOSECPP_SHARED_API EncodingPtr get_UTF32 ()
 
static ASPOSECPP_SHARED_API EncodingPtr get_BigEndianUTF32 ()
 Gets the standard big-endian UTF-32 encoding object. More...
 
static ASPOSECPP_SHARED_API EncodingPtr get_UTF7 ()
 Gets the standard UTF-7 encoding object. More...
 
static EncodingPtr get_Latin1 ()
 Gets Latin1 encoding. FOR INTERNAL USE. More...
 
static ASPOSECPP_SHARED_API EncodingPtr GetEncoding (const String &name)
 Gets encoding by name. More...
 
static ASPOSECPP_SHARED_API EncodingPtr GetEncoding (int codepage)
 Gets encoding by codepage. More...
 
static ASPOSECPP_SHARED_API EncodingPtr GetEncoding (int codepage, const EncoderFallbackPtr &encoder_fallback, const DecoderFallbackPtr &decoder_fallback)
 Gets encoding by codepage. More...
 
static ASPOSECPP_SHARED_API EncodingPtr GetEncoding (const String &name, const EncoderFallbackPtr &encoder_fallback, const DecoderFallbackPtr &decoder_fallback)
 Gets encoding by name. More...
 
static ASPOSECPP_SHARED_API EncodingPtr get_Default ()
 Gets default encoding. More...
 
static ASPOSECPP_SHARED_API ArrayPtr< EncodingInfoPtrGetEncodings ()
 Gets list of known encodings. More...
 
- Static Public Member Functions inherited from System::Object
static bool ReferenceEquals (ptr const &objA, ptr const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, T const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, std::nullptr_t)
 Reference-compares value type object with nullptr. More...
 
template<typename T1 , typename T2 >
static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares reference type objects in C# style. More...
 
template<typename T1 , typename T2 >
static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares value type objects in C# style. More...
 
static const TypeInfoType ()
 Implements C# typeof(System.Object) construct. More...
 
- Protected Attributes inherited from System::Text::Encoding
const Details::EncodingInfoInternal * m_info
 Pointer to internal encoding info. More...
 
const int m_codepage
 Code page identifier. More...
 
bool m_is_read_only = true
 Read-only flag. More...
 

Detailed Description

UTF-32 encoding. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument.

Constructor & Destructor Documentation

◆ UTF32Encoding() [1/3]

ASPOSECPP_SHARED_API System::Text::UTF32Encoding::UTF32Encoding ( )

Constructor.

◆ UTF32Encoding() [2/3]

ASPOSECPP_SHARED_API System::Text::UTF32Encoding::UTF32Encoding ( bool  big_endian,
bool  byte_order_mark 
)

Constructor.

Parameters
big_endianWhether codepage is big endian as opposite to little endian.
byte_order_markWhether to insert BOM.

◆ UTF32Encoding() [3/3]

ASPOSECPP_SHARED_API System::Text::UTF32Encoding::UTF32Encoding ( bool  big_endian,
bool  byte_order_mark,
bool  throw_on_invalid_characters 
)

Constructor.

Parameters
big_endianWhether codepage is big endian as opposite to little endian.
byte_order_markWhether to insert BOM.
throw_on_invalid_charactersWhether to throw on invalid bytes as an opposite to replacing them.

◆ ~UTF32Encoding()

ASPOSECPP_SHARED_API System::Text::UTF32Encoding::~UTF32Encoding ( )
overrideprotected

Destructor.

Member Function Documentation

◆ Clone()

ASPOSECPP_SHARED_API SharedPtr<Object> System::Text::UTF32Encoding::Clone ( )
overridevirtual

Clones encoding object.

Returns
Encoding object clone.

Reimplemented from System::Text::Encoding.

◆ Equals()

ASPOSECPP_SHARED_API bool System::Text::UTF32Encoding::Equals ( SharedPtr< Object obj)
override

Compares with object.

Parameters
objObject to compare with.
Returns
True if obj is UTF32Encoding with same parameters, false otherwise.

◆ GetHashCode()

ASPOSECPP_SHARED_API int System::Text::UTF32Encoding::GetHashCode ( ) const
overridevirtual

Gets encoding hash code.

Returns
Hash code value.

Reimplemented from System::Text::Encoding.

◆ GetPreamble()

ASPOSECPP_SHARED_API ArrayPtr<uint8_t> System::Text::UTF32Encoding::GetPreamble ( )
overridevirtual

Get codepage preamble.

Returns
If BOM emitting is enabled, returns array with BOM characters, otherwise returns empty array.

Reimplemented from System::Text::ICUEncoding.

◆ operator==()

ASPOSECPP_SHARED_API bool System::Text::UTF32Encoding::operator== ( const UTF32Encoding other) const

Compares encodings' parameters.

Parameters
otherEncoding to compare with.
Returns
True if parameters match, false otherwise.

Member Data Documentation

◆ BIG_UTF32_CODE_PAGE

constexpr int System::Text::UTF32Encoding::BIG_UTF32_CODE_PAGE = 12001
static

Magic number used by Windows for big endian UTF-32 codepage id.

◆ UTF32_CODE_PAGE

constexpr int System::Text::UTF32Encoding::UTF32_CODE_PAGE = 12000
static

Magic number used by Windows for little endian UTF-32 codepage id.