Utf8.ToUtf16 메서드

정의

네임스페이스:
System.Text.Unicode
어셈블리:
System.Runtime.dll
어셈블리:
Microsoft.Bcl.Memory.dll
패키지:
Microsoft.Bcl.Memory v11.0.0-preview.5.26302.115
Source:
Utf8.cs
Source:
Utf8.cs
Source:
Utf8.cs
Source:
Utf8.cs
Source:
Utf8.cs

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.OperationStatus
Public 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로 인코딩된 읽기 전용 바이트 범위입니다.

destination
Span<Char>

UTF-16으로 인코딩된 문자 범위입니다.

bytesRead
Int32

메서드가 반환되면 읽은 바이트 수입니다 source.

charsWritten
Int32

메서드가 반환되면 에 기록된 문자 수입니다 destination.

replaceInvalidSequences
Boolean

true잘못된 UTF-8 시퀀스를 source U+FFFD false 로 바꾸려면 ,에 source잘못된 문자가 있으면 반환 InvalidData 합니다.

isFinalBlock
Boolean

메서드가 반환 하지 않아야 하면 이고, 그렇지 않으면 .입니다.

반품

OperationStatus

변환 상태를 나타내는 값입니다.

설명

이 메서드는 다른 호출 규칙, 다른 오류 처리 메커니즘 및 다른 성능 특성을 가지고 있다는 점을 제외하고 UTF8Encoding.GetChars 메서드에 해당합니다.

'replaceInvalidSequences'인 경우 메서드는 true잘못된 형식의 하위 시퀀스를 source U+FFFD destination 로 바꾸고 버퍼의 나머지 부분을 계속 처리합니다. 그렇지 않으면 잘못된 형식의 시퀀스가 발견되면 메서드가 반환 OperationStatus.InvalidData 됩니다.

메서드가 오류 코드를 반환하는 경우 out 매개 변수는 성공적으로 트랜스코딩된 데이터의 양을 나타내며 잘못된 형식의 하위 시퀀스의 위치를 이러한 값에서 추론할 수 있습니다.

'replaceInvalidSequences' true이면 메서드는 반환 OperationStatus.InvalidData되지 않습니다. 'isFinalBlock'이 true면 메서드가 반환 OperationStatus.NeedMoreData되지 않습니다.

적용 대상