示例

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