Rune.DecodeFromUtf16(ReadOnlySpan<Char>, Rune, Int32) 메서드

정의

네임스페이스:

System.Text

어셈블리:

System.Runtime.dll

제공된 UTF-16 소스 버퍼의 시작 부분에서 Rune을 디코딩합니다.

public:
 static System::Buffers::OperationStatus DecodeFromUtf16(ReadOnlySpan<char> source, [Runtime::InteropServices::Out] System::Text::Rune % result, [Runtime::InteropServices::Out] int % charsConsumed);

public static System.Buffers.OperationStatus DecodeFromUtf16 (ReadOnlySpan<char> source, out System.Text.Rune result, out int charsConsumed);

static member DecodeFromUtf16 : ReadOnlySpan<char> * Rune * int -> System.Buffers.OperationStatus

Public Shared Function DecodeFromUtf16 (source As ReadOnlySpan(Of Char), ByRef result As Rune, ByRef charsConsumed As Integer) As OperationStatus

매개 변수

source

ReadOnlySpan<Char>

읽기 전용 UTF-16 문자 범위입니다.

result

Rune

메서드가 반환되면 디코딩된 rune입니다.

charsConsumed

Int32

메서드가 반환될 때 rune을 만들기 위해 읽은 문자 수입니다.

반환

OperationStatus

소스 버퍼가 올바른 UTF-16 인코딩 스칼라 값으로 시작하는 경우 Done입니다. 그러면 result에 디코딩된 Rune이 포함되고 charsConsumed에는 Rune을 인코딩하기 위해 입력 버퍼에서 사용한 Char 값의 수가 포함됩니다.

소스 버퍼가 비어 있거나 독립형 UTF-16 상위 서로게이트 문자가 포함되어 있으면 NeedMoreData입니다. 그러면 result에는 ReplacementChar이 포함되고 charsConsumed에는 입력 버퍼의 길이가 포함됩니다.

소스 버퍼가 형식이 잘못된 UTF-16 인코딩 스칼라 값으로 시작되면 InvalidData입니다. 그러면 result에는 ReplacementChar이 포함되고 charsConsumed에는 형식이 잘못된 시퀀스를 인코딩하는 데 사용한 Char 값의 수가 포함되어 있습니다. .

설명

일반적인 규칙은 루프의 각 반복에서 요소별로 charsConsumed 버퍼를 조각화하여 루프에서 이 메서드를 호출하는 source 것입니다. 루프 result 의 각 반복에서 데이터가 성공적으로 디코딩되었거나 데이터가 성공적으로 디코딩되지 않은 경우 실제 스칼라 값을 포함합니다 Rune.ReplacementChar . 이 패턴은 루프를 반복하는 동안 잘못된 시퀀스의 편리한 자동 U+FFFD 대체를 제공합니다.