niko
287 lines
18 KiB
C#
287 lines
18 KiB
C#
using System;
|
|
using System.Runtime.InteropServices;
|
|
|
|
namespace System.Text
|
|
{
|
|
/// <summary>Converts a set of characters into a sequence of bytes.</summary>
|
|
/// <filterpriority>1</filterpriority>
|
|
// Token: 0x020005E9 RID: 1513
|
|
[ComVisible(true)]
|
|
[Serializable]
|
|
public abstract class Encoder
|
|
{
|
|
/// <summary>Gets or sets a <see cref="T:System.Text.EncoderFallback" /> object for the current <see cref="T:System.Text.Encoder" /> object.</summary>
|
|
/// <returns>A <see cref="T:System.Text.EncoderFallback" /> object.</returns>
|
|
/// <exception cref="T:System.ArgumentNullException">The value in a set operation is null (Nothing).</exception>
|
|
/// <exception cref="T:System.ArgumentException">A new value cannot be assigned in a set operation because the current <see cref="T:System.Text.EncoderFallbackBuffer" /> object contains data that has not been encoded yet. </exception>
|
|
/// <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Understanding Encodings for fuller explanation)-and-<see cref="P:System.Text.Encoder.Fallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
|
|
/// <filterpriority>1</filterpriority>
|
|
// Token: 0x17000AC3 RID: 2755
|
|
// (get) Token: 0x0600370B RID: 14091 RVA: 0x000BCA54 File Offset: 0x000BAC54
|
|
// (set) Token: 0x0600370C RID: 14092 RVA: 0x000BCA5C File Offset: 0x000BAC5C
|
|
[ComVisible(false)]
|
|
public EncoderFallback Fallback
|
|
{
|
|
get
|
|
{
|
|
return this.fallback;
|
|
}
|
|
set
|
|
{
|
|
if (value == null)
|
|
{
|
|
throw new ArgumentNullException();
|
|
}
|
|
this.fallback = value;
|
|
this.fallback_buffer = null;
|
|
}
|
|
}
|
|
|
|
/// <summary>Gets the <see cref="T:System.Text.EncoderFallbackBuffer" /> object associated with the current <see cref="T:System.Text.Encoder" /> object.</summary>
|
|
/// <returns>A <see cref="T:System.Text.EncoderFallbackBuffer" /> object.</returns>
|
|
/// <filterpriority>1</filterpriority>
|
|
// Token: 0x17000AC4 RID: 2756
|
|
// (get) Token: 0x0600370D RID: 14093 RVA: 0x000BCA78 File Offset: 0x000BAC78
|
|
[ComVisible(false)]
|
|
public EncoderFallbackBuffer FallbackBuffer
|
|
{
|
|
get
|
|
{
|
|
if (this.fallback_buffer == null)
|
|
{
|
|
this.fallback_buffer = this.Fallback.CreateFallbackBuffer();
|
|
}
|
|
return this.fallback_buffer;
|
|
}
|
|
}
|
|
|
|
/// <summary>When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters from the specified character array. A parameter indicates whether to clear the internal state of the encoder after the calculation.</summary>
|
|
/// <returns>The number of bytes produced by encoding the specified characters and any characters in the internal buffer.</returns>
|
|
/// <param name="chars">The character array containing the set of characters to encode. </param>
|
|
/// <param name="index">The index of the first character to encode. </param>
|
|
/// <param name="count">The number of characters to encode. </param>
|
|
/// <param name="flush">true to simulate clearing the internal state of the encoder after the calculation; otherwise, false. </param>
|
|
/// <exception cref="T:System.ArgumentNullException">
|
|
/// <paramref name="chars" /> is null. </exception>
|
|
/// <exception cref="T:System.ArgumentOutOfRangeException">
|
|
/// <paramref name="index" /> or <paramref name="count" /> is less than zero.-or- <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />. </exception>
|
|
/// <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Understanding Encodings for fuller explanation)-and-<see cref="P:System.Text.Encoder.Fallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
|
|
/// <filterpriority>2</filterpriority>
|
|
// Token: 0x0600370E RID: 14094
|
|
public abstract int GetByteCount(char[] chars, int index, int count, bool flush);
|
|
|
|
/// <summary>When overridden in a derived class, encodes a set of characters from the specified character array and any characters in the internal buffer into the specified byte array. A parameter indicates whether to clear the internal state of the encoder after the conversion.</summary>
|
|
/// <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
|
|
/// <param name="chars">The character array containing the set of characters to encode. </param>
|
|
/// <param name="charIndex">The index of the first character to encode. </param>
|
|
/// <param name="charCount">The number of characters to encode. </param>
|
|
/// <param name="bytes">The byte array to contain the resulting sequence of bytes. </param>
|
|
/// <param name="byteIndex">The index at which to start writing the resulting sequence of bytes. </param>
|
|
/// <param name="flush">true to clear the internal state of the encoder after the conversion; otherwise, false. </param>
|
|
/// <exception cref="T:System.ArgumentNullException">
|
|
/// <paramref name="chars" /> is null (Nothing).-or- <paramref name="bytes" /> is null (Nothing). </exception>
|
|
/// <exception cref="T:System.ArgumentOutOfRangeException">
|
|
/// <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.-or- <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.-or- <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />. </exception>
|
|
/// <exception cref="T:System.ArgumentException">
|
|
/// <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes. </exception>
|
|
/// <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Understanding Encodings for fuller explanation)-and-<see cref="P:System.Text.Encoder.Fallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
|
|
/// <filterpriority>2</filterpriority>
|
|
// Token: 0x0600370F RID: 14095
|
|
public abstract int GetBytes(char[] chars, int charIndex, int charCount, byte[] bytes, int byteIndex, bool flush);
|
|
|
|
/// <summary>When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer. A parameter indicates whether to clear the internal state of the encoder after the calculation.</summary>
|
|
/// <returns>The number of bytes produced by encoding the specified characters and any characters in the internal buffer.</returns>
|
|
/// <param name="chars">A pointer to the first character to encode. </param>
|
|
/// <param name="count">The number of characters to encode. </param>
|
|
/// <param name="flush">true to simulate clearing the internal state of the encoder after the calculation; otherwise, false. </param>
|
|
/// <exception cref="T:System.ArgumentNullException">
|
|
/// <paramref name="chars" /> is null (Nothing in Visual Basic .NET). </exception>
|
|
/// <exception cref="T:System.ArgumentOutOfRangeException">
|
|
/// <paramref name="count" /> is less than zero. </exception>
|
|
/// <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Understanding Encodings for fuller explanation)-and-<see cref="P:System.Text.Encoder.Fallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
|
|
/// <filterpriority>2</filterpriority>
|
|
// Token: 0x06003710 RID: 14096 RVA: 0x000BCAA8 File Offset: 0x000BACA8
|
|
[ComVisible(false)]
|
|
[CLSCompliant(false)]
|
|
public unsafe virtual int GetByteCount(char* chars, int count, bool flush)
|
|
{
|
|
if (chars == null)
|
|
{
|
|
throw new ArgumentNullException("chars");
|
|
}
|
|
if (count < 0)
|
|
{
|
|
throw new ArgumentOutOfRangeException("count");
|
|
}
|
|
char[] array = new char[count];
|
|
Marshal.Copy((IntPtr)((void*)chars), array, 0, count);
|
|
return this.GetByteCount(array, 0, count, flush);
|
|
}
|
|
|
|
/// <summary>When overridden in a derived class, encodes a set of characters starting at the specified character pointer and any characters in the internal buffer into a sequence of bytes that are stored starting at the specified byte pointer. A parameter indicates whether to clear the internal state of the encoder after the conversion.</summary>
|
|
/// <returns>The actual number of bytes written at the location indicated by the <paramref name="bytes" /> parameter.</returns>
|
|
/// <param name="chars">A pointer to the first character to encode. </param>
|
|
/// <param name="charCount">The number of characters to encode. </param>
|
|
/// <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes. </param>
|
|
/// <param name="byteCount">The maximum number of bytes to write. </param>
|
|
/// <param name="flush">true to clear the internal state of the encoder after the conversion; otherwise, false. </param>
|
|
/// <exception cref="T:System.ArgumentNullException">
|
|
/// <paramref name="chars" /> is null (Nothing).-or- <paramref name="bytes" /> is null (Nothing). </exception>
|
|
/// <exception cref="T:System.ArgumentOutOfRangeException">
|
|
/// <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero. </exception>
|
|
/// <exception cref="T:System.ArgumentException">
|
|
/// <paramref name="byteCount" /> is less than the resulting number of bytes. </exception>
|
|
/// <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Understanding Encodings for fuller explanation)-and-<see cref="P:System.Text.Encoder.Fallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
|
|
/// <filterpriority>2</filterpriority>
|
|
// Token: 0x06003711 RID: 14097 RVA: 0x000BCAF8 File Offset: 0x000BACF8
|
|
[ComVisible(false)]
|
|
[CLSCompliant(false)]
|
|
public unsafe virtual int GetBytes(char* chars, int charCount, byte* bytes, int byteCount, bool flush)
|
|
{
|
|
this.CheckArguments(chars, charCount, bytes, byteCount);
|
|
char[] array = new char[charCount];
|
|
Marshal.Copy((IntPtr)((void*)chars), array, 0, charCount);
|
|
byte[] array2 = new byte[byteCount];
|
|
Marshal.Copy((IntPtr)((void*)bytes), array2, 0, byteCount);
|
|
return this.GetBytes(array, 0, charCount, array2, 0, flush);
|
|
}
|
|
|
|
/// <summary>When overridden in a derived class, sets the encoder back to its initial state.</summary>
|
|
/// <filterpriority>2</filterpriority>
|
|
// Token: 0x06003712 RID: 14098 RVA: 0x000BCB4C File Offset: 0x000BAD4C
|
|
[ComVisible(false)]
|
|
public virtual void Reset()
|
|
{
|
|
if (this.fallback_buffer != null)
|
|
{
|
|
this.fallback_buffer.Reset();
|
|
}
|
|
}
|
|
|
|
/// <summary>Converts a buffer of Unicode characters to an encoded byte sequence and stores the result in another buffer.</summary>
|
|
/// <param name="chars">The address of a string of UTF-16 encoded characters to convert.</param>
|
|
/// <param name="charCount">The number of characters in <paramref name="chars" /> to convert.</param>
|
|
/// <param name="bytes">The address of a buffer to store the converted bytes.</param>
|
|
/// <param name="byteCount">The maximum number of bytes in <paramref name="bytes" /> to use in the conversion.</param>
|
|
/// <param name="flush">true to indicate no further data is to be converted; otherwise, false.</param>
|
|
/// <param name="charsUsed">When this method returns, contains the number of characters from <paramref name="chars" /> that were used in the conversion. This parameter is passed uninitialized.</param>
|
|
/// <param name="bytesUsed">When this method returns, contains the number of bytes that were used in the conversion. This parameter is passed uninitialized.</param>
|
|
/// <param name="completed">When this method returns, contains true if all the characters specified by <paramref name="charCount" /> were converted; otherwise, false. This parameter is passed uninitialized.</param>
|
|
/// <exception cref="T:System.ArgumentNullException">
|
|
/// <paramref name="chars" /> or <paramref name="bytes" /> is null (Nothing).</exception>
|
|
/// <exception cref="T:System.ArgumentOutOfRangeException">
|
|
/// <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
|
|
/// <exception cref="T:System.ArgumentException">The output buffer is too small to contain any of the converted input. The output buffer should be greater than or equal to the size indicated by the <see cref="Overload:System.Text.Encoder.GetByteCount" /> method.</exception>
|
|
/// <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Understanding Encodings for fuller explanation)-and-<see cref="P:System.Text.Encoder.Fallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
|
|
/// <filterpriority>2</filterpriority>
|
|
// Token: 0x06003713 RID: 14099 RVA: 0x000BCB64 File Offset: 0x000BAD64
|
|
[ComVisible(false)]
|
|
[CLSCompliant(false)]
|
|
public unsafe virtual void Convert(char* chars, int charCount, byte* bytes, int byteCount, bool flush, out int charsUsed, out int bytesUsed, out bool completed)
|
|
{
|
|
this.CheckArguments(chars, charCount, bytes, byteCount);
|
|
charsUsed = charCount;
|
|
for (;;)
|
|
{
|
|
bytesUsed = this.GetByteCount(chars, charsUsed, flush);
|
|
if (bytesUsed <= byteCount)
|
|
{
|
|
break;
|
|
}
|
|
flush = false;
|
|
charsUsed >>= 1;
|
|
}
|
|
completed = charsUsed == charCount;
|
|
bytesUsed = this.GetBytes(chars, charsUsed, bytes, byteCount, flush);
|
|
}
|
|
|
|
/// <summary>Converts an array of Unicode characters to an encoded byte sequence and stores the result in an array of bytes.</summary>
|
|
/// <param name="chars">An array of characters to convert.</param>
|
|
/// <param name="charIndex">The first element of <paramref name="chars" /> to convert.</param>
|
|
/// <param name="charCount">The number of elements of <paramref name="chars" /> to convert.</param>
|
|
/// <param name="bytes">An array where the converted bytes are stored.</param>
|
|
/// <param name="byteIndex">The first element of <paramref name="bytes" /> in which data is stored.</param>
|
|
/// <param name="byteCount">The maximum number of elements of <paramref name="bytes" /> to use in the conversion.</param>
|
|
/// <param name="flush">true to indicate no further data is to be converted; otherwise, false.</param>
|
|
/// <param name="charsUsed">When this method returns, contains the number of characters from <paramref name="chars" /> that were used in the conversion. This parameter is passed uninitialized.</param>
|
|
/// <param name="bytesUsed">When this method returns, contains the number of bytes that were produced by the conversion. This parameter is passed uninitialized.</param>
|
|
/// <param name="completed">When this method returns, contains true if all the characters specified by <paramref name="charCount" /> were converted; otherwise, false. This parameter is passed uninitialized.</param>
|
|
/// <exception cref="T:System.ArgumentNullException">
|
|
/// <paramref name="chars" /> or <paramref name="bytes" /> is null (Nothing).</exception>
|
|
/// <exception cref="T:System.ArgumentOutOfRangeException">
|
|
/// <paramref name="charIndex" />, <paramref name="charCount" />, <paramref name="byteIndex" />, or <paramref name="byteCount" /> is less than zero.-or-The length of <paramref name="chars" /> - <paramref name="charIndex" /> is less than <paramref name="charCount" />.-or-The length of <paramref name="bytes" /> - <paramref name="byteIndex" /> is less than <paramref name="byteCount" />.</exception>
|
|
/// <exception cref="T:System.ArgumentException">The output buffer is too small to contain any of the converted input. The output buffer should be greater than or equal to the size indicated by the <see cref="Overload:System.Text.Encoder.GetByteCount" /> method.</exception>
|
|
/// <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Understanding Encodings for fuller explanation)-and-<see cref="P:System.Text.Encoder.Fallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
|
|
/// <filterpriority>2</filterpriority>
|
|
// Token: 0x06003714 RID: 14100 RVA: 0x000BCBCC File Offset: 0x000BADCC
|
|
[ComVisible(false)]
|
|
public virtual void Convert(char[] chars, int charIndex, int charCount, byte[] bytes, int byteIndex, int byteCount, bool flush, out int charsUsed, out int bytesUsed, out bool completed)
|
|
{
|
|
if (chars == null)
|
|
{
|
|
throw new ArgumentNullException("chars");
|
|
}
|
|
if (bytes == null)
|
|
{
|
|
throw new ArgumentNullException("bytes");
|
|
}
|
|
if (charIndex < 0 || chars.Length <= charIndex)
|
|
{
|
|
throw new ArgumentOutOfRangeException("charIndex");
|
|
}
|
|
if (charCount < 0 || chars.Length < charIndex + charCount)
|
|
{
|
|
throw new ArgumentOutOfRangeException("charCount");
|
|
}
|
|
if (byteIndex < 0 || bytes.Length <= byteIndex)
|
|
{
|
|
throw new ArgumentOutOfRangeException("byteIndex");
|
|
}
|
|
if (byteCount < 0 || bytes.Length < byteIndex + byteCount)
|
|
{
|
|
throw new ArgumentOutOfRangeException("byteCount");
|
|
}
|
|
charsUsed = charCount;
|
|
for (;;)
|
|
{
|
|
bytesUsed = this.GetByteCount(chars, charIndex, charsUsed, flush);
|
|
if (bytesUsed <= byteCount)
|
|
{
|
|
break;
|
|
}
|
|
flush = false;
|
|
charsUsed >>= 1;
|
|
}
|
|
completed = charsUsed == charCount;
|
|
bytesUsed = this.GetBytes(chars, charIndex, charsUsed, bytes, byteIndex, flush);
|
|
}
|
|
|
|
// Token: 0x06003715 RID: 14101 RVA: 0x000BCCC4 File Offset: 0x000BAEC4
|
|
private unsafe void CheckArguments(char* chars, int charCount, byte* bytes, int byteCount)
|
|
{
|
|
if (chars == null)
|
|
{
|
|
throw new ArgumentNullException("chars");
|
|
}
|
|
if (bytes == null)
|
|
{
|
|
throw new ArgumentNullException("bytes");
|
|
}
|
|
if (charCount < 0)
|
|
{
|
|
throw new ArgumentOutOfRangeException("charCount");
|
|
}
|
|
if (byteCount < 0)
|
|
{
|
|
throw new ArgumentOutOfRangeException("byteCount");
|
|
}
|
|
}
|
|
|
|
// Token: 0x04001676 RID: 5750
|
|
private EncoderFallback fallback = new EncoderReplacementFallback();
|
|
|
|
// Token: 0x04001677 RID: 5751
|
|
private EncoderFallbackBuffer fallback_buffer;
|
|
}
|
|
}
|