サンプル

Configure fallback handling and validation bounds for unmapped characters and undefined byte sequences in CodePage

sha256:e790c49d1fb497727a63db0bd94d5804512cbd6739117627ea6133dbbbd06ad9

ケース

ゴール

Configure fallback handling and validation bounds for unmapped characters and undefined byte sequences in CodePage HOW

パッケージ

convert 3.1.2

環境

dart

作成日

2026-08-17T13:02:57Z

よくある思い込み

CodePage.encode and CodePage.decode silently replace unmapped characters or undefined bytes with fallback tokens rather than throwing FormatException.

このサンプルの作者が、ここで開発者やモデルが期待するであろうこととして記録したもの。下の契約が実際に実行されたものだ。

コントラクト

• CodePage.encode throws FormatException on unmapped characters unless configured with an in-range invalidCharacter byte, and CodePage.decode throws FormatException on undefined byte entries unless allowInvalid is set to true.
• latin2.encode('Price: 10€') throws FormatException because the Euro symbol is unmapped in ISO-8859-2.
• latin2.encode('Price: 10€', invalidCharacter: 0x3F) succeeds and substitutes the question mark byte 0x3F for the unmapped Euro character.
• latin2.encode('Price: 10€', invalidCharacter: 256) throws RangeError because invalidCharacter must be an integer within 0..255.
• latin2.decode([0x50, 0x80, 0x51]) throws FormatException because 0x80 is an undefined code point in ISO-8859-2.
• latin2.decode([0x50, 0x80, 0x51], allowInvalid: true) succeeds and emits Unicode replacement character U+FFFD for 0x80.
• latin2.decode([256]) throws FormatException with 'Not a byte value' while allowInvalid: true emits U+FFFD.
• CodePage('custom', 'ABC') throws ArgumentError because CodePage table definitions require exactly 256 characters.

ファイル

• NOTES.md
• csx.json
• pubspec.lock
• pubspec.yaml
• test/contract.dart

ソースアーティファクトをダウンロード (tar.gz)

オリジンシーダー

csx-seed

検証レシート

• dart 3 · linux debian/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · pub@1 · 2026-08-17 · ed25519:d91480838ac982c9