@art-suite/art-core-ts-string-lib (英语)

TypeScript 的基本字符串工具,包括数字格式化和强复数化.

为什么是这个模块?

字符串操纵是任何应用程序的核心部分,但常见的任务如以逗号或复数字来格式化数字,往往被重新执行或处理不一致. 这个模块为这些需要提供了有重点的,类型安全的帮助者,有一个简单的,ergonomic API.

• 逗号 : 使用千个分隔符格式数字或数字字符串.
• 多元化 : 基于计数的智能复数字,支持自定义复数形式和边缘大小写. 盖在大众之上 pluralize npm包,但在更方便,TypeScript方便的API中呈现出.

安装和使用示例( 需要)

用 npm 安装 :

npm install @art-suite/art-core-ts-string-lib

基本用途:

import { commaize, pluralize } from "@art-suite/art-core-ts-string-lib";

// Format numbers with commas
commaize(1234567); // "1,234,567"
commaize("987654321"); // "987,654,321"

// Pluralize words based on count
pluralize("cat"); // "cats"
pluralize("cat", 1); // "1 cat"
pluralize("cat", 2); // "2 cats"
pluralize(3, "child", "children"); // "3 children"
pluralize("person", 2); // "2 people"

职能概览

commaize(x: number | string): string

将逗号作为千位分隔符添加到数字或数字字符串中.

• commaize(1234567) → "1,234,567"
• commaize("1000000") → "1,000,000"

pluralize(...)

将基于计数的单词多化,并具有灵活的调用签名:

• pluralize(singleForm: string) 返回复数形式 : pluralize("cat") → "cats"
• pluralize(singleForm: string, count: number) - 回返 "count word(s)"数字 : pluralize("cat", 2) → "2 cats"
• pluralize(count: number, singleForm: string) - 与上文相同: pluralize(1, "dog") → "1 dog"
• pluralize(singleForm: string, count: number, pluralForm: string) 自定义复数 : pluralize("child", 2, "children") → "2 children"
• pluralize(count: number, singleForm: string, pluralForm: string) ——与上同.

处理边缘案件,并保留平分(例如, "bus!" → "buses!") (中文(简体) ).

说明: 利用这个工具 pluralize npm包在罩下方,但用更方便,TypeScript友好的API来包装并处理额外的边缘外壳. 特别是 pluralize(number, noun) 与默认 npm 复数化 API 相比, 签名更接近于普通英语, 并且更具有ergoomic.

API 文档参考

关于所有被输出功能及其参数的详细信息,请参见源代码内的TypeScript打字和JSDoc评论.