Bahasa

Utf8.FromUtf16 Metode

Definisi

Mengonversi rentang karakter UTF-16 ke rentang byte yang dikodekan 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.OperationStatus
Public 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

Parameter

source
ReadOnlySpan<Char>

Rentang karakter baca-saja yang dikodekan UTF-16.

destination
Span<Byte>

Rentang byte yang dikodekan UTF-8.

charsRead
Int32

Saat metode kembali, jumlah karakter yang dibaca dari source.

bytesWritten
Int32

Ketika metode kembali, jumlah byte yang ditulis ke destination.

replaceInvalidSequences
Boolean

true untuk mengganti urutan UTF-16 yang tidak valid dengan source U+FFFD; false untuk mengembalikan InvalidData jika karakter yang tidak valid ditemukan di source.

isFinalBlock
Boolean

true jika metode tidak boleh mengembalikan NeedMoreData; jika tidak, false.

Mengembalikan

Nilai yang menunjukkan status konversi.

Keterangan

Metode ini sesuai dengan metode UTF8Encoding.GetBytes , kecuali bahwa metode ini memiliki konvensi panggilan yang berbeda, mekanisme penanganan kesalahan yang berbeda, dan karakteristik performa yang berbeda.

Jika 'replaceInvalidSequences' adalah true, metode menggantikan subsekuensi source yang tidak terbentuk dengan U+FFFD di destination dan terus memproses sisa buffer. Jika tidak, metode mengembalikan OperationStatus.InvalidData jika mengalami urutan yang tidak terbentuk.

Jika metode mengembalikan kode kesalahan, parameter keluar menunjukkan berapa banyak data yang berhasil ditranskodekan, dan lokasi subsekuensi yang tidak terbentuk dapat disimpulkan dari nilai-nilai ini.

Jika 'replaceInvalidSequences' adalah true, metode tidak pernah mengembalikan OperationStatus.InvalidData. Jika 'isFinalBlock' adalah true, metode tidak pernah mengembalikan OperationStatus.NeedMoreData.

Berlaku untuk