Inherits System::Text::ICUEncoding.

Public Member Functions
ASPOSECPP_SHARED_API	UTF8Encoding ()
	Constructor. More...

ASPOSECPP_SHARED_API	UTF8Encoding (bool encoder_should_emit_utf8_idetifier)

ASPOSECPP_SHARED_API	UTF8Encoding (bool encoder_should_emit_utf8_identifier, bool throw_on_invalid_bytes)

ASPOSECPP_SHARED_API bool	operator== (const UTF8Encoding &other) const

ASPOSECPP_SHARED_API bool	Equals (SharedPtr< Object > obj) override

ASPOSECPP_SHARED_API int	GetHashCode () const override

ASPOSECPP_SHARED_API ArrayPtr< uint8_t >	GetPreamble () override

ASPOSECPP_SHARED_API SharedPtr< Object >	Clone () override

ASPOSECPP_SHARED_API int	GetMaxCharCount (int byte_count) override

ASPOSECPP_SHARED_API int	GetMaxByteCount (int char_count) override

Public Member Functions inherited from System::Text::ICUEncoding
	ICUEncoding (const Details::EncodingInfoInternal *encoding_info)

ASPOSECPP_SHARED_API bool	operator== (const ICUEncoding &other) const

ASPOSECPP_SHARED_API int	GetByteCount (const char_t *chars, int count) override

ASPOSECPP_SHARED_API int	GetBytes (const char_t chars, int char_count, uint8_t bytes, int byte_count) override

ASPOSECPP_SHARED_API int	GetCharCount (const uint8_t *bytes, int count) override

ASPOSECPP_SHARED_API int	GetChars (const uint8_t bytes, int byte_count, char_t chars, int char_count) override

ASPOSECPP_SHARED_API DecoderPtr	GetDecoder () override

ASPOSECPP_SHARED_API EncoderPtr	GetEncoder () override

virtual ASPOSECPP_SHARED_API int	GetByteCount (ArrayPtr< char_t > chars, int index, int count)
	RTTI. More...

virtual ASPOSECPP_SHARED_API int	GetByteCount (System::Details::ArrayView< char_t > chars, int index, int count)
	RTTI. More...

template<std::size_t N>
int	GetByteCount (const System::Details::StackArray< char_t, N > &chars, int index, int count)
	RTTI. More...

virtual ASPOSECPP_SHARED_API int	GetByteCount (const String &s)
	RTTI. More...

virtual ASPOSECPP_SHARED_API int	GetByteCount (ArrayPtr< char_t > chars)
	RTTI. More...

virtual ASPOSECPP_SHARED_API int	GetByteCount (const char_t *chars, int count)
	RTTI. More...

virtual ASPOSECPP_SHARED_API int	GetBytes (ArrayPtr< char_t > chars, int char_index, int char_count, ArrayPtr< uint8_t > bytes, int byte_index)

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)

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)

virtual ASPOSECPP_SHARED_API int	GetBytes (const String &s, int char_index, int char_count, ArrayPtr< uint8_t > bytes, int byte_index)

virtual ASPOSECPP_SHARED_API ArrayPtr< uint8_t >	GetBytes (const String &s)

virtual ASPOSECPP_SHARED_API ArrayPtr< uint8_t >	GetBytes (ArrayPtr< char_t > chars, int index, int count)

virtual ASPOSECPP_SHARED_API ArrayPtr< uint8_t >	GetBytes (const System::Details::ArrayView< char_t > &chars, int index, int count)

template<std::size_t N>
ArrayPtr< uint8_t >	GetBytes (const System::Details::StackArray< char_t, N > &chars, int index, int count)

virtual ASPOSECPP_SHARED_API ArrayPtr< uint8_t >	GetBytes (ArrayPtr< char_t > chars)

virtual ASPOSECPP_SHARED_API int	GetBytes (const char_t chars, int char_count, uint8_t bytes, int byte_count)

virtual ASPOSECPP_SHARED_API int	GetCharCount (ArrayPtr< uint8_t > bytes, int index, int count)

virtual ASPOSECPP_SHARED_API int	GetCharCount (ArrayPtr< uint8_t > bytes)

virtual ASPOSECPP_SHARED_API int	GetCharCount (const uint8_t *bytes, int count)

virtual ASPOSECPP_SHARED_API int	GetChars (ArrayPtr< uint8_t > bytes, int byte_index, int byte_count, ArrayPtr< char_t > chars, int char_index)

virtual ASPOSECPP_SHARED_API ArrayPtr< char_t >	GetChars (ArrayPtr< uint8_t > bytes, int index, int count)

virtual ASPOSECPP_SHARED_API ArrayPtr< char_t >	GetChars (ArrayPtr< uint8_t > bytes)

virtual ASPOSECPP_SHARED_API int	GetChars (const uint8_t bytes, int byte_count, char_t chars, int char_count)

Public Member Functions inherited from System::Text::Encoding
ASPOSECPP_SHARED_API bool	Equals (SharedPtr< Object > obj) override

virtual ASPOSECPP_SHARED_API int	get_CodePage ()

virtual ASPOSECPP_SHARED_API int	get_WindowsCodePage ()

virtual ASPOSECPP_SHARED_API String	get_WebName ()

virtual ASPOSECPP_SHARED_API String	get_BodyName ()

virtual ASPOSECPP_SHARED_API String	get_EncodingName ()

virtual ASPOSECPP_SHARED_API String	get_HeaderName ()

virtual ASPOSECPP_SHARED_API bool	get_IsSingleByte ()

virtual ASPOSECPP_SHARED_API bool	get_IsBrowserDisplay ()

virtual ASPOSECPP_SHARED_API bool	get_IsBrowserSave ()

virtual ASPOSECPP_SHARED_API bool	get_IsMailNewsDisplay ()

virtual ASPOSECPP_SHARED_API bool	get_IsMailNewsSave ()

ASPOSECPP_SHARED_API bool	get_IsReadOnly ()

ASPOSECPP_SHARED_API DecoderFallbackPtr	get_DecoderFallback () const

ASPOSECPP_SHARED_API void	set_DecoderFallback (const DecoderFallbackPtr &value)

ASPOSECPP_SHARED_API const EncoderFallbackPtr	get_EncoderFallback () const

ASPOSECPP_SHARED_API void	set_EncoderFallback (const EncoderFallbackPtr &value)

virtual ASPOSECPP_SHARED_API int	GetByteCount (ArrayPtr< char_t > chars, int index, int count)

virtual ASPOSECPP_SHARED_API int	GetByteCount (System::Details::ArrayView< char_t > chars, int index, int count)

template<std::size_t N>
int	GetByteCount (const System::Details::StackArray< char_t, N > &chars, int index, int count)

virtual ASPOSECPP_SHARED_API int	GetByteCount (const String &s)

virtual ASPOSECPP_SHARED_API int	GetByteCount (ArrayPtr< char_t > chars)

virtual ASPOSECPP_SHARED_API int	GetBytes (ArrayPtr< char_t > chars, int char_index, int char_count, ArrayPtr< uint8_t > bytes, int byte_index)

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)

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)

virtual ASPOSECPP_SHARED_API int	GetBytes (const String &s, int char_index, int char_count, ArrayPtr< uint8_t > bytes, int byte_index)

virtual ASPOSECPP_SHARED_API ArrayPtr< uint8_t >	GetBytes (const String &s)

virtual ASPOSECPP_SHARED_API ArrayPtr< uint8_t >	GetBytes (ArrayPtr< char_t > chars, int index, int count)

virtual ASPOSECPP_SHARED_API ArrayPtr< uint8_t >	GetBytes (const System::Details::ArrayView< char_t > &chars, int index, int count)

template<std::size_t N>
ArrayPtr< uint8_t >	GetBytes (const System::Details::StackArray< char_t, N > &chars, int index, int count)

virtual ASPOSECPP_SHARED_API ArrayPtr< uint8_t >	GetBytes (ArrayPtr< char_t > chars)

virtual ASPOSECPP_SHARED_API int	GetCharCount (ArrayPtr< uint8_t > bytes, int index, int count)

virtual ASPOSECPP_SHARED_API int	GetCharCount (ArrayPtr< uint8_t > bytes)

virtual ASPOSECPP_SHARED_API int	GetChars (ArrayPtr< uint8_t > bytes, int byte_index, int byte_count, ArrayPtr< char_t > chars, int char_index)

virtual ASPOSECPP_SHARED_API ArrayPtr< char_t >	GetChars (ArrayPtr< uint8_t > bytes, int index, int count)

virtual ASPOSECPP_SHARED_API ArrayPtr< char_t >	GetChars (ArrayPtr< uint8_t > bytes)

virtual ASPOSECPP_SHARED_API String	GetString (uint8_t *bytes, int byte_count)

virtual ASPOSECPP_SHARED_API String	GetString (ArrayPtr< uint8_t > bytes)

virtual ASPOSECPP_SHARED_API String	GetString (const System::Details::ArrayView< uint8_t > &bytes)

template<std::size_t N>
String	GetString (System::Details::StackArray< uint8_t, N > &bytes)

virtual ASPOSECPP_SHARED_API String	GetString (ArrayPtr< uint8_t > bytes, int index, int count)

virtual ASPOSECPP_SHARED_API String	GetString (const System::Details::ArrayView< uint8_t > &bytes, int index, int count)

template<std::size_t N>
String	GetString (System::Details::StackArray< uint8_t, N > bytes, int index, int count)

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...

Object &	operator= (Object const &x)
	Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...

Object *	SharedRefAdded ()
	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 TypeInfo &	GetType () 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)

template<>
bool	Equals (double const &objA, double const &objB)

template<>
bool	ReferenceEquals (String const &str, std::nullptr_t)

template<>
bool	ReferenceEquals (String const &str1, String const &str2)

Static Public Attributes
static constexpr int	UTF8_CODE_PAGE = 65001
	RTTI information. More...

Static Public Attributes inherited from System::Text::Encoding
static constexpr int	DEFAULT_CODE_PAGE = 0
	Default codepage value. More...

Additional Inherited Members
Public Types inherited from System::Text::Encoding
typedef System::SharedPtr< Encoding >	Ptr
	RTTI. More...

Public Types inherited from System::Object
typedef SmartPtr< Object >	ptr
	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)

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)

static ASPOSECPP_SHARED_API EncodingPtr	get_ASCII ()

static ASPOSECPP_SHARED_API EncodingPtr	get_BigEndianUnicode ()

static ASPOSECPP_SHARED_API EncodingPtr	get_Unicode ()

static ASPOSECPP_SHARED_API EncodingPtr	get_UTF8 ()

static ASPOSECPP_SHARED_API EncodingPtr	get_UTF8Unmarked ()

static ASPOSECPP_SHARED_API EncodingPtr	get_UTF32 ()

static ASPOSECPP_SHARED_API EncodingPtr	get_BigEndianUTF32 ()

static ASPOSECPP_SHARED_API EncodingPtr	get_UTF7 ()

static EncodingPtr	get_Latin1 ()
	Gets Latin1 encoding. FOR INTERNAL USE. More...

static ASPOSECPP_SHARED_API EncodingPtr	GetEncoding (const String &name)

static ASPOSECPP_SHARED_API EncodingPtr	GetEncoding (int codepage)

static ASPOSECPP_SHARED_API EncodingPtr	GetEncoding (int codepage, const EncoderFallbackPtr &encoder_fallback, const DecoderFallbackPtr &decoder_fallback)

static ASPOSECPP_SHARED_API EncodingPtr	GetEncoding (const String &name, const EncoderFallbackPtr &encoder_fallback, const DecoderFallbackPtr &decoder_fallback)

static ASPOSECPP_SHARED_API EncodingPtr	get_Default ()

static ASPOSECPP_SHARED_API ArrayPtr< EncodingInfoPtr >	GetEncodings ()

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 TypeInfo &	Type ()
	Implements C# typeof(System.Object) construct. More...

Detailed Description

UTF-8 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

◆ UTF8Encoding() [1/3]

ASPOSECPP_SHARED_API System::Text::UTF8Encoding::UTF8Encoding ( )

Constructor.

◆ UTF8Encoding() [2/3]

ASPOSECPP_SHARED_API System::Text::UTF8Encoding::UTF8Encoding ( bool encoder_should_emit_utf8_idetifier )

Constructor.

Parameters

encoder_should_emit_utf8_idetifier Whether to insert BOM.

◆ UTF8Encoding() [3/3]

ASPOSECPP_SHARED_API System::Text::UTF8Encoding::UTF8Encoding	(	bool	encoder_should_emit_utf8_identifier,
		bool	throw_on_invalid_bytes
	)

Constructor.

Parameters

encoder_should_emit_utf8_identifier	Whether to insert BOM.
throw_on_invalid_bytes	Whether to throw on invalid bytes as an opposite to replacing them.

Member Function Documentation

◆ Clone()

ASPOSECPP_SHARED_API SharedPtr<Object> System::Text::UTF8Encoding::Clone ( )

overridevirtual

Clones encoding object.

Returns: Encoding object clone.

Reimplemented from System::Text::Encoding.

◆ Equals()

ASPOSECPP_SHARED_API bool System::Text::UTF8Encoding::Equals ( SharedPtr< Object > obj )

override

Compares with object.

Parameters

obj	Object to compare with.

Returns: True if obj is UTF8Encoding with same parameters, false otherwise.

◆ GetHashCode()

ASPOSECPP_SHARED_API int System::Text::UTF8Encoding::GetHashCode ( ) const

overridevirtual

Gets encoding hash code.

Returns: Hash code value.

Reimplemented from System::Text::Encoding.

◆ GetMaxByteCount()

ASPOSECPP_SHARED_API int System::Text::UTF8Encoding::GetMaxByteCount ( int char_count )

overridevirtual

Get the maximum number of bytes needed to encode a specified number of characters.

Parameters

char_count Number of characters to encode.

Returns: Number of bytes sufficient to encode any string of given character length.

Reimplemented from System::Text::ICUEncoding.

◆ GetMaxCharCount()

ASPOSECPP_SHARED_API int System::Text::UTF8Encoding::GetMaxCharCount ( int byte_count )

overridevirtual

Get the maximum number of characters needed to decode a specified number of bytes.

Parameters

byte_count Number of bytes to decode.

Returns: Number of bytes sufficient to decode any string of given character length.

Reimplemented from System::Text::ICUEncoding.

◆ GetPreamble()

ASPOSECPP_SHARED_API ArrayPtr<uint8_t> System::Text::UTF8Encoding::GetPreamble ( )

overridevirtual

Get codepage preamble.

Returns: If UTF-8 identifier emitting is enabled, returns array with BOM characters, otherwise returns empty array.

Reimplemented from System::Text::ICUEncoding.

◆ operator==()

ASPOSECPP_SHARED_API bool System::Text::UTF8Encoding::operator== ( const UTF8Encoding & other ) const

Compares encodings parameters.

Parameters

other Encoding to compare with.

Returns: True if parameters match, false otherwise.

Member Data Documentation

◆ UTF8_CODE_PAGE

constexpr int System::Text::UTF8Encoding::UTF8_CODE_PAGE = 65001

static

RTTI information.

Magic number used by Windows for UTF-8 codepage id.

Public Member Functions

Static Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ UTF8Encoding() [1/3]

◆ UTF8Encoding() [2/3]

◆ UTF8Encoding() [3/3]

Member Function Documentation

◆ Clone()

◆ Equals()

◆ GetHashCode()

◆ GetMaxByteCount()

◆ GetMaxCharCount()

◆ GetPreamble()

◆ operator==()

Member Data Documentation

◆ UTF8_CODE_PAGE