开发工具【免费下载链接】HumanizerHumanizer meets all your .NET needs for manipulating and displaying strings, enums, dates, times, timespans, numbers and quantities项目地址https://gitcode.com/gh_mirrors/hu/Humanizer点击查看免费下载导读Humanizer.Truncator是 Humanizer 库中用于获取字符串截断器ITruncator的静态入口类它把把过长的字符串截断为指定长度这一常见需求抽象为五种可组合的截断策略配合TruncateFrom方向枚举几乎可以覆盖 UI 摘要、日志裁剪、文本预览等全部截断场景。阅读本文后你将掌握Truncator五个静态属性的差异与适用场景、ITruncator接口的调用契约以及如何结合Truncate扩展方法与自定义截断字符串实现精确可控的字符串截断。1. 概览Truncator 是什么Truncator是一个public static class本身不参与任何截断逻辑计算它的职责是集中暴露一组已实例化好的截断器供TruncateExtensions扩展方法按需选用见 Truncator.cspublic static class Truncator { public static ITruncator FixedLength { get; } new FixedLengthTruncator(); public static ITruncator FixedNumberOfCharacters { get; } new FixedNumberOfCharactersTruncator(); public static ITruncator FixedNumberOfWords { get; } new FixedNumberOfWordsTruncator(); public static ITruncator DynamicLengthAndPreserveWords { get; } new DynamicLengthAndPreserveWordsTruncator(); public static ITruncator DynamicNumberOfCharactersAndPreserveWords { get; } new DynamicNumberOfCharactersAndPreserveWordsTruncator(); }注本文对应的 2.11.10 版 API 文档 Humanizer.Truncator.md 中收录了前三个属性FixedLength、FixedNumberOfCharacters、FixedNumberOfWords当前仓库源码在此基础上还提供了两个动态截断器DynamicLengthAndPreserveWords与DynamicNumberOfCharactersAndPreserveWords本文一并覆盖。所有属性均为只读静态属性可在程序任意位置直接访问同一截断器实例被全局共享。所有截断器都实现同一个接口ITruncator定义见 ITruncator.cspublic interface ITruncator { string? Truncate(string? value, int length, string? truncationString, TruncateFrom truncateFrom TruncateFrom.Right); }四个参数的含义分别是参数类型说明valuestring?待截断的字符串可为null返回nulllengthint截断后的目标长度上限包含截断指示符如省略号所占长度truncationStringstring?截断指示符例如…、...或任意自定义串传null视作空串truncateFromTruncateFrom截断方向默认Right从右侧截断2. 核心属性逐个拆解2.1 Truncator.FixedLength —— 固定长度截断器public static Humanizer.ITruncator FixedLength { get; }返回值类型ITruncator。该属性返回FixedLengthTruncator实例按字符数硬性截断到指定长度实现见 FixedLengthTruncator.cs。其行为要点value为null时返回null空串或长度不超过length时原样返回若truncationString为null或其长度大于length则不带指示符地截断从右截断取value[..length]从左截断取value[^length..]否则右截断结果为value[0, length - truncationString.Length] truncationString左截断为truncationString value[length - truncationString.Length..]。典型用例来自 TruncatorTests.cs 的测试数据short text.Truncate(20, trunc) // short text未超长原样返回 Text longer than truncate length.Truncate(10, trunc) // Text trunc10 - 5 5 个字符 trunc Text longer than truncate length.Truncate(10, very long truncation string) // Text longe指示符过长时忽略指示符2.2 Truncator.FixedNumberOfCharacters —— 固定字母/数字数量截断器public static Humanizer.ITruncator FixedNumberOfCharacters { get; }返回值类型ITruncator。该属性返回FixedNumberOfCharactersTruncator实例特点是只统计字母和数字char.IsLetterOrDigit空格、标点等不计入长度配额实现见 FixedNumberOfCharactersTruncator.cs。从源码可以推断其处理流程先从左到右统计字母/数字个数若alphaNumericalCount length则原样返回需要截断时从左Right方向或右Left方向开始逐字符累计字母/数字个数当已计数 truncationString.Length length时在此处拼接指示符并返回truncationString为null时按空串处理指示符长度超过length时同样退化为无指示符截断。Text with more characters than truncate length.Truncate(10, Truncator.FixedNumberOfCharacters) // Text with m…2.3 Truncator.FixedNumberOfWords —— 固定单词数量截断器public static Humanizer.ITruncator FixedNumberOfWords { get; }返回值类型ITruncator。该属性返回FixedNumberOfWordsTruncator实例按单词数截断实现见 FixedNumberOfWordsTruncator.cs。源码细节单词以char.IsWhiteSpace空格、\n、\r、\t等为分隔符连续空白只算一次分隔且统计过程不分配数组遍历字符完成右截断在数到第length个单词的结尾空白处切分例如Text with more words than truncate length.Truncate(4, Truncator.FixedNumberOfWords)得到Text with more words…左截断从字符串末尾向前扫描在第length个单词边界处切分并前置指示符测试 TruncatorTests.cs 还验证了多空白分隔场景Words are\nsplit\rby\twhitespace.Truncate(4, Truncator.FixedNumberOfWords)输出Words are\nsplit\rby…。2.4 动态截断器保留完整单词除文档收录的三个属性外当前源码还提供两个智能截断器见 Truncator.csDynamicLengthAndPreserveWords按字符长度截断但如果切断点落在单词中间则整词丢弃并附上指示符左截断时若剩余空间放不下完整单词则只返回指示符实现见 DynamicLengthAndPreserveWordsTruncator.cs。DynamicNumberOfCharactersAndPreserveWords按字母/数字个数配额截断同时保证不切半单词——计数只统计字母/数字单词边界用空白判定任何一方装不下完整单词时只返回指示符实现见 DynamicNumberOfCharactersAndPreserveWordTruncator.cs。来自 TruncatorTests.cs 的验证用例Text longer than truncate length.Truncate(10, Truncator.DynamicLengthAndPreserveWords) // Text…longer 被整体丢弃 Textual with … starting word longer than ….Truncate(4, Truncator.DynamicLengthAndPreserveWords) // …放不下完整单词 A Text with … the last word fit.Truncate(2, Truncator.DynamicLengthAndPreserveWords) // A… Text with more characters than truncate length.Truncate(10, Truncator.DynamicNumberOfCharactersAndPreserveWords) // Text with…3. TruncateFrom截断方向TruncateFrom是一个二值枚举定义见 TruncateFrom.cs成员含义Left从字符串左侧开头截断保留尾部内容指示符前置Right从字符串右侧结尾截断保留开头内容指示符后置默认值方向与指示符的组合效果来自 TruncateExtensions.cs 的文档示例This is a long string.Truncate(10, Truncator.FixedLength, TruncateFrom.Left) // …ng string This is a long string.Truncate(10, …, Truncator.FixedNumberOfWords, TruncateFrom.Left) // … string This is a long string.Truncate(10, ..., TruncateFrom.Left) // ...string4. 与 Truncate 扩展方法的协作方式Truncator类通常不会单独使用而是作为 TruncateExtensions.cs 中四个Truncate重载的参数。这些重载构成了从最简用法到完全自定义的阶梯重载签名默认行为input.Truncate(int length)使用默认指示符…与Truncator.FixedLength右截断input.Truncate(int length, ITruncator truncator, TruncateFrom from Right)自定义截断器指示符仍为…input.Truncate(int length, string? truncationString, TruncateFrom from Right)自定义指示符截断器固定为FixedLengthinput.Truncate(int length, string? truncationString, ITruncator truncator, TruncateFrom from Right)指示符、截断器、方向全部自定义最灵活最底层重载TruncateExtensions.cs会做空值校验input为null时返回nulltruncator为null时抛出ArgumentNullException随后把参数透传给truncator.Truncate(...)。[return: NotNullIfNotNull(nameof(input))]特性保证了空流式null-propagation场景下的可空性分析安全。几个贴近实战的组合示例// 1. 列表摘要保留前 3 个词加省略号 description.Truncate(3, ..., Truncator.FixedNumberOfWords); // Humanizer meets all... // 2. 目录/路径预览从左侧截断保留结尾 path.Truncate(20, …, Truncator.FixedLength, TruncateFrom.Left); // …e/truncation/Truncator.cs // 3. 摘要文本硬性 80 字符内且不切半单词 article.Truncate(80, …, Truncator.DynamicLengthAndPreserveWords); // … // 4. 统计字数场景按字母/数字配额截断且保留完整词 headline.Truncate(30, …, Truncator.DynamicNumberOfCharactersAndPreserveWords);5. 行为边界与注意事项综合源码与 TruncatorTests.cs 的 320 行测试矩阵使用时需要记住以下边界行为null 与空串所有截断器对null一律返回null对空串返回空串未超长输入只要实际长度/单词数/字母数不超过length一律原样返回不附加指示符指示符过长当truncationString.Length length时FixedLength与FixedNumberOfCharacters会直接忽略指示符做裸截断如Text longer than truncate length.Truncate(2, ...)输出Te配额包含指示符length是结果总长度上限指示符会占用配额所以指示符越长可保留的正文越短保词截断的特殊回退动态截断器在空间不足放不下任何完整单词时只返回指示符如…这是它们与固定截断器的最大行为差异单词定义单词以任意空白字符含换行、制表符、回车分隔连续空白不产生空单词。这些边界行为均有对应测试用例佐证例如 TruncatorTests.cs 中null指示符、超长指示符与空串指示符的组合验证。6. 如何验证与运行运行测试截断器行为由 TruncatorTests.cs 完整覆盖编号 01–21 的 Theory 用例包含全部五种截断器、自定义指示符、左右双向截断可在测试项目目录执行dotnet test验证查看公共 API 签名TruncateFrom枚举、ITruncator接口等公共成员均已纳入 API 基线快照见 PublicApiApprovalTest.Approve_Public_Api.DotNet8_0.verified.txt阅读源码所有截断器实现集中在 src/Humanizer/Truncation 目录扩展入口在 TruncateExtensions.cs方向枚举在 TruncateFrom.cs。结语Truncator用一组静态属性把截断策略与字符串操作解耦日常场景直接使用FixedLength精确、FixedNumberOfCharacters按字母/数字配额、FixedNumberOfWords按语义词数对排版要求高的场景改用两个动态截断器避免切半单词的观感问题。理解length包含指示符配额、TruncateFrom控制方向、指示符过长自动退化的三条核心规则即可在任意 .NET 项目中稳定复现可预期的截断结果。赞分享开发工具【免费下载链接】HumanizerHumanizer meets all your .NET needs for manipulating and displaying strings, enums, dates, times, timespans, numbers and quantities项目地址https://gitcode.com/gh_mirrors/hu/Humanizer点击查看免费下载相关推荐Humanizer 字符串截断完全指南Truncator 静态工厂与五种 ITruncator 策略源码解析Humanizer 字符串截断完全指南Truncator 静态工厂与五种 ITruncator 策略源码解析 导读 Humanizer https://lin开发工具Humanizer Truncator 截断器使用指南用 3 个静态实例与 4 种扩展方法精确控制字符串长度Humanizer Truncator 截断器使用指南用 3 个静态实例与 4 种扩展方法精确控制字符串长度 导读 在 .NET 项目中展示长文本如文章摘开发工具Humanizer 动态字母数字截断器 DynamicNumberOfCharactersAndPreserveWordsTruncator 完整解析按字母/数字计数并保留完整单词Humanizer 动态字母数字截断器 DynamicNumberOfCharactersAndPreserveWordsTruncator 完整解析按字母/开发工具上一篇3个步骤快速掌握ComfyUI UltimateSDUpscale图像放大技术下一篇终极指南如何在Expo项目中无需ejected集成React Native Skia创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考