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