Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
commands:builtin:let [2012/04/10 23:52]
ormaaj (( is preferred.
commands:builtin:let [2015/11/16 04:19] (current)
thebonsai [The let builtin]
Line 1: Line 1:
-====== The let builtin ======+====== The let builtin ​command ​======
  
 ===== Synopsis ===== ===== Synopsis =====
Line 12: Line 12:
   * 1 (FALSE) when ''​arg''​ evaluated to 0 (arithmetic "​false"​)   * 1 (FALSE) when ''​arg''​ evaluated to 0 (arithmetic "​false"​)
 For this return code mapping, please see [[syntax:​arith_expr#​arithmetic_expressions_and_return_codes | this section]]. They work in the same way as ''<​nowiki>​((</​nowiki>''​. For this return code mapping, please see [[syntax:​arith_expr#​arithmetic_expressions_and_return_codes | this section]]. They work in the same way as ''<​nowiki>​((</​nowiki>''​.
- 
-  * ''​let''​ is very similar to [[syntax:​ccmd:​arithmetic_eval | ((]] - the only difference being ''​let''​ is a builtin, and ''<​nowiki>​((</​nowiki>''​ is a compound command. The arguments to ''​let''​ are subject to [[syntax:​expansion:​wordsplit|word splitting]] and [[syntax:​expansion:​globs|pathname expansion]] (almost never desirable) unless properly quoted or escaped, whereas the contents of ''<​nowiki>​((</​nowiki>''​ are not. **The [[syntax:​ccmd:​arithmetic_eval | arithmetic compound command]] is almost always preferred over ''​let'',​ which for most purposes should be considered depreciated.** 
  
 ===== Examples ===== ===== Examples =====
 +''​let''​ is very similar to [[syntax:​ccmd:​arithmetic_eval | ((]] - the only difference being ''​let''​ is a builtin (simple command), and ''<​nowiki>​((</​nowiki>''​ is a compound command. The arguments to ''​let''​ are therefore subject to all the same expansions and substitutions as any other simple command - requiring proper quoting and escaping - whereas the contents of ''<​nowiki>​((</​nowiki>''​ aren't subject to [[syntax:​expansion:​wordsplit | word-splitting]] or [[syntax:​expansion:​globs | pathname expansion]] (almost never desirable for arithmetic). For this reason, **the [[syntax:​ccmd:​arithmetic_eval | arithmetic compound command]] should generally be preferred over ''​let''​**.
 +
 <​code>​ <​code>​
 $ let 'b = a' "(a += 3) + $((a = 1)), b++" $ let 'b = a' "(a += 3) + $((a = 1)), b++"
Line 22: Line 22:
 </​code>​ </​code>​
  
-Is equivalent to the [[syntax:​ccmd:​arithmetic_eval | arithmetic evaluation compound command]]+Is equivalent to the [[syntax:​ccmd:​arithmetic_eval | arithmetic evaluation compound command]]:
  
 <​code>​ <​code>​
Line 29: Line 29:
 4 - 2 - 0 4 - 2 - 0
 </​code>​ </​code>​
- 
-The latter is almost always preferred. No wordsplitting or pathname expansion occurs within the arithmetic command. However, all the usual expansions and argument passing rules which apply to ordinary simple commands also apply to ''​let''​. Be careful about quoting and escaping. A rough analogy: ''​[''​ : ''<​nowiki>​[[</​nowiki>''​ :: ''​let''​ : ''<​nowiki>​((</​nowiki>'',​ except that ''​let''​ has no standalone command and is non-standard. 
  
 <WRAP info> <WRAP info>
-Remember that inside arithmetic evaluation contexts, all other expansions are processed as usual (from left-to-right),​ and the resulting text is evaluated as an arithmetic expression. Arithmetic already has a way to control precedence using parentheses,​ so it's very rare to need to nest arithmetic expansions within one another. It's used above only for illustrative purposes - to show how this precedence works.+Remember that inside arithmetic evaluation contexts, all other expansions are processed as usual (from left-to-right),​ and the resulting text is evaluated as an arithmetic expression. Arithmetic already has a way to control precedence using parentheses,​ so it's very rare to need to nest arithmetic expansions within one another. It's used above only to illustrate ​how this precedence works.
 </​WRAP>​ </​WRAP>​
-===== Portability considerations ===== 
  
-  * the ''​let''​ command is not specified by POSIX(r). The standard equivalent is: <code>[ "$(( <​EXPRESSION>​ ))" -ne 0 ]</code>+Unlike ​''<​nowiki>((</nowiki>'',​ being a simple command ''​let''​ has its own environment. In Bash, built-ins that can set variables process any arithmetic under their own environment,​ which makes the variable effectively "​local"​ to the builtin unless the variable is also set or modified by the builtin. This differs in other shells, such as ksh93, where environment assignments to regular builtins are always local even if the variable is modified by the builtin.
  
-  * [[http://​pubs.opengroup.org/​onlinepubs/​9699919799/​utilities/​expr.html#​tag_20_42 | expr(1)]] is a command one is likely to come across sooner or later. While it is more "standard" ​than ''​let'',​ the above should always be preferred. Both [[syntax:arith_expr | arithmetic expansion]]s and the ''​[''​ test operator are specified by POSIX(r) and satisfy almost all of expr's use-cases. Unlike ''​let'',​ ''​expr''​ cannot assign directly to bash variables but instead returns a result on stdout. ''​expr''​ takes each operator it recognizes as a separate word and then concatenates them into a single expression that's evaluated according to it's own rules (which differ from shell arithmetic). ''​let''​ parses each word it recieves on its own and evaluates it as an expression without generating any output other than a return code.+<​code>​ 
 + ~ $ y=1+1 let x=y; declare -p x y ) 
 +declare -- x="2" 
 +bash: declarey: not found
  
-  ​* the quotes around ​the [[syntax:​arith_expr | arithmetic expansion]] are only necessary with Bash and AT&T versions ​of kshother standard shells such as ashpdksh or zsh derivatives don't have that bug/misfeature. + ~ $ ( y=1+1 let x=y++; declare -p x y ) 
-   +declare -- x="​2"​ 
 +declare -- y="​3"​ 
 +</​code>​ 
 + 
 +This can be useful in certain situations where a temporary variable is needed. 
 + 
 +===== Portability considerations ===== 
 + 
 +  ​* the ''​let''​ command is not specified by POSIX(r). The portable alternative is: <​code>​[ "$(( <​EXPRESSION>​ ))" -ne 0 ]</​code>​. To make portable scripts simpler and cleaner, ''​let''​ can be defined as: <​code>​ 
 +# POSIX 
 +let() { 
 +    IFS=, command eval test '​$(($*))'​ -ne 0 
 +
 +</​code>​ Aside from differences in supported arithmetic features, this should be identical to the Bash/Ksh ''​let''​. 
 +  * It seems to be a common misunderstanding that ''​let''​ has some legacy purpose. Both ''​let''​ and [[syntax/​ccmd/​arithmetic_eval | ((...))]] were ksh88 features and almost identical in terms of portability as everything that inherited one also tended to get the other. Don't choose ''​let''​ over ''​((''​ expecting it to work in more places. 
 +  * [[http://​pubs.opengroup.org/​onlinepubs/​9699919799/​utilities/​expr.html#​tag_20_42 | expr(1)]] is a command one is likely to come across sooner or later. While it is more "​standard"​ than ''​let'',​ the above should always be preferred. Both [[syntax:​arith_expr | arithmetic expansion]]s and the ''​[''​ test operator ​are specified by POSIX(r) ​and satisfy almost all of expr's use-cases. Unlike ''​let''​''​expr''​ cannot assign directly to bash variables but instead returns a result on stdout. ''​expr''​ takes each operator it recognizes ​as a separate word and then concatenates them into a single expression that's evaluated according to it's own rules (which differ from shell arithmetic). ''​let''​ parses each word it recieves on its own and evaluates it as an expression without generating any output other than a return code. 
 +  * For unknown reasons, ''​let''​ is one of the Bash commands with special parsing for arguments formatted like compound array assignments. See: [[commands/builtin/​eval#​portability_considerations | eval]] for details. There are no known practical uses for this. Parentheses are treated as grouping operators and compound assignment is not possible by arithmetic expressions.
  
 ===== See also ===== ===== See also =====