Utf8.ToUtf16 メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
UTF-8 でエンコードされた読み取り専用バイト スパンを UTF-16 でエンコードされた文字スパンに変換します。
public static System.Buffers.OperationStatus ToUtf16(ReadOnlySpan<byte> source, Span<char> destination, out int bytesRead, out int charsWritten, bool replaceInvalidSequences = true, bool isFinalBlock = true);static member ToUtf16 : ReadOnlySpan<byte> * Span<char> * int * int * bool * bool -> System.Buffers.OperationStatusPublic Shared Function ToUtf16 (source As ReadOnlySpan(Of Byte), destination As Span(Of Char), ByRef bytesRead As Integer, ByRef charsWritten As Integer, Optional replaceInvalidSequences As Boolean = true, Optional isFinalBlock As Boolean = true) As OperationStatusパラメーター
- source
- ReadOnlySpan<Byte>
UTF-8 でエンコードされた読み取り専用バイト スパン。
- bytesRead
- Int32
メソッドから制御が戻るときに、 sourceから読み取られたバイト数。
- charsWritten
- Int32
メソッドから制御が戻るときに、 destinationに書き込まれた文字数。
- replaceInvalidSequences
- Boolean
true
sourceの無効な UTF-8 シーケンスを U+FFFD に置き換える場合は 、sourceで無効な文字が見つかった場合にInvalidDataを返false。
- isFinalBlock
- Boolean
true メソッドが NeedMoreDataを返す必要がない場合は false。それ以外の場合は。
返品
変換の状態を示す値。
注釈
このメソッドは UTF8Encoding.GetChars メソッドに対応します。ただし、呼び出し規則、エラー処理メカニズム、パフォーマンス特性が異なる点が異なります。
'replaceInvalidSequences' が true場合、このメソッドは、 source の形式が正しくなっていないサブシーケンスを、 destination の U+FFFD に置き換え、バッファーの残りの処理を続行します。 それ以外の場合、メソッドは、形式が不適切なシーケンスが発生した場合に OperationStatus.InvalidData を返します。
メソッドがエラー コードを返す場合、out パラメーターはデータのトランスコードが成功した量を示し、不適切な形式のサブシーケンスの場所をこれらの値から推測できます。
'replaceInvalidSequences' が true場合、メソッドは OperationStatus.InvalidDataを返しません。 'isFinalBlock' が true場合、メソッドは OperationStatus.NeedMoreDataを返しません。
