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

정의

네임스페이스:
System.Text
어셈블리:
System.Runtime.dll
Source:
Rune.cs
Source:
Rune.cs
Source:
Rune.cs
Source:
Rune.cs
Source:
Rune.cs

제공된 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

이 메서드가 반환되면 룬을 만들기 위해 읽은 문자 수가 반환됩니다.

반품

OperationStatus

Done 원본 버퍼가 유효한 UTF-16으로 인코딩된 스칼라 값으로 시작하는 경우 result그런 다음 디코딩된 RunecharsConsumed 값을 포함하고 입력 버퍼에서 인코딩Rune하는 데 사용되는 값 수를 Char 포함합니다.

NeedMoreData 원본 버퍼가 비어 있거나 독립 실행형 UTF-16 상위 서로게이트 문자만 포함하면 입니다. result 에는 ReplacementChar입력 버퍼의 길이가 포함됩니다 charsConsumed .

InvalidData 원본 버퍼가 잘못된 형식의 UTF-16으로 인코딩된 스칼라 값으로 시작하는 경우 result는 ReplacementCharcharsConsumed 잘못된 형식의 시퀀스를 인코딩하는 데 사용되는 값 수를 Char 포함합니다. .

설명

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

적용 대상