From f56e23eb66ccaa6dec664eafe32f8fd66c2de090 Mon Sep 17 00:00:00 2001 From: "Barton E. Schaefer" Date: Mon, 6 Jul 2015 16:27:07 -0700 Subject: unposted: alphabetize ${(b)...} flag --- Doc/Zsh/expn.yo | 38 +++++++++++++++++++------------------- 1 file changed, 19 insertions(+), 19 deletions(-) (limited to 'Doc') diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo index 1e1fc522f..4d54c42f8 100644 --- a/Doc/Zsh/expn.yo +++ b/Doc/Zsh/expn.yo @@ -930,6 +930,25 @@ array index order. Note that `tt(a)' is therefore equivalent to the default but `tt(Oa)' is useful for obtaining an array's elements in reverse order. ) +item(tt(b))( +Quote with backslashes only characters that are special to pattern +matching. This is useful when the contents of the variable are to be +tested using tt(GLOB_SUBST), including the tt(${~)var(...)tt(}) switch. + +Quoting using one of the tt(q) family of flags does not work +for this purpose since quotes are not stripped from non-pattern +characters by tt(GLOB_SUBST). In other words, + +example(pattern=${(q)str} +[[ $str = ${~pattern} ]]) + +works if tt($str) is tt('a*b') but not if it is tt('a b'), whereas + +example(pattern=${(b)str} +[[ $str = ${~pattern} ]]) + +is always true for any possible value of tt($str). +) item(tt(c))( With tt(${#)var(name)tt(}), count the total number of characters in an array, as if the elements were concatenated with spaces between them. This is not @@ -1034,25 +1053,6 @@ form of single quoting is used that only quotes the string if needed to protect special characters. Typically this form gives the most readable output. ) -item(tt(b))( -Quote with backslashes only characters that are special to pattern -matching. This is useful when the contents of the variable are to be -tested using tt(GLOB_SUBST), including the tt(${~)var(...)tt(}) switch. - -Quoting using one of the tt(q) family of flags does not work -for this purpose since quotes are not stripped from non-pattern -characters by tt(GLOB_SUBST). In other words, - -example(pattern=${(q)str} -[[ $str = ${~pattern} ]]) - -works if tt($str) is tt('a*b') but not if it is tt('a b'), whereas - -example(pattern=${(b)str} -[[ $str = ${~pattern} ]]) - -is always true for any possible value of tt($str). -) item(tt(Q))( Remove one level of quotes from the resulting words. ) -- cgit 1.4.1