Base64Url.DecodeFromUtf8 メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| DecodeFromUtf8(ReadOnlySpan<Byte>) |
Base64Url として表される UTF-8 でエンコードされたテキストのスパンをバイナリ データにデコードします。 |
| DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>) |
Base64Url として表される UTF-8 でエンコードされたテキストのスパンをバイナリ データにデコードします。 |
| DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>, Int32, Int32, Boolean) |
Base64Url として表される UTF-8 でエンコードされたテキストのスパンをバイナリ データにデコードします。 |
DecodeFromUtf8(ReadOnlySpan<Byte>)
Base64Url として表される UTF-8 でエンコードされたテキストのスパンをバイナリ データにデコードします。
public:
static cli::array <System::Byte> ^ DecodeFromUtf8(ReadOnlySpan<System::Byte> source);public static byte[] DecodeFromUtf8(ReadOnlySpan<byte> source);static member DecodeFromUtf8 : ReadOnlySpan<byte> -> byte[]Public Shared Function DecodeFromUtf8 (source As ReadOnlySpan(Of Byte)) As Byte()パラメーター
- source
- ReadOnlySpan<Byte>
デコードする必要がある Base64Url に UTF-8 でエンコードされたテキストを含む入力スパン。
戻り値
>デコード操作の結果を含むバイト配列です。
例外
適用対象
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>)
Base64Url として表される UTF-8 でエンコードされたテキストのスパンをバイナリ データにデコードします。
public:
static int DecodeFromUtf8(ReadOnlySpan<System::Byte> source, Span<System::Byte> destination);public static int DecodeFromUtf8(ReadOnlySpan<byte> source, Span<byte> destination);static member DecodeFromUtf8 : ReadOnlySpan<byte> * Span<byte> -> intPublic Shared Function DecodeFromUtf8 (source As ReadOnlySpan(Of Byte), destination As Span(Of Byte)) As Integerパラメーター
- source
- ReadOnlySpan<Byte>
デコードする必要がある Base64Url に UTF-8 でエンコードされたテキストを含む入力スパン。
戻り値
destinationに書き込まれたバイト数。 これは、必要に応じて、後続の呼び出しの出力をスライスするために使用できます。
例外
destination 内のバッファーが小さすぎて、エンコードされた出力を保持できません。
注釈
Base64Url のパディングは省略可能であるため、source の長さは 4 の倍数である必要はありません。
source の長さが 4 の倍数でない場合、剰余はそれに応じてデコードされます。
- 残りの 3 バイト - 2 バイトのデータにデコードされ、デコードに成功します。
- 2 バイトの剰余 - 1 バイトのデータにデコードされます。 デコードは成功します。
- 1 バイトの剰余 - 無効な入力であるため、FormatException が発生します。
適用対象
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>, Int32, Int32, Boolean)
Base64Url として表される UTF-8 でエンコードされたテキストのスパンをバイナリ データにデコードします。
public static System.Buffers.OperationStatus DecodeFromUtf8(ReadOnlySpan<byte> source, Span<byte> destination, out int bytesConsumed, out int bytesWritten, bool isFinalBlock = true);static member DecodeFromUtf8 : ReadOnlySpan<byte> * Span<byte> * int * int * bool -> System.Buffers.OperationStatusPublic Shared Function DecodeFromUtf8 (source As ReadOnlySpan(Of Byte), destination As Span(Of Byte), ByRef bytesConsumed As Integer, ByRef bytesWritten As Integer, Optional isFinalBlock As Boolean = true) As OperationStatusパラメーター
- source
- ReadOnlySpan<Byte>
デコードする必要がある Base64Url に UTF-8 でエンコードされたテキストを含む入力スパン。
- bytesConsumed
- Int32
このメソッドから制御が戻るときに、操作中に使用された入力バイト数が格納されます。 これは、必要に応じて、後続の呼び出しの入力をスライスするために使用できます。 このパラメーターは、初期化されていないものとして扱われます。
- bytesWritten
- Int32
このメソッドから制御が戻るときに、出力スパンに書き込まれたバイト数が格納されます。 これは、必要に応じて、後続の呼び出しの出力をスライスするために使用できます。 このパラメーターは、初期化されていないものとして扱われます。
- isFinalBlock
- Boolean
入力スパンにエンコードするデータ全体が含まれている場合に true します。false データが増える可能性がある場合は、
ループ内で呼び出す場合などです。
false を使用した呼び出しは、このパラメーターが呼び出し true 別の呼び出しでフォローアップする必要があります。 既定値は trueです。
戻り値
操作の成功または失敗を示す列挙値の 1 つ。
注釈
Base64Url のパディングは省略可能であるため、isFinalBlock が trueされている場合でも、source の長さは 4 の倍数である必要はありません。
source の長さが 4 の倍数ではなく、isFinalBlock がそれに応じてデコードされた剰余 true 場合:
- 残りの 3 バイト - 2 バイトのデータにデコードされ、デコードに成功します。
- 2 バイトの剰余 - 1 バイトのデータにデコードされます。 デコードは成功します。
- 残りの 1 バイト - OperationStatus.InvalidData の結果が発生します。
