mirror of
https://git.savannah.gnu.org/git/coreutils.git
synced 2026-11-17 18:02:09 +03:00
doc: describe test operator precedence and associativity
* doc/coreutils.texi (Connectives for test): Add notes on precedence and associativity. Also mention the portability caveats with these operators. * cfg.mk: Avoid sc_prohibit_test_minus_ao for coreutils.texi. Fixes http://bugs.gnu.org/22216
This commit is contained in:
1 parent
f8a9c8c343
commit
3205bb178c
2 files changed
+32
-1
No files matched your search
@@ -799,6 +799,7 @@ exclude_file_name_regexp--sc_prohibit_always_true_header_tests = \
|
||||
^m4/stat-prog\.m4$$
|
||||
exclude_file_name_regexp--sc_prohibit_fail_0 = \
|
||||
(^.*/git-hooks/commit-msg|^tests/init\.sh|Makefile\.am|\.mk|.*\.texi)$$
|
||||
exclude_file_name_regexp--sc_prohibit_test_minus_ao = *\.texi$$
|
||||
exclude_file_name_regexp--sc_prohibit_atoi_atof = ^lib/euidaccess-stat\.c$$
|
||||
|
||||
# longlong.h is maintained elsewhere.
|
||||
|
||||
+31
-1
@@ -12638,25 +12638,55 @@ test 0x100 -eq 1
|
||||
@cindex logical connectives
|
||||
@cindex connectives, logical
|
||||
|
||||
The usual logical connectives.
|
||||
Note it's preferred to use shell logical primitives
|
||||
rather than these logical connectives internal to @command{test},
|
||||
because an expression may become ambiguous
|
||||
depending on the expansion of its parameters.
|
||||
|
||||
For example, this becomes ambiguous when @samp{$1}
|
||||
is set to @samp{'!'} and @samp{$2} to the empty string @samp{''}:
|
||||
|
||||
@example
|
||||
test "$1" -a "$2"
|
||||
@end example
|
||||
|
||||
and should be written as:
|
||||
|
||||
@example
|
||||
test "$1" && test "$2"
|
||||
@end example
|
||||
|
||||
Note the shell logical primitives also benefit from
|
||||
short circuit operation, which can be significant
|
||||
for file attribute tests.
|
||||
|
||||
@table @samp
|
||||
|
||||
@item ! @var{expr}
|
||||
@opindex !
|
||||
True if @var{expr} is false.
|
||||
@samp{!} has lower precedence than all parts of @var{expr}.
|
||||
Note @samp{!} needs to be specified to the left
|
||||
of a binary expression, I.e., @samp{'!' 1 -gt 2}
|
||||
rather than @samp{1 '!' -gt 2}.
|
||||
Also @samp{!} is often a shell special character
|
||||
and is best used quoted.
|
||||
|
||||
|
||||
@item @var{expr1} -a @var{expr2}
|
||||
@opindex -a
|
||||
@cindex logical and operator
|
||||
@cindex and operator
|
||||
True if both @var{expr1} and @var{expr2} are true.
|
||||
@samp{-a} is left associative,
|
||||
and has a higher precedence than @samp{-o}.
|
||||
|
||||
@item @var{expr1} -o @var{expr2}
|
||||
@opindex -o
|
||||
@cindex logical or operator
|
||||
@cindex or operator
|
||||
True if either @var{expr1} or @var{expr2} is true.
|
||||
@samp{-o} is left associative.
|
||||
|
||||
@end table
|
||||
|
||||
|
||||
Reference in new issue
Block a user