CLI开发工具【免费下载链接】fish-shellThe user-friendly command line shell.项目地址https://gitcode.com/GitHub_Trending/fi/fish-shell点击查看免费下载导读string length是 fish-shell用户友好的命令行 shell源码仓库位于src/builtins/string/length.rs内置string命令家族中负责测量字符串长度的子命令。它既能在普通模式下按“字符character”逐一统计每个参数的长度也能通过--visible切换到“可见宽度visible width”模式精确模拟字符串在当前终端中实际占据的列数——这包括剔除 ANSI 转义序列、依据$fish_emoji_width与$fish_ambiguous_width处理宽字符、并按换行与回车分段取最大宽度。读完本篇你将掌握string length的全部选项、退出状态语义、与test -n的等价关系以及其底层宽度计算在 src/builtins/string.rs 中的实现原理。命令语法与选项string length的完整调用形式如下引自 doc_src/cmds/string-length.rst 的 Synopsis 部分string length [-q | --quiet] [-V | --visible] [STRING ...]它接受两个互不排斥的开关选项二者均可与位置参数组合使用选项含义-q,--quiet静默模式不输出任何长度数值仅以退出状态表达结果-V,--visible可见宽度模式按字符串在当前终端中实际占据的列数visible width统计而非字符数参数[STRING ...]支持零个或多个字符串当没有给出任何字符串、或给出的字符串均为空时命令按“无有效结果”处理见下文退出状态。从源码实现看这两个选项由 src/builtins/string/length.rs 中的Length结构体解析const LONG_OPTIONS: static [WOptionstatic] [ wopt(L!(quiet), NoArgument, q), wopt(L!(visible), NoArgument, V), ]; const SHORT_OPTIONS: static wstr L!(qV);即quiet对应短选项-qvisible对应短选项-V两者均为“不带参数”的标志位任何其他选项都会触发UnknownOption错误。普通模式按字符计数不携带任何选项时string length逐个统计每个字符串参数的字符character个数每个参数输出一行整数结果。_ string length hello, world 12这里hello, world包含 12 个字符含空格与逗号输出12。值得强调的是“字符”是按 Unicode 码点层面统计的é、中、emoji 等非 ASCII 字符各计一个字符。仓库单元测试 src/builtins/string/length.rs 验证了这一点validate!([string, length, \u{2008}A], STATUS_CMD_OK, 1\n); // 字符 U2008 计为 1 validate!([string, length, um, dois, três], STATUS_CMD_OK, 2\n4\n4\n);其中trêstrês输出4证实每个 Unicode 字符都按一个字符计数um、dois分别输出2、4。多参数时每个参数独立输出一行顺序与参数顺序一致。多个参数依次输出该行为也可在仓库集成测试 tests/checks/string.fish 中看到如string length hello, world的用例。普通模式不会做终端相关的宽度计算因此性能开销低适合脚本中对字符串进行快速非空或长度判断。--quiet模式与退出状态语义string length的退出状态规则是它区别于wc -c、wc -m等外部工具的关键退出状态 0至少有一个非空长度大于 0的字符串参数被给出退出状态 1所有参数都为空、或根本没有参数。该语义在源码 src/builtins/string/length.rs 中以nnonempty计数器实现只有当nnonempty 0时返回成功Ok(())否则返回STATUS_CMD_ERROR。-q/--quiet模式正是围绕这一退出状态设计的“谓词predicate”用法它不打印任何长度数字只通过退出状态告诉你“是否存在非空字符串”从而等价于test -n $str_ set str foo _ string length -q $str; echo $status 0 # Equivalent to test -n $str配合and/or可以写出更符合 fish 习惯的条件判断例如 tests/checks/string.fish 中的写法string length -q ; and echo not zero length; or echo zero length单元测试也逐一固化了退出状态行为 src/builtins/string/length.rs输入退出状态输出string length无参数1STATUS_CMD_ERROR无输出string length 10string length 10\n0\n0string length a01string length -q1无输出string length -q 1无输出string length -q a0无输出注意即使为空字符串非静默模式仍会输出0这一行只是最终退出状态为 1。-q模式下则完全不输出仅由$status承载结论。--visible模式测量终端真实占用宽度-V/--visible模式下string length统计的不是字符数而是字符串在当前终端中会占据的列数columns。文档 doc_src/cmds/string-length.rst 给出的语义要点包括剔除 fish 认识的转义序列像set_color输出的 ANSI 颜色码不会被计入宽度考虑$fish_emoji_width与$fish_ambiguous_widthemoji 与“宽度不明”字符按这两个变量的取值决定宽 1 列还是 2 列按\n逐行独立计数多行输入会为每一行分别输出一个宽度按\r取一行中最宽的一段回车会“回到行首”因此一行最终宽度取该行内最长段落的列数。其目的正如文档所述测量 STRING 在当前终端中实际占据的列数用于对齐、画表格、计算进度条等对“视觉宽度”敏感的脚本场景。剔除转义序列set_color不计入宽度_ string length --visible (set_color red)foobar # the set_color is discounted, so this is the width of foobar 6(set_color red)生成 ANSI 颜色转义序列虽然序列中可能含可打印字符如[、3、1、m但它们不会被终端渲染出来因此被--visible扣除最终宽度等于纯文本foobar的 6。集成测试 tests/checks/string.fish 中的string length --visible (set_color red)abc同样验证了这一点。emoji 与模糊宽度字符$fish_emoji_width/$fish_ambiguous_width_ string length --visible # depending on $fish_emoji_width, this is either 4 or 8 # in new terminals it should be 8四个鱼 emoji在$fish_emoji_width被设为 2 时输出 8若该变量被设为 1 则输出 4。默认行为取决于终端与 locale 探测结果fish 会在启动时依据当前终端能力为$fish_emoji_width与$fish_ambiguous_width设定合适的默认值。这两个变量的解析与默认值处理位于 src/env_dispatch.rsfish_emoji_width可由用户覆盖代码中会打印 Overriding default fish_emoji_width w/ ... 日志fish_ambiguous_width则读取变量并调用fish_wcstoi解析为整数。它们的取值最终通过fish_wcwidth_visible影响每个字符的列宽计算见下一节。回车\r按行内最宽段落计宽_ string length --visible abcdef\r123 # this displays as 123def, so the width is 6 6回车符使终端光标回到行首123覆盖了abcdef的前三个字符因此视觉上显示为123def占据 6 列。--visible将一行按\r拆成若干段abcdef与123取其中最宽的一段长度max 6。换行\n逐行独立输出_ string length --visible a\nbc # counts a and bc as separate lines, so it prints width for each 1 2包含换行符的输入会被拆分为多行每行单独输出一个宽度a为 1bc为 2。这意味着该命令天然适合处理多行字符串的“逐行视觉宽度”需求。源码级原理--visible的宽度计算--visible的核心逻辑位于 src/builtins/string/length.rs 的handle方法if self.visible { // Visible length only makes sense line-wise. for line in arg.split(\n) { let mut max 0; // Carriage-return returns us to the beginning. The longest substring without // carriage-return determines the overall width. for reset in line.split(\r) { let n width_without_escapes(reset, 0); max usize::max(max, n); } if max 0 { nnonempty 1; } if !self.quiet { streams.out.appendln(max.to_wstring()); } else if nnonempty 0 { return Ok(()); } } }流程可拆解为先按\n切成“行”再对每行按\r切成“段”每段调用width_without_escapes计算去转义后的可见宽度行内取最大值作为该行宽度随后逐行输出--quiet时一旦发现任一非空行就提前返回成功。这里也可以看到-q与-V可以叠加使用-qV表示“是否存在可见宽度大于 0 的内容”。真正执行“宽度”计算的函数是 src/builtins/string.rs 中的width_without_escapes其实现要点如下遍历每个字符用fish_wcwidth_visible(c)累加列宽——该函数综合了$fish_emoji_width、$fish_ambiguous_width与底层 wcwidth 能力再扫描\x1BESC开头的 ANSI 转义序列调用escape_code_length位于 src/screen.rs判断其长度并将其内部所有可打印字符的宽度从总数中扣除避免颜色码“虚增”宽度处理连续/嵌套转义如 xterm 的 SGR0 reset 由\e(B\e[m两段组成跳过整段后继续扫描最终usize::try_from(width)将累计值转为无符号整数返回。另外值得注意的是width_without_escapes同样被string padsrc/builtins/string/pad.rs与string shortensrc/builtins/string/shorten.rs复用——这三者共同构成 fish 中“按可见宽度对齐与截断”的底层基础设施因此string length -V的测量结果与string pad、string shorten的对齐效果是严格一致的你可以放心用同一套宽度口径做字符串排版。实战示例与使用建议判断变量是否非空set str foo if string length -q $str echo str 非空 end与test -n $str等价但更贴近 fish 的字符串管道风格注意当$str未定义时fish 会把它展开为空参数此时string length -q返回 1分支不会执行——这一行为在逻辑上是安全的。对齐输出测量可见宽度set colored (set_color green)OK(set_color normal) set width (string length -V -- $colored) echo 提示信息占 $width 列普通模式会把 ANSI 颜色序列的字符也算进去导致“看起来比实际宽”-V模式则给出真实列数可配合printf的%*s或string pad做对齐。校验用户输入的多行文本string length -V -- $multiline # 每行输出一个宽度逐行输出宽度便于确认最长一行的列数是否超过终端宽度上限避免换行错乱。关于--与特殊字符fish 的string子命令按位置参数解析若字符串以-开头建议在其前使用--明确终止选项解析避免被误当作-q/-V。例如string length -- -foo。string length -V -这类写法不会匹配任何选项也会被安全地当作普通字符串处理。小结string length以极小的语法面-q/-V两个开关覆盖了两类常见需求普通模式下按字符计数并给出“是否存在非空参数”的退出状态等价于test -n可见宽度模式下则忠实反映字符串在终端中的实际列数正确扣除 ANSI 转义序列、尊重 emoji 与模糊宽度字符变量、并妥善处理\n与\r带来的换行与覆盖语义。其实现与string pad、string shorten共享同一套宽度计算函数在 fish 的文本排版工具链中扮演“测量基准”的角色。相关的单元测试src/builtins/string/length.rs与集成测试tests/checks/string.fish可作为进一步验证与学习该命令行为的第一手资料。赞分享CLI开发工具【免费下载链接】fish-shellThe user-friendly command line shell.项目地址https://gitcode.com/GitHub_Trending/fi/fish-shell点击查看免费下载相关推荐fish-shell string pad 完全指南按可见宽度对齐与填充字符串fish shell string pad 完全指南按可见宽度对齐与填充字符串 本文围绕 fish shell 内置命令 string pad 展开讲解如何CLI开发工具fish-shell return 命令完全指南函数退出、退出状态与脚本控制流fish shell return 命令完全指南函数退出、退出状态与脚本控制流 return 是 fish shell 中用于终止当前函数执行、并可选地设置退CLI开发工具fish-shell 的 string join 与 string join0 命令用分隔符拼接字符串的完整指南fish shell 的 string join 与 string join0 命令用分隔符拼接字符串的完整指南 导读 string join 与 strinCLI开发工具上一篇3分钟搞定视觉数据预处理VGGT自动化流水线实战指南下一篇Easy RL 论文精读基于 Stein 恒等式构建动作依赖控制变量的策略梯度方差削减方法创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考