Ask Learn
Preview
Ask Learn is an AI assistant that can answer questions, clarify concepts, and define terms using trusted Microsoft documentation.
Please sign in to use Ask Learn.
Sign inEncodingExtensions.GetChars Method
Definition
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.
Overloads
| GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>) |
Decodes the specified ReadOnlySequence<T> to |
| GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>) |
Decodes the specified ReadOnlySequence<T> to |
| GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>) |
Decodes the specified ReadOnlySpan<T> to |
- Source:
- EncodingExtensions.cs
- Source:
- EncodingExtensions.cs
- Source:
- EncodingExtensions.cs
- Source:
- EncodingExtensions.cs
Decodes the specified ReadOnlySequence<T> to chars using the specified Encoding and writes the result to writer.
public:
[System::Runtime::CompilerServices::Extension]
static long GetChars(System::Text::Encoding ^ encoding, System::Buffers::ReadOnlySequence<System::Byte> % bytes, System::Buffers::IBufferWriter<char> ^ writer);public static long GetChars(this System.Text.Encoding encoding, in System.Buffers.ReadOnlySequence<byte> bytes, System.Buffers.IBufferWriter<char> writer);static member GetChars : System.Text.Encoding * ReadOnlySequence * System.Buffers.IBufferWriter<char> -> int64<Extension()>
Public Function GetChars (encoding As Encoding, ByRef bytes As ReadOnlySequence(Of Byte), writer As IBufferWriter(Of Char)) As LongParameters
- encoding
- Encoding
The encoding that represents how the data in bytes should be decoded.
- bytes
- ReadOnlySequence<Byte>
The sequence whose bytes should be decoded.
- writer
- IBufferWriter<Char>
The buffer to which the decoded chars will be written.
Returns
The number of chars written to writer.
Exceptions
bytes contains data that cannot be decoded and encoding is configured to throw when such data is seen.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | 5, 6, 7, 8, 9, 10 |
- Source:
- EncodingExtensions.cs
- Source:
- EncodingExtensions.cs
- Source:
- EncodingExtensions.cs
- Source:
- EncodingExtensions.cs
Decodes the specified ReadOnlySequence<T> to chars using the specified Encoding and outputs the result to chars.
public:
[System::Runtime::CompilerServices::Extension]
static int GetChars(System::Text::Encoding ^ encoding, System::Buffers::ReadOnlySequence<System::Byte> % bytes, Span<char> chars);public static int GetChars(this System.Text.Encoding encoding, in System.Buffers.ReadOnlySequence<byte> bytes, Span<char> chars);static member GetChars : System.Text.Encoding * ReadOnlySequence * Span<char> -> int<Extension()>
Public Function GetChars (encoding As Encoding, ByRef bytes As ReadOnlySequence(Of Byte), chars As Span(Of Char)) As IntegerParameters
- encoding
- Encoding
The encoding that represents how the data in bytes is encoded.
- bytes
- ReadOnlySequence<Byte>
The sequence to decode to characters.
Returns
The number of chars written to chars.
Exceptions
chars is not large enough to contain the encoded form of bytes.
bytes contains data that cannot be decoded and encoding is configured to throw when such data is seen.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | 5, 6, 7, 8, 9, 10 |
- Source:
- EncodingExtensions.cs
- Source:
- EncodingExtensions.cs
- Source:
- EncodingExtensions.cs
- Source:
- EncodingExtensions.cs
Decodes the specified ReadOnlySpan<T> to chars using the specified Encoding and writes the result to writer.
public:
[System::Runtime::CompilerServices::Extension]
static long GetChars(System::Text::Encoding ^ encoding, ReadOnlySpan<System::Byte> bytes, System::Buffers::IBufferWriter<char> ^ writer);public static long GetChars(this System.Text.Encoding encoding, ReadOnlySpan<byte> bytes, System.Buffers.IBufferWriter<char> writer);static member GetChars : System.Text.Encoding * ReadOnlySpan<byte> * System.Buffers.IBufferWriter<char> -> int64<Extension()>
Public Function GetChars (encoding As Encoding, bytes As ReadOnlySpan(Of Byte), writer As IBufferWriter(Of Char)) As LongParameters
- encoding
- Encoding
The encoding that represents how the data in bytes should be decoded.
- bytes
- ReadOnlySpan<Byte>
The span of bytes to decode.
- writer
- IBufferWriter<Char>
The buffer to which the decoded chars will be written.
Returns
The number of chars written to writer.
Exceptions
bytes contains data that cannot be decoded and encoding is configured to throw when such data is seen.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | 5, 6, 7, 8, 9, 10 |