system/zsh
system/zsh
1
0
Fork 0
mirror of https://github.com/zsh-users/zsh synced 2024-10-14 03:42:34 +00:00
Code Issues Packages Projects Releases Wiki Activity

45160: zshexpn: Expand documentation of (S)

Browse source
This commit is contained in:
Daniel Shahaf 2019-12-30 18:00:36 +00:00 committed by Daniel Shahaf
parent 408e75b903
commit f3d18c3fb5
2 changed files with 37 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
ChangeLog
View file

@ -1,3 +1,8 @@
2019-12-31 Daniel Shahaf <d.s@daniel.shahaf.name>
* 45160: Doc/Zsh/expn.yo: zshexpn: Expand documentation
of (S)
2019-12-28 Sebastian Gniazdowski <sgniazdowski@gmail.com>
* 45150 + 45152: Doc/Zsh/expn.yo: zshexpn: Use a more minimal

35
Doc/Zsh/expn.yo
View file

@ -1394,11 +1394,40 @@ used with the tt(${)...tt(/)...tt(}) forms.
startitem()
item(tt(S))(
Search substrings as well as beginnings or ends; with tt(#) start
from the beginning and with tt(%) start from the end of the string.
With tt(#) or tt(##), search for the match that starts closest to the start of
the string (a `substring match'). Of all matches at a particular position,
tt(#) selects the shortest and tt(##) the longest:
example(% str="aXbXc"
% echo ${+LPAR()S+RPAR()str#X*}
abXc
% echo ${+LPAR()S+RPAR()str##X*}
a
% )
With tt(%) or tt(%%), search for the match that starts closest to the end of
the string:
example(% str="aXbXc"
% echo ${+LPAR()S+RPAR()str%X*}
aXbc
% echo ${+LPAR()S+RPAR()str%%X*}
aXb
% )
(Note that tt(%) and tt(%%) don't search for the match that ends closest to the
end of the string, as one might expect.)
With substitution via tt(${)...tt(/)...tt(}) or
tt(${)...tt(//)...tt(}), specifies non-greedy matching, i.e. that the
shortest instead of the longest match should be replaced.
shortest instead of the longest match should be replaced:
example(% str="abab"
% echo ${str/*b/_}
_
% echo ${+LPAR()S+RPAR()str/*b/_}
_ab
% )
)
item(tt(I:)var(expr)tt(:))(
Search the var(expr)th match (where var(expr) evaluates to a number).