ASCIIEncoding.GetCharCount Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Calculates the number of characters produced by decoding a sequence of bytes.
GetCharCount(Byte*, Int32) |
Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer. |
GetCharCount(Byte[], Int32, Int32) |
Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array. |
GetCharCount(ReadOnlySpan<Byte>) |
Calculates the number of characters produced by decoding the specified byte span. |
- Source:
- ASCIIEncoding.cs
- Source:
- ASCIIEncoding.cs
- Source:
- ASCIIEncoding.cs
Important
This API is not CLS-compliant.
- CLS-compliant alternative
- System.Text.ASCIIEncoding.GetCharCount(Byte[], Int32, Int32)
Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.
public:
override int GetCharCount(System::Byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetCharCount (byte* bytes, int count);
[System.CLSCompliant(false)]
public override int GetCharCount (byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount (byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount (byte* bytes, int count);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int
Parameters
- bytes
- Byte*
A pointer to the first byte to decode.
- count
- Int32
The number of bytes to decode.
Returns
The number of characters produced by decoding the specified sequence of bytes.
- Attributes
Exceptions
bytes
is null
.
count
is less than zero.
-or-
The resulting number of bytes is greater than the maximum number that can be returned as an integer.
A fallback occurred (for more information, see Character Encoding in .NET)
-and-
DecoderFallback is set to DecoderExceptionFallback.
Remarks
To calculate the exact array size required by GetChars to store the resulting characters, the application uses GetCharCount. To calculate the maximum array size, the application should use GetMaxCharCount. The GetCharCount method generally allows allocation of less memory, while the GetMaxCharCount method generally executes faster.
See also
Applies to
.NET 9 a ďalšie verzie
Produkt | Verzie |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
- Source:
- ASCIIEncoding.cs
- Source:
- ASCIIEncoding.cs
- Source:
- ASCIIEncoding.cs
Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.
public:
override int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);
public override int GetCharCount (byte[] bytes, int index, int count);
override this.GetCharCount : byte[] * int * int -> int
Public Overrides Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As Integer
Parameters
- bytes
- Byte[]
The byte array containing the sequence of bytes to decode.
- index
- Int32
The index of the first byte to decode.
- count
- Int32
The number of bytes to decode.
Returns
The number of characters produced by decoding the specified sequence of bytes.
Exceptions
bytes
is null
.
index
or count
is less than zero.
-or-
index
and count
do not denote a valid range in bytes
.
-or-
The resulting number of bytes is greater than the maximum number that can be returned as an integer.
A fallback occurred (for more information, see Character Encoding in .NET)
-and-
DecoderFallback is set to DecoderExceptionFallback.
Examples
The following example demonstrates how to use the GetCharCount method to return the number of characters produced by decoding a range of elements in a byte array.
using namespace System;
using namespace System::Text;
int main()
{
array<Byte>^bytes = {65,83,67,73,73,32,69,110,99,111,100,105,110,103,32,69,120,97,109,112,108,101};
ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
int charCount = ascii->GetCharCount( bytes, 6, 8 );
Console::WriteLine( "{0} characters needed to decode bytes.", charCount );
}
using System;
using System.Text;
class ASCIIEncodingExample {
public static void Main() {
Byte[] bytes = new Byte[] {
65, 83, 67, 73, 73, 32, 69,
110, 99, 111, 100, 105, 110, 103,
32, 69, 120, 97, 109, 112, 108, 101
};
ASCIIEncoding ascii = new ASCIIEncoding();
int charCount = ascii.GetCharCount(bytes, 6, 8);
Console.WriteLine(
"{0} characters needed to decode bytes.", charCount
);
}
}
Imports System.Text
Class ASCIIEncodingExample
Public Shared Sub Main()
Dim bytes() As Byte = { _
65, 83, 67, 73, 73, 32, 69, _
110, 99, 111, 100, 105, 110, 103, _
32, 69, 120, 97, 109, 112, 108, 101}
Dim ascii As New ASCIIEncoding()
Dim charCount As Integer = ascii.GetCharCount(bytes, 6, 8)
Console.WriteLine("{0} characters needed to decode bytes.", charCount)
End Sub
End Class
Remarks
To calculate the exact array size required by GetChars to store the resulting characters, the application uses GetCharCount. To calculate the maximum array size, the application should use GetMaxCharCount. The GetCharCount method generally allows allocation of less memory, while the GetMaxCharCount method generally executes faster.
See also
Applies to
.NET 9 a ďalšie verzie
Produkt | Verzie |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
- Source:
- ASCIIEncoding.cs
- Source:
- ASCIIEncoding.cs
- Source:
- ASCIIEncoding.cs
Calculates the number of characters produced by decoding the specified byte span.
public:
override int GetCharCount(ReadOnlySpan<System::Byte> bytes);
public override int GetCharCount (ReadOnlySpan<byte> bytes);
override this.GetCharCount : ReadOnlySpan<byte> -> int
Public Overrides Function GetCharCount (bytes As ReadOnlySpan(Of Byte)) As Integer
Parameters
- bytes
- ReadOnlySpan<Byte>
The span containing the set of bytes to decode.
Returns
The number of characters produced by decoding the specified byte span.
Remarks
To calculate the exact size required by GetChars to store the resulting characters, use GetCharCount. To calculate the maximum size, use GetMaxCharCount. The GetCharCount method generally allows allocation of less memory, while the GetMaxCharCount method generally executes faster.
Applies to
.NET 9 a ďalšie verzie
Produkt | Verzie |
---|---|
.NET | Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
Pripomienky k produktu .NET
.NET je open-source projekt. Ak chcete poskytnúť pripomienky, vyberte prepojenie: