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

#include <utf7_encoding.h>

Inherits System::Text::Encoding.

Public Member Functions
	UTF7Encoding ()
	Constructor. More...

	UTF7Encoding (bool allow_optionals)
	Constructor. More...

bool	operator== (const UTF7Encoding &other) const
	Compares encodings parameters. More...

bool	Equals (SharedPtr< Object > obj) override
	Compares with object. More...

int	GetHashCode () const override
	Gets encoding hash code. More...

SharedPtr< Object >	Clone () override
	Clones encoding object. More...

int	GetBytes (ArrayPtr< char_t > chars, int char_index, int char_count, ArrayPtr< uint8_t > bytes, int byte_index) override
	Get the bytes that result from encoding a character buffer. More...

int	GetCharCount (ArrayPtr< uint8_t > bytes, int index, int count) override
	Get the number of characters needed to decode a byte buffer. More...

int	GetChars (ArrayPtr< uint8_t > bytes, int byte_index, int byte_count, ArrayPtr< char_t > chars, int char_index) override
	Get the characters that result from decoding a byte buffer. More...

int	GetMaxByteCount (int char_count) override
	Get the maximum number of bytes needed to encode a specified number of characters. More...

int	GetMaxCharCount (int byte_count) override
	Get the maximum number of characters needed to decode a specified number of bytes. More...

DecoderPtr	GetDecoder () override
	Get a decoder that forwards requests to this object. More...

EncoderPtr	GetEncoder () override
	Get an encoder that forwards requests to this object. More...

int	GetByteCount (const char_t *chars, int count) override
	Get the number of characters needed to encode a character buffer. More...

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

int	GetBytes (const String &s, int char_index, int char_count, ArrayPtr< uint8_t > bytes, int byte_index) override
	Get the bytes that result from encoding a character buffer. More...

int	GetCharCount (const uint8_t *bytes, int count) override
	Get the number of characters needed to decode a byte buffer. More...

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

String	GetString (ArrayPtr< uint8_t > bytes, int index, int count) override
	Decodes a buffer of bytes into a string. More...

virtual int	GetByteCount (ArrayPtr< char_t > chars, int index, int count)
	Get the number of characters needed to encode a character buffer. More...

virtual 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 int	GetByteCount (const String &s)
	Get the number of characters needed to encode a string. More...

virtual int	GetByteCount (ArrayPtr< char_t > chars)
	Get the number of characters needed to encode a character buffer. More...

virtual int	GetByteCount (const char_t *chars, int count)
	Get the number of characters needed to encode a character buffer. More...

virtual 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 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 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 ArrayPtr< uint8_t >	GetBytes (const String &s)
	Get the bytes that result from encoding a character buffer. More...

virtual ArrayPtr< uint8_t >	GetBytes (ArrayPtr< char_t > chars, int index, int count)
	Get the bytes that result from encoding a character buffer. More...

virtual 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 ArrayPtr< uint8_t >	GetBytes (ArrayPtr< char_t > chars)
	Get the bytes that result from encoding a character buffer. More...

virtual int	GetBytes (const char_t chars, int char_count, uint8_t bytes, int byte_count)
	Get the bytes that result from encoding a character buffer. More...

virtual int	GetCharCount (ArrayPtr< uint8_t > bytes, int index, int count)
	Get the number of characters needed to decode a byte buffer. More...

virtual int	GetCharCount (ArrayPtr< uint8_t > bytes)
	Get the number of characters needed to decode a byte buffer. More...

virtual int	GetCharCount (const uint8_t *bytes, int count)
	Get the number of characters needed to decode a byte buffer. More...

virtual 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 ArrayPtr< char_t >	GetChars (ArrayPtr< uint8_t > bytes, int index, int count)
	Get the characters that result from decoding a byte buffer. More...

virtual ArrayPtr< char_t >	GetChars (ArrayPtr< uint8_t > bytes)
	Get the characters that result from decoding a byte buffer. More...

virtual int	GetChars (const uint8_t bytes, int byte_count, char_t chars, int char_count)
	Get the characters that result from decoding a byte buffer. More...

virtual String	GetString (uint8_t *bytes, int byte_count)
	Decodes a buffer of bytes into a string. More...

virtual String	GetString (ArrayPtr< uint8_t > bytes)
	Decodes a buffer of bytes into a string. More...

virtual 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 String	GetString (ArrayPtr< uint8_t > bytes, int index, int count)
	Decodes a buffer of bytes into a string. More...

virtual 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::Text::Encoding
bool	Equals (SharedPtr< Object > obj) override
	Compares encodings. More...

int	GetHashCode () const override
	Hashes encoding. More...

virtual int	get_CodePage ()
	Gets Windows codepage ID. More...

virtual int	get_WindowsCodePage ()
	Gets Windows codepage ID. More...

virtual String	get_WebName ()
	Gets IANA-compatible encoding name. More...

virtual String	get_BodyName ()
	Gets mail agent body compatible encoding name. More...

virtual String	get_EncodingName ()
	Gets human-readable encoding name. More...

virtual String	get_HeaderName ()
	Gets mail agent header compatible encoding name. More...

virtual bool	get_IsSingleByte ()
	Checks whether encoding is single byte. More...

virtual bool	get_IsBrowserDisplay ()
	Checks whether encoding can be used in browser to display content. More...

virtual bool	get_IsBrowserSave ()
	Checks whether encoding can be used in browser to save content. More...

virtual bool	get_IsMailNewsDisplay ()
	Checks whether encoding can be used in mail client to display content. More...

virtual bool	get_IsMailNewsSave ()
	Checks whether encoding can be used in mail client to save content. More...

bool	get_IsReadOnly ()
	Checks whether encoding is read-only. More...

DecoderFallbackPtr	get_DecoderFallback () const
	Gets decoder fallback. More...

void	set_DecoderFallback (const DecoderFallbackPtr &value)
	Sets decoder fallback. More...

const EncoderFallbackPtr	get_EncoderFallback () const
	Gets encoder fallback. More...

void	set_EncoderFallback (const EncoderFallbackPtr &value)
	Sets encoder fallback. More...

virtual int	GetByteCount (ArrayPtr< char_t > chars, int index, int count)
	Get the number of characters needed to encode a character buffer. More...

virtual 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 int	GetByteCount (const String &s)
	Get the number of characters needed to encode a string. More...

virtual int	GetByteCount (ArrayPtr< char_t > chars)
	Get the number of characters needed to encode a character buffer. More...

virtual int	GetByteCount (const char_t *chars, int count)
	Get the number of characters needed to encode a character buffer. More...

virtual 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 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 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 ArrayPtr< uint8_t >	GetBytes (const String &s)
	Get the bytes that result from encoding a character buffer. More...

virtual ArrayPtr< uint8_t >	GetBytes (ArrayPtr< char_t > chars, int index, int count)
	Get the bytes that result from encoding a character buffer. More...

virtual 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 ArrayPtr< uint8_t >	GetBytes (ArrayPtr< char_t > chars)
	Get the bytes that result from encoding a character buffer. More...

virtual int	GetBytes (const char_t chars, int char_count, uint8_t bytes, int byte_count)
	Get the bytes that result from encoding a character buffer. More...

virtual int	GetCharCount (ArrayPtr< uint8_t > bytes, int index, int count)
	Get the number of characters needed to decode a byte buffer. More...

virtual int	GetCharCount (ArrayPtr< uint8_t > bytes)
	Get the number of characters needed to decode a byte buffer. More...

virtual int	GetCharCount (const uint8_t *bytes, int count)
	Get the number of characters needed to decode a byte buffer. More...

virtual 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 ArrayPtr< char_t >	GetChars (ArrayPtr< uint8_t > bytes, int index, int count)
	Get the characters that result from decoding a byte buffer. More...

virtual ArrayPtr< char_t >	GetChars (ArrayPtr< uint8_t > bytes)
	Get the characters that result from decoding a byte buffer. More...

virtual int	GetChars (const uint8_t bytes, int byte_count, char_t chars, int char_count)
	Get the characters that result from decoding a byte buffer. More...

virtual DecoderPtr	GetDecoder ()
	Get a decoder that forwards requests to this object. More...

virtual EncoderPtr	GetEncoder ()
	Get an encoder that forwards requests to this object. More...

virtual String	GetString (uint8_t *bytes, int byte_count)
	Decodes a buffer of bytes into a string. More...

virtual String	GetString (ArrayPtr< uint8_t > bytes)
	Decodes a buffer of bytes into a string. More...

virtual 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 String	GetString (ArrayPtr< uint8_t > bytes, int index, int count)
	Decodes a buffer of bytes into a string. More...

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

virtual int	GetMaxByteCount (int char_count)=0
	Get the maximum number of bytes needed to encode a specified number of characters. More...

virtual int	GetMaxCharCount (int byte_count)=0
	Get the maximum number of characters needed to decode a specified number of bytes. More...

virtual SharedPtr< Object >	Clone ()
	Clones encoding object. More...

virtual ArrayPtr< uint8_t >	GetPreamble ()
	Returns a sequence of bytes that denotes the encoding (e. g. BOM). More...

Public Member Functions inherited from System::Object
	Object ()
	Creates object. Initializes all internal data structures. More...

virtual	~Object ()
	Destroys object. Frees all internal data structures. More...

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

void	Lock ()
	Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...

void	Unlock ()
	Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...

virtual bool	Equals (ptr obj)
	Compares objects using C# Object.Equals semantics. More...

virtual int32_t	GetHashCode () const
	Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...

virtual String	ToString () const
	Analog of C# Object.ToString() method. Enables converting custom objects to string. More...

virtual ptr	MemberwiseClone () const
	Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...

virtual const TypeInfo &	GetType () const
	Gets actual type of object. Analog of C# System.Object.GetType() call. More...

virtual bool	Is (const TypeInfo &targetType) const
	Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More...

virtual 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 bool	FastCast (const Details::FastRttiBase &helper, void **out_ptr) const
	For internal purposes only. 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	UTF7_CODE_PAGE = 65000
	Magic number used by Windows for UTF-7 codepage id. 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 ArrayPtr< uint8_t >	Convert (const EncodingPtr &src_encoding, const EncodingPtr &dst_encoding, const ArrayPtr< uint8_t > &bytes)
	Converts bytes between two encodings. More...

static 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 EncodingPtr	get_ASCII ()
	Gets ASCII encoding. More...

static EncodingPtr	get_BigEndianUnicode ()
	Gets the standard big-endian Unicode encoding object. More...

static EncodingPtr	get_Unicode ()
	Gets the standard Unicode encoding object. More...

static EncodingPtr	get_UTF8 ()
	Gets the standard UTF-8 encoding object. More...

static EncodingPtr	get_UTF8Unmarked ()
	Only internal, to be used by the class libraries: Unmarked and non-input-validating. More...

static EncodingPtr	get_UTF32 ()

static EncodingPtr	get_BigEndianUTF32 ()
	Gets the standard big-endian UTF-32 encoding object. More...

static EncodingPtr	get_UTF7 ()
	Gets the standard UTF-7 encoding object. More...

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

static EncodingPtr	GetEncoding (const String &name)
	Gets encoding by name. More...

static EncodingPtr	GetEncoding (int codepage)
	Gets encoding by codepage. More...

static EncodingPtr	GetEncoding (int codepage, const EncoderFallbackPtr &encoder_fallback, const DecoderFallbackPtr &decoder_fallback)
	Gets encoding by codepage. More...

static EncodingPtr	GetEncoding (const String &name, const EncoderFallbackPtr &encoder_fallback, const DecoderFallbackPtr &decoder_fallback)
	Gets encoding by name. More...

static EncodingPtr	get_Default ()
	Gets default encoding. More...

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

Protected Member Functions inherited from System::Text::Encoding
	Encoding ()
	Default constructor. More...

	Encoding (int codepage)
	Constructor. More...

	Encoding (int codepage, const EncoderFallbackPtr &encoder_fallback, const DecoderFallbackPtr &decoder_fallback)
	Constructor. More...

	Encoding (const Details::EncodingInfoInternal *info)
	Internal constructor. More...

Detailed Description

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

◆ UTF7Encoding() [1/2]

System::Text::UTF7Encoding::UTF7Encoding ( )

Constructor.

◆ UTF7Encoding() [2/2]

System::Text::UTF7Encoding::UTF7Encoding ( bool allow_optionals )

Constructor.

Parameters

allow_optionals Whether to encode (false) characters that are allowed to go unencoded or leave them as-is (true).

Member Function Documentation

◆ Clone()

SharedPtr< Object > System::Text::UTF7Encoding::Clone ( )

overridevirtual

Clones encoding object.

Returns: Encoding object clone.

Reimplemented from System::Text::Encoding.

◆ Equals()

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

override

Compares with object.

Parameters

obj	Object to compare with.

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

◆ GetByteCount() [1/7]

virtual int System::Text::Encoding::GetByteCount ( ArrayPtr< char_t > chars )

virtual

Get the number of characters needed to encode a character buffer.

Parameters

chars Characters buffer.

Returns: Required buffer size.

Reimplemented from System::Text::Encoding.

◆ GetByteCount() [2/7]

virtual int System::Text::Encoding::GetByteCount	(	ArrayPtr< char_t >	chars,
		int	index,
		int	count
	)

virtual

Get the number of characters needed to encode a character buffer.

Parameters

chars	Characters buffer.
index	Slice begin.
count	Slice size.

Returns: Required buffer size.

Reimplemented from System::Text::Encoding.

◆ GetByteCount() [3/7]

virtual int System::Text::Encoding::GetByteCount	(	const char_t *	chars,
		int	count
	)

virtual

Get the number of characters needed to encode a character buffer.

Parameters

chars	Characters buffer.
count	Buffer size.

Returns: Required buffer size.

Reimplemented from System::Text::Encoding.

◆ GetByteCount() [4/7]

int System::Text::UTF7Encoding::GetByteCount	(	const char_t *	chars,
		int	count
	)

overridevirtual

Get the number of characters needed to encode a character buffer.

Parameters

chars	Characters buffer.
count	Buffer size.

Returns: Required buffer size.

Reimplemented from System::Text::Encoding.

◆ GetByteCount() [5/7]

virtual int System::Text::Encoding::GetByteCount ( const String & s )

virtual

Get the number of characters needed to encode a string.

Parameters

s	String to encode.

Returns: Required buffer size.

Reimplemented from System::Text::Encoding.

◆ GetByteCount() [6/7]

template<std::size_t N>

int System::Text::Encoding::GetByteCount	(	const System::Details::StackArray< char_t, N > &	chars,
		int	index,
		int	count
	)

inline

Get the number of characters needed to encode a character buffer.

Parameters

chars	Characters buffer.
index	Slice begin.
count	Slice size.

Returns: Required buffer size.

◆ GetByteCount() [7/7]

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

virtual

Get the number of characters needed to encode a character buffer.

Parameters

chars	Characters buffer.
index	Slice begin.
count	Slice size.

Returns: Required buffer size.

Reimplemented from System::Text::Encoding.

◆ GetBytes() [1/13]

virtual ArrayPtr< uint8_t > System::Text::Encoding::GetBytes ( ArrayPtr< char_t > chars )

virtual

Get the bytes that result from encoding a character buffer.

Parameters

chars Characters to encode.

Returns: Buffer that holds representation of characters being encoded.

Reimplemented from System::Text::Encoding.

◆ GetBytes() [2/13]

virtual int System::Text::Encoding::GetBytes	(	ArrayPtr< char_t >	chars,
		int	char_index,
		int	char_count,
		ArrayPtr< uint8_t >	bytes,
		int	byte_index
	)

virtual

Get the bytes that result from encoding a character buffer.

Parameters

chars	Characters to encode.
char_index	Character slice beginning.
char_count	Number of characters to convert.
bytes	Buffer to put characters to.
byte_index	Output buffer offset.

Returns: Number of written bytes.

Reimplemented from System::Text::Encoding.

◆ GetBytes() [3/13]

int System::Text::UTF7Encoding::GetBytes	(	ArrayPtr< char_t >	chars,
		int	char_index,
		int	char_count,
		ArrayPtr< uint8_t >	bytes,
		int	byte_index
	)

overridevirtual

Get the bytes that result from encoding a character buffer.

Parameters

chars	Characters to encode.
char_index	Character slice beginning.
char_count	Number of characters to convert.
bytes	Buffer to put characters to.
byte_index	Output buffer offset.

Returns: Number of written bytes.

Reimplemented from System::Text::Encoding.

◆ GetBytes() [4/13]

virtual ArrayPtr< uint8_t > System::Text::Encoding::GetBytes	(	ArrayPtr< char_t >	chars,
		int	index,
		int	count
	)

virtual

Get the bytes that result from encoding a character buffer.

Parameters

chars	Characters to encode.
index	Character slice beginning.
count	Number of characters to convert.

Returns: Buffer that holds representation of characters being encoded.

Reimplemented from System::Text::Encoding.

◆ GetBytes() [5/13]

virtual int System::Text::Encoding::GetBytes	(	const char_t *	chars,
		int	char_count,
		uint8_t *	bytes,
		int	byte_count
	)

virtual

Get the bytes that result from encoding a character buffer.

Parameters

chars	Characters to encode.
char_count	Number of characters to convert.
bytes	Buffer to put characters to.
byte_count	Output buffer size.

Returns: Number of written bytes.

Reimplemented from System::Text::Encoding.

◆ GetBytes() [6/13]

int System::Text::UTF7Encoding::GetBytes	(	const char_t *	chars,
		int	char_count,
		uint8_t *	bytes,
		int	byte_count
	)

overridevirtual

Get the bytes that result from encoding a character buffer.

Parameters

chars	Characters to encode.
char_count	Number of characters to convert.
bytes	Buffer to put characters to.
byte_count	Output buffer size.

Returns: Number of written bytes.

Reimplemented from System::Text::Encoding.

◆ GetBytes() [7/13]

virtual ArrayPtr< uint8_t > System::Text::Encoding::GetBytes ( const String & s )

virtual

Get the bytes that result from encoding a character buffer.

Parameters

s	String to encode.

Returns: Buffer that holds representation of characters being encoded.

Reimplemented from System::Text::Encoding.

◆ GetBytes() [8/13]

virtual int System::Text::Encoding::GetBytes	(	const String &	s,
		int	char_index,
		int	char_count,
		ArrayPtr< uint8_t >	bytes,
		int	byte_index
	)

virtual

Get the bytes that result from encoding a character buffer.

Parameters

s	String to encode.
char_index	Character slice beginning.
char_count	Number of characters to convert.
bytes	Buffer to put characters to.
byte_index	Output buffer offset.

Returns: Number of written bytes.

Reimplemented from System::Text::Encoding.

◆ GetBytes() [9/13]

int System::Text::UTF7Encoding::GetBytes	(	const String &	s,
		int	char_index,
		int	char_count,
		ArrayPtr< uint8_t >	bytes,
		int	byte_index
	)

overridevirtual

Get the bytes that result from encoding a character buffer.

Parameters

s	String to encode.
char_index	Character slice beginning.
char_count	Number of characters to convert.
bytes	Buffer to put characters to.
byte_index	Output buffer offset.

Returns: Number of written bytes.

Reimplemented from System::Text::Encoding.

◆ GetBytes() [10/13]

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

virtual

Get the bytes that result from encoding a character buffer.

Parameters

chars	Characters to encode.
index	Character slice beginning.
count	Number of characters to convert.

Returns: Buffer that holds representation of characters being encoded.

Reimplemented from System::Text::Encoding.

◆ GetBytes() [11/13]

template<std::size_t N>

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

inline

Get the bytes that result from encoding a character buffer.

Parameters

chars	Characters to encode.
index	Character slice beginning.
count	Number of characters to convert.

Returns: Buffer that holds representation of characters being encoded.

◆ GetBytes() [12/13]

virtual int System::Text::Encoding::GetBytes	(	System::Details::ArrayView< char_t >	chars,
		int	char_index,
		int	char_count,
		System::Details::ArrayView< uint8_t >	bytes,
		int	byte_index
	)

virtual

Get the bytes that result from encoding a character buffer.

Parameters

chars	Characters to encode.
char_index	Character slice beginning.
char_count	Number of characters to convert.
bytes	Buffer to put characters to.
byte_index	Output buffer offset.

Returns: Number of written bytes.

Reimplemented from System::Text::Encoding.

◆ GetBytes() [13/13]

template<std::size_t SC, std::size_t SB>

int System::Text::Encoding::GetBytes	(	System::Details::StackArray< char_t, SC > &	chars,
		int	char_index,
		int	char_count,
		System::Details::StackArray< uint8_t, SB > &	bytes,
		int	byte_index
	)

inline

Get the bytes that result from encoding a character buffer.

Parameters

chars	Characters to encode.
char_index	Character slice beginning.
char_count	Number of characters to convert.
bytes	Buffer to put characters to.
byte_index	Output buffer offset.

Returns: Number of written bytes.

◆ GetCharCount() [1/5]

virtual int System::Text::Encoding::GetCharCount ( ArrayPtr< uint8_t > bytes )

virtual

Get the number of characters needed to decode a byte buffer.

Parameters

bytes Bytes to decode.

Returns: Number of characters.

Reimplemented from System::Text::Encoding.

◆ GetCharCount() [2/5]

virtual int System::Text::Encoding::GetCharCount	(	ArrayPtr< uint8_t >	bytes,
		int	index,
		int	count
	)

virtual

Get the number of characters needed to decode a byte buffer.

Parameters

bytes	Bytes to decode.
index	Slice beginning.
count	Slice size.

Returns: Number of characters.

Reimplemented from System::Text::Encoding.

◆ GetCharCount() [3/5]

int System::Text::UTF7Encoding::GetCharCount	(	ArrayPtr< uint8_t >	bytes,
		int	index,
		int	count
	)

overridevirtual

Get the number of characters needed to decode a byte buffer.

Parameters

bytes	Bytes to decode.
index	Slice beginning.
count	Slice size.

Returns: Number of characters.

Reimplemented from System::Text::Encoding.

◆ GetCharCount() [4/5]

virtual int System::Text::Encoding::GetCharCount	(	const uint8_t *	bytes,
		int	count
	)

virtual

Get the number of characters needed to decode a byte buffer.

Parameters

bytes	Bytes to decode.
count	Bytes count.

Returns: Number of characters.

Reimplemented from System::Text::Encoding.

◆ GetCharCount() [5/5]

int System::Text::UTF7Encoding::GetCharCount	(	const uint8_t *	bytes,
		int	count
	)

overridevirtual

Get the number of characters needed to decode a byte buffer.

Parameters

bytes	Bytes to decode.
count	Bytes count.

Returns: Number of characters.

Reimplemented from System::Text::Encoding.

◆ GetChars() [1/6]

virtual ArrayPtr< char_t > System::Text::Encoding::GetChars ( ArrayPtr< uint8_t > bytes )

virtual

Get the characters that result from decoding a byte buffer.

Parameters

bytes Buffer to read bytes from.

Returns: Buffer of decoded characters.

Reimplemented from System::Text::Encoding.

◆ GetChars() [2/6]

virtual int System::Text::Encoding::GetChars	(	ArrayPtr< uint8_t >	bytes,
		int	byte_index,
		int	byte_count,
		ArrayPtr< char_t >	chars,
		int	char_index
	)

virtual

Get the characters that result from decoding a byte buffer.

Parameters

bytes	Buffer to read bytes from.
byte_index	Input buffer offset.
byte_count	Input buffer size.
chars	Buffer to put characters to.
char_index	Output buffer offset.

Returns: Number of written characters.

Reimplemented from System::Text::Encoding.

◆ GetChars() [3/6]

int System::Text::UTF7Encoding::GetChars	(	ArrayPtr< uint8_t >	bytes,
		int	byte_index,
		int	byte_count,
		ArrayPtr< char_t >	chars,
		int	char_index
	)

overridevirtual

Get the characters that result from decoding a byte buffer.

Parameters

bytes	Buffer to read bytes from.
byte_index	Input buffer offset.
byte_count	Input buffer size.
chars	Buffer to put characters to.
char_index	Output buffer offset.

Returns: Number of written characters.

Reimplemented from System::Text::Encoding.

◆ GetChars() [4/6]

virtual ArrayPtr< char_t > System::Text::Encoding::GetChars	(	ArrayPtr< uint8_t >	bytes,
		int	index,
		int	count
	)

virtual

Get the characters that result from decoding a byte buffer.

Parameters

bytes	Buffer to read bytes from.
index	Input buffer offset.
count	Input buffer size.

Returns: Buffer of decoded characters.

Reimplemented from System::Text::Encoding.

◆ GetChars() [5/6]

virtual int System::Text::Encoding::GetChars	(	const uint8_t *	bytes,
		int	byte_count,
		char_t *	chars,
		int	char_count
	)

virtual

Get the characters that result from decoding a byte buffer.

Parameters

bytes	Buffer to read bytes from.
byte_count	Input buffer size.
chars	Buffer to put characters to.
char_count	Output buffer size.

Returns: Number of written characters.

Reimplemented from System::Text::Encoding.

◆ GetChars() [6/6]

int System::Text::UTF7Encoding::GetChars	(	const uint8_t *	bytes,
		int	byte_count,
		char_t *	chars,
		int	char_count
	)

overridevirtual

Get the characters that result from decoding a byte buffer.

Parameters

bytes	Buffer to read bytes from.
byte_count	Input buffer size.
chars	Buffer to put characters to.
char_count	Output buffer size.

Returns: Number of written characters.

Reimplemented from System::Text::Encoding.

◆ GetDecoder()

DecoderPtr System::Text::UTF7Encoding::GetDecoder ( )

overridevirtual

Get a decoder that forwards requests to this object.

Returns: Newly created decoder.

Reimplemented from System::Text::Encoding.

◆ GetEncoder()

EncoderPtr System::Text::UTF7Encoding::GetEncoder ( )

overridevirtual

Get an encoder that forwards requests to this object.

Returns: Newly created encoder.

Reimplemented from System::Text::Encoding.

◆ GetHashCode()

int System::Text::UTF7Encoding::GetHashCode ( ) const

overridevirtual

Gets encoding hash code.

Returns: Hash code value.

Reimplemented from System::Text::Encoding.

◆ GetMaxByteCount()

int System::Text::UTF7Encoding::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.

Implements System::Text::Encoding.

◆ GetMaxCharCount()

int System::Text::UTF7Encoding::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.

Implements System::Text::Encoding.

◆ GetString() [1/8]

virtual String System::Text::Encoding::GetString ( ArrayPtr< uint8_t > bytes )

virtual

Decodes a buffer of bytes into a string.

Parameters

bytes Buffer to read bytes from.

Returns: String of decoded characters.

Reimplemented from System::Text::Encoding.

◆ GetString() [2/8]

virtual String System::Text::Encoding::GetString	(	ArrayPtr< uint8_t >	bytes,
		int	index,
		int	count
	)

virtual

Decodes a buffer of bytes into a string.

Parameters

bytes	Buffer to read bytes from.
index	Input buffer offset.
count	Input buffer size.

Returns: String of decoded characters.

Reimplemented from System::Text::Encoding.

◆ GetString() [3/8]

String System::Text::UTF7Encoding::GetString	(	ArrayPtr< uint8_t >	bytes,
		int	index,
		int	count
	)

overridevirtual

Decodes a buffer of bytes into a string.

Parameters

bytes	Buffer to read bytes from.
index	Input buffer offset.
count	Input buffer size.

Returns: String of decoded characters.

Reimplemented from System::Text::Encoding.

◆ GetString() [4/8]

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

virtual

Decodes a buffer of bytes into a string.

Parameters

bytes Buffer to read bytes from.

Returns: String of decoded characters.

Reimplemented from System::Text::Encoding.

◆ GetString() [5/8]

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

virtual

Decodes a buffer of bytes into a string.

Parameters

bytes	Buffer to read bytes from.
index	Input buffer offset.
count	Input buffer size.

Returns: String of decoded characters.

Reimplemented from System::Text::Encoding.

◆ GetString() [6/8]

template<std::size_t N>

String System::Text::Encoding::GetString ( System::Details::StackArray< uint8_t, N > & bytes )

inline

Decodes a buffer of bytes into a string.

Parameters

bytes Buffer to read bytes from.

Returns: String of decoded characters.

◆ GetString() [7/8]

template<std::size_t N>

String System::Text::Encoding::GetString	(	System::Details::StackArray< uint8_t, N >	bytes,
		int	index,
		int	count
	)

inline

Decodes a buffer of bytes into a string.

Parameters

bytes	Buffer to read bytes from.
index	Input buffer offset.
count	Input buffer size.

Returns: String of decoded characters.

◆ GetString() [8/8]

virtual String System::Text::Encoding::GetString	(	uint8_t *	bytes,
		int	byte_count
	)

virtual

Decodes a buffer of bytes into a string.

Parameters

bytes	Buffer to read bytes from.
byte_count	Input buffer size.

Returns: String of decoded characters.

Reimplemented from System::Text::Encoding.

◆ operator==()

bool System::Text::UTF7Encoding::operator== ( const UTF7Encoding & other ) const

Compares encodings parameters.

Parameters

other Encoding to compare parameters with.

Returns: True if parameters match, false otherwise.

Member Data Documentation

◆ UTF7_CODE_PAGE

constexpr int System::Text::UTF7Encoding::UTF7_CODE_PAGE = 65000

staticconstexpr

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

Public Member Functions

Static Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ UTF7Encoding() [1/2]

◆ UTF7Encoding() [2/2]

Member Function Documentation

◆ Clone()

◆ Equals()

◆ GetByteCount() [1/7]

◆ GetByteCount() [2/7]

◆ GetByteCount() [3/7]

◆ GetByteCount() [4/7]

◆ GetByteCount() [5/7]

◆ GetByteCount() [6/7]

◆ GetByteCount() [7/7]

◆ GetBytes() [1/13]

◆ GetBytes() [2/13]

◆ GetBytes() [3/13]

◆ GetBytes() [4/13]

◆ GetBytes() [5/13]

◆ GetBytes() [6/13]

◆ GetBytes() [7/13]

◆ GetBytes() [8/13]

◆ GetBytes() [9/13]

◆ GetBytes() [10/13]

◆ GetBytes() [11/13]

◆ GetBytes() [12/13]

◆ GetBytes() [13/13]

◆ GetCharCount() [1/5]

◆ GetCharCount() [2/5]

◆ GetCharCount() [3/5]

◆ GetCharCount() [4/5]

◆ GetCharCount() [5/5]

◆ GetChars() [1/6]

◆ GetChars() [2/6]

◆ GetChars() [3/6]

◆ GetChars() [4/6]

◆ GetChars() [5/6]

◆ GetChars() [6/6]

◆ GetDecoder()

◆ GetEncoder()

◆ GetHashCode()

◆ GetMaxByteCount()

◆ GetMaxCharCount()

◆ GetString() [1/8]

◆ GetString() [2/8]

◆ GetString() [3/8]

◆ GetString() [4/8]

◆ GetString() [5/8]

◆ GetString() [6/8]

◆ GetString() [7/8]

◆ GetString() [8/8]

◆ operator==()

Member Data Documentation

◆ UTF7_CODE_PAGE