Flutter本地存储管理插件local_case的使用

LocalCase

LocalCase 是一个为多种语言提供本地化大小写转换和数字转文字功能的 Flutter 包。该包允许你根据特定的语言规则将文本转换为大写或小写，并将数字转换为对应的文字形式。目前它支持法语、西班牙语、捷克语、德语和土耳其语。

特性

• 本地化大小写转换：根据特定语言的规则将文本转换为小写或大写。
• 数字转文字：将高达一百万的数字转换为对应的文字形式。
• 自定义错误处理：对于不支持的语言或无效输入，提供清晰的错误信息。

安装

在 pubspec.yaml 文件中添加 local_case 依赖：

dependencies:
  local_case: ^0.0.6

然后运行 flutter pub get 来安装该包。

使用

导入包

import 'package:local_case/local_case.dart';
import 'package:local_case/enum/local_case_language_enum.dart';

将文本转换为小写

String lowercaseText = LocalCase.toLowercase(
  text: 'HALLO WELT',
  language: LocalCaseLanguage.german,
);
print(lowercaseText); // 输出: hallo welt (根据德语规则)

将文本转换为大写

String uppercaseText = LocalCase.toUppercase(
  text: 'merhaba dünya',
  language: LocalCaseLanguage.turkish,
);
print(uppercaseText); // 输出: MERHABA DÜNYA (根据土耳其语规则)

将数字转换为文字

String numberInWords = LocalCase.convertNumberToWords(
  number: 256,
  language: LocalCaseLanguage.spanish,
);
print(numberInWords); // 输出: doscientos cincuenta y seis (在西班牙语中)

支持的语言

LocalCaseLanguage 枚举支持以下语言：

• 法语
• 西班牙语
• 捷克语
• 德语
• 土耳其语

错误处理

如果你使用了不支持的语言或者提供了无效的输入，LocalCase 会抛出 LocaleCaseError.unsupportedLanguage() 异常。确保在应用程序中处理此异常。

示例

try {
  String result = LocalCase.toUppercase(
    text: 'example text',
    language: LocalCaseLanguage.unknown, // 不支持的语言
  );
} catch (e) {
  print(e); // 输出: Unsupported language error
}

示例代码

以下是完整的示例代码，演示如何使用 local_case 包进行不同语言的大小写转换和数字转文字：

import 'package:local_case/local_case.dart';
import 'package:local_case/enum/local_case_language_enum.dart';

void main() {
  // 在不同语言中将文本转换为小写
  print(LocalCase.toLowercase(
      text: 'ÉNERGIE RENOUVELABLE', language: LocalCaseLanguage.french));
  print(LocalCase.toLowercase(
      text: 'BUENOS DÍAS', language: LocalCaseLanguage.spanish));
  print(LocalCase.toLowercase(
      text: 'GUTEN TAG', language: LocalCaseLanguage.german));

  // 在土耳其语中将文本转换为大写
  print(LocalCase.toUppercase(
      text: 'merhaba dünya', language: LocalCaseLanguage.turkish));

  // 在不同语言中将数字转换为文字
  print(LocalCase.convertNumberToWords(
      number: 123,
      language:
          LocalCaseLanguage.german)); // 输出: "einhundertdreiundzwanzig"
  print(LocalCase.convertNumberToWords(
      number: 456,
      language: LocalCaseLanguage
          .spanish)); // 输出: "cuatrocientos cincuenta y seis"
  print(LocalCase.convertNumberToWords(
      number: 789,
      language:
          LocalCaseLanguage.french)); // 输出: "sept cent quatre-vingt-neuf"
  print(LocalCase.convertNumberToWords(
      number: 234,
      language: LocalCaseLanguage.czech)); // 输出: "dvě stě třicet čtyři"
  print(LocalCase.convertNumberToWords(
      number: 567,
      language: LocalCaseLanguage.turkish)); // 输出: "beş yüz altmış yedi"

  // 处理不支持的语言的错误
  try {
    print(LocalCase.toLowercase(
        text: 'unsupported', language: LocalCaseLanguage.unknown));
  } catch (e) {
    print(e); // 输出: LocaleCaseError: Unsupported language
  }

  // 处理无效数字范围的错误
  try {
    print(LocalCase.convertNumberToWords(
        number: 1000000, language: LocalCaseLanguage.turkish));
  } catch (e) {
    print(e); // 输出: LocaleCaseError: Invalid range
  }
}