h/fish-shell
1
Fork 0
mirror of https://github.com/fish-shell/fish-shell.git synced 2026-05-01 01:51:14 -03:00
Code Issues Packages Projects Releases Wiki Activity

Document string match/replace --max-matches

Browse Source
This commit is contained in:
Mahmoud Al-Qudsi
2024-06-26 22:30:51 -05:00
parent 93f8385448
commit f975e1c9e5
2 changed files with 7 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
doc_src/cmds/string-replace.rst
View File

@@ -9,7 +9,8 @@ Synopsis
.. synopsis::
string replace [-a | --all] [-f | --filter] [-i | --ignore-case]
[-r | --regex] [-q | --quiet] PATTERN REPLACEMENT [STRING ...]
[-r | --regex] [[-m | --max-matches] MAX] [-q | --quiet]
PATTERN REPLACEMENT [STRING ...]
.. END SYNOPSIS
@@ -24,6 +25,8 @@ If **-r** or **--regex** is given, *PATTERN* is interpreted as a Perl-compatible
If you specify the **-f** or **--filter** flag then each input string is printed only if a replacement was done. This is useful where you would otherwise use this idiom: ``a_cmd | string match pattern | string replace pattern new_pattern``. You can instead just write ``a_cmd | string replace --filter pattern new_pattern``.
If **--max-matches MAX** or **-m MAX** is used, ``string replace`` will stop all processing after MAX lines of input have matched the specified pattern. In the event of ``--filter`` or ``-f``, this means the output will be MAX lines in length. This can be used as an "early exit" optimization when processing long inputs but expecting a limited and fixed number of outputs that might be found considerably before the input stream has been exhausted.
Exit status: 0 if at least one replacement was performed, or 1 otherwise.
.. END DESCRIPTION