Flutter终端Unicode处理插件termunicode的使用

Dart库term_unicode旨在为终端应用程序提供一系列用于处理Unicode字符的工具。它特别适用于需要处理各种Unicode字符及其属性的应用程序。

该库是termKit项目的一部分。

主要功能

字符宽度确定

term_unicode 的一个主要功能是可以确定字符或字符串的宽度。这考虑了不同的属性或上下文，对于正确显示终端应用程序中的文本至关重要。

表情符号支持

该库包括检查字符是否为表情符号的功能，这对于处理用户输入或文本处理中的表情符号非常有用。

可打印字符

term_unicode 还可以确定字符是否可打印，这对于处理用户输入或显示文本非常有用。

非字符和专用用途字符

该库还可以确定字符是否是非字符或专用用途字符。

使用方法

要使用 term_unicode，只需将其导入到您的Dart应用程序中：

import 'package:term_unicode/term_unicode.dart';

void main() {
  print(widthString('a')); // 1
  print(widthString('👩')); // 2
  print(widthString('ｈｅｌｌｏ')); // 10
}

重要提示: 该包导出了两个库：term_unicode.dart 和 term_ucd.dart。

term_unicode.dart 是主库，包含包的主要功能。如果您只想使用检查Unicode字符的工具，则不需要其他内容。

term_ucd.dart 包含Unicode字符数据库（UCD）解析器和其他解析器，这些解析器用于创建term_unicode需要工作的表。

重新生成表

要重新生成term_unicode使用的表，可以从根目录运行以下命令：

dart run generator.dart

这将在创建一个 data 目录，并下载一些UCD文件，覆盖文件 lib/src/tables.dart。

工作原理

term_unicode 实现了一个三级表格查找。这与其它库的想法大致相同。不同之处在于，term_unicode 不仅存储字符宽度，还存储了一些对终端应用程序有用的其他属性。这使得第二级表更大，但查找速度极快。

有关三级表格工作过程的详细解释，您可以查看以下链接：快速查找Unicode属性。

该项目基于其他项目的成果，如：

• https://github.com/ridiculousfish/widecharwidth
• https://github.com/unicode-rs/unicode-width
• https://cs.opensource.google/go/x/text/+/master:internal/ucd/ucd.go

贡献

欢迎对term_unicode进行贡献。请提交拉取请求或创建问题以讨论您希望进行的任何更改。

许可证

term_unicode 是在MIT许可证下发布的。

示例代码

import 'dart:io';

import 'package:termunicode/termunicode.dart';

void main() async {
  const str1 = '你好 世界';
  const str2 = 'ｈｅｌｌｏ';
  const str3 = 'hello 🌎';
  const str4 = 'Hola \x1bmundo\x1b';
  final str5 = str4.runes
      .fold(
        StringBuffer(),
        (sb, rune) => isNonPrintableCp(rune) ? (sb..write('')) : (sb..write(String.fromCharCode(rune))),
      )
      .toString();

  stdout
    ..writeln(' 123456789012345 ')
    ..writeln('|${centerString(str1, 15)}| => len: ${widthString(str1)}')
    ..writeln('|${centerString(str2, 15)}| => len: ${widthString(str2)}')
    ..writeln('|${centerString(str3, 15)}| => len: ${widthString(str3)}')
    ..writeln('|${centerString(str5, 15)}| => len: ${widthString(str5)}')
    ..writeln('\nversion: ${unicodeVersion()}');
}

String centerString(String str, int width) {
  final strWidth = widthString(str);
  final pad = (width - strWidth) ~/ 2;
  return ' ' * pad + str + ' ' * (width - strWidth - pad);
}