mirror of
https://github.com/fish-shell/fish-shell.git
synced 2026-04-28 16:01:15 -03:00
7c27c1e7d0
Commit 0893134543 (Added .editorconfig file (#3332) (#3313),
2016-08-25) trimmed trailing whitespace for Markdown file (which do
have significant trailing whitespace) but ReStructuredText does not,
and none of our Markdown files cares about this, so let's clean up
whitespace always.
60 lines
1.5 KiB
ReStructuredText
60 lines
1.5 KiB
ReStructuredText
string-length - print string lengths
|
|
====================================
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
.. BEGIN SYNOPSIS
|
|
|
|
.. synopsis::
|
|
|
|
string length [-q | --quiet] [-V | --visible] [STRING ...]
|
|
|
|
.. END SYNOPSIS
|
|
|
|
Description
|
|
-----------
|
|
|
|
.. BEGIN DESCRIPTION
|
|
|
|
``string length`` reports the length of each string argument in characters. Exit status: 0 if at least one non-empty *STRING* was given, or 1 otherwise.
|
|
|
|
With **-V** or **--visible**, it uses the visible width of the arguments. That means it will discount escape sequences fish knows about, account for $fish_emoji_width and $fish_ambiguous_width. It will also count each line (separated by ``\n``) on its own, and with a carriage return (``\r``) count only the widest stretch on a line. The intent is to measure the number of columns the *STRING* would occupy in the current terminal.
|
|
|
|
.. END DESCRIPTION
|
|
|
|
Examples
|
|
--------
|
|
|
|
.. BEGIN EXAMPLES
|
|
|
|
::
|
|
|
|
>_ string length 'hello, world'
|
|
12
|
|
|
|
>_ set str foo
|
|
>_ string length -q $str; echo $status
|
|
0
|
|
# Equivalent to test -n "$str"
|
|
|
|
>_ string length --visible (set_color red)foobar
|
|
# the set_color is discounted, so this is the width of "foobar"
|
|
6
|
|
|
|
>_ string length --visible 🐟🐟🐟🐟
|
|
# depending on $fish_emoji_width, this is either 4 or 8
|
|
# in new terminals it should be
|
|
8
|
|
|
|
>_ string length --visible abcdef\r123
|
|
# this displays as "123def", so the width is 6
|
|
6
|
|
|
|
>_ string length --visible a\nbc
|
|
# counts "a" and "bc" as separate lines, so it prints width for each
|
|
1
|
|
2
|
|
|
|
.. END EXAMPLES
|