2014-08-27 16:41:09 +00:00
|
|
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
|
|
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
|
|
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
|
|
|
|
version="5.0"
|
|
|
|
|
|
xml:id="sec-language-operators">
|
|
|
|
|
|
|
|
|
|
|
|
<title>Operators</title>
|
|
|
|
|
|
|
|
|
|
|
|
<para><xref linkend='table-operators' /> lists the operators in the
|
|
|
|
|
|
Nix expression language, in order of precedence (from strongest to
|
|
|
|
|
|
weakest binding).</para>
|
|
|
|
|
|
|
|
|
|
|
|
<table xml:id='table-operators'>
|
|
|
|
|
|
<title>Operators</title>
|
|
|
|
|
|
<tgroup cols='3'>
|
|
|
|
|
|
<thead>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Name</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry>Syntax</entry>
|
|
|
|
|
|
<entry>Associativity</entry>
|
|
|
|
|
|
<entry>Description</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Precedence</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
</thead>
|
|
|
|
|
|
<tbody>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Select</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry><replaceable>e</replaceable> <literal>.</literal>
|
|
|
|
|
|
<replaceable>attrpath</replaceable>
|
|
|
|
|
|
[ <literal>or</literal> <replaceable>def</replaceable> ]
|
|
|
|
|
|
</entry>
|
|
|
|
|
|
<entry>none</entry>
|
|
|
|
|
|
<entry>Select attribute denoted by the attribute path
|
|
|
|
|
|
<replaceable>attrpath</replaceable> from set
|
|
|
|
|
|
<replaceable>e</replaceable>. (An attribute path is a
|
|
|
|
|
|
dot-separated list of attribute names.) If the attribute
|
|
|
|
|
|
doesn’t exist, return <replaceable>def</replaceable> if
|
|
|
|
|
|
provided, otherwise abort evaluation.</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>1</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Application</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry><replaceable>e1</replaceable> <replaceable>e2</replaceable></entry>
|
|
|
|
|
|
<entry>left</entry>
|
|
|
|
|
|
<entry>Call function <replaceable>e1</replaceable> with
|
|
|
|
|
|
argument <replaceable>e2</replaceable>.</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>2</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
2017-10-26 18:49:26 +00:00
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Arithmetic Negation</entry>
|
2017-10-26 18:49:26 +00:00
|
|
|
|
<entry><literal>-</literal> <replaceable>e</replaceable></entry>
|
|
|
|
|
|
<entry>none</entry>
|
|
|
|
|
|
<entry>Arithmetic negation.</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>3</entry>
|
2017-10-26 18:49:26 +00:00
|
|
|
|
</row>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Has Attribute</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry><replaceable>e</replaceable> <literal>?</literal>
|
|
|
|
|
|
<replaceable>attrpath</replaceable></entry>
|
|
|
|
|
|
<entry>none</entry>
|
|
|
|
|
|
<entry>Test whether set <replaceable>e</replaceable> contains
|
|
|
|
|
|
the attribute denoted by <replaceable>attrpath</replaceable>;
|
|
|
|
|
|
return <literal>true</literal> or
|
|
|
|
|
|
<literal>false</literal>.</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>4</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>List Concatenation</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry><replaceable>e1</replaceable> <literal>++</literal> <replaceable>e2</replaceable></entry>
|
|
|
|
|
|
<entry>right</entry>
|
|
|
|
|
|
<entry>List concatenation.</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>5</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Multiplication</entry>
|
2017-10-26 18:49:26 +00:00
|
|
|
|
<entry>
|
|
|
|
|
|
<replaceable>e1</replaceable> <literal>*</literal> <replaceable>e2</replaceable>,
|
2019-08-23 19:50:54 +00:00
|
|
|
|
</entry>
|
|
|
|
|
|
<entry>left</entry>
|
|
|
|
|
|
<entry>Arithmetic multiplication.</entry>
|
|
|
|
|
|
<entry>6</entry>
|
|
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
|
|
|
|
|
<entry>Division</entry>
|
|
|
|
|
|
<entry>
|
2017-10-26 18:49:26 +00:00
|
|
|
|
<replaceable>e1</replaceable> <literal>/</literal> <replaceable>e2</replaceable>
|
|
|
|
|
|
</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry>left</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Arithmetic division.</entry>
|
|
|
|
|
|
<entry>6</entry>
|
|
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
|
|
|
|
|
<entry>Addition</entry>
|
|
|
|
|
|
<entry>
|
|
|
|
|
|
<replaceable>e1</replaceable> <literal>+</literal> <replaceable>e2</replaceable>
|
|
|
|
|
|
</entry>
|
|
|
|
|
|
<entry>left</entry>
|
|
|
|
|
|
<entry>Arithmetic addition.</entry>
|
|
|
|
|
|
<entry>7</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Subtraction</entry>
|
2017-10-26 18:49:26 +00:00
|
|
|
|
<entry>
|
|
|
|
|
|
<replaceable>e1</replaceable> <literal>-</literal> <replaceable>e2</replaceable>
|
|
|
|
|
|
</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry>left</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Arithmetic subtraction.</entry>
|
|
|
|
|
|
<entry>7</entry>
|
2017-10-26 18:49:26 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>String Concatenation</entry>
|
|
|
|
|
|
<entry>
|
|
|
|
|
|
<replaceable>string1</replaceable> <literal>+</literal> <replaceable>string2</replaceable>
|
|
|
|
|
|
</entry>
|
|
|
|
|
|
<entry>left</entry>
|
|
|
|
|
|
<entry>String concatenation.</entry>
|
|
|
|
|
|
<entry>7</entry>
|
|
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
|
|
|
|
|
<entry>Not</entry>
|
2017-10-26 18:49:26 +00:00
|
|
|
|
<entry><literal>!</literal> <replaceable>e</replaceable></entry>
|
|
|
|
|
|
<entry>none</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry>Boolean negation.</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>8</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Update</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry><replaceable>e1</replaceable> <literal>//</literal>
|
|
|
|
|
|
<replaceable>e2</replaceable></entry>
|
|
|
|
|
|
<entry>right</entry>
|
|
|
|
|
|
<entry>Return a set consisting of the attributes in
|
|
|
|
|
|
<replaceable>e1</replaceable> and
|
|
|
|
|
|
<replaceable>e2</replaceable> (with the latter taking
|
|
|
|
|
|
precedence over the former in case of equally named
|
|
|
|
|
|
attributes).</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>9</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Less Than</entry>
|
2017-10-26 18:49:26 +00:00
|
|
|
|
<entry>
|
|
|
|
|
|
<replaceable>e1</replaceable> <literal><</literal> <replaceable>e2</replaceable>,
|
2019-08-23 19:50:54 +00:00
|
|
|
|
</entry>
|
|
|
|
|
|
<entry>none</entry>
|
|
|
|
|
|
<entry>Arithmetic comparison.</entry>
|
|
|
|
|
|
<entry>10</entry>
|
|
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
|
|
|
|
|
<entry>Less Than or Equal To</entry>
|
|
|
|
|
|
<entry>
|
|
|
|
|
|
<replaceable>e1</replaceable> <literal><=</literal> <replaceable>e2</replaceable>
|
|
|
|
|
|
</entry>
|
|
|
|
|
|
<entry>none</entry>
|
|
|
|
|
|
<entry>Arithmetic comparison.</entry>
|
|
|
|
|
|
<entry>10</entry>
|
|
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
|
|
|
|
|
<entry>Greater Than</entry>
|
|
|
|
|
|
<entry>
|
|
|
|
|
|
<replaceable>e1</replaceable> <literal>></literal> <replaceable>e2</replaceable>
|
|
|
|
|
|
</entry>
|
|
|
|
|
|
<entry>none</entry>
|
|
|
|
|
|
<entry>Arithmetic comparison.</entry>
|
|
|
|
|
|
<entry>10</entry>
|
|
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
|
|
|
|
|
<entry>Greater Than or Equal To</entry>
|
|
|
|
|
|
<entry>
|
2017-10-26 18:49:26 +00:00
|
|
|
|
<replaceable>e1</replaceable> <literal>>=</literal> <replaceable>e2</replaceable>
|
|
|
|
|
|
</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry>none</entry>
|
2017-10-26 18:49:26 +00:00
|
|
|
|
<entry>Arithmetic comparison.</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>10</entry>
|
|
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
|
|
|
|
|
<entry>Equality</entry>
|
|
|
|
|
|
<entry>
|
|
|
|
|
|
<replaceable>e1</replaceable> <literal>==</literal> <replaceable>e2</replaceable>
|
|
|
|
|
|
</entry>
|
|
|
|
|
|
<entry>none</entry>
|
|
|
|
|
|
<entry>Equality.</entry>
|
|
|
|
|
|
<entry>11</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Inequality</entry>
|
2017-10-26 18:49:26 +00:00
|
|
|
|
<entry>
|
|
|
|
|
|
<replaceable>e1</replaceable> <literal>!=</literal> <replaceable>e2</replaceable>
|
|
|
|
|
|
</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry>none</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Inequality.</entry>
|
|
|
|
|
|
<entry>11</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Logical And</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry><replaceable>e1</replaceable> <literal>&&</literal>
|
|
|
|
|
|
<replaceable>e2</replaceable></entry>
|
|
|
|
|
|
<entry>left</entry>
|
|
|
|
|
|
<entry>Logical AND.</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>12</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Logical Or</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry><replaceable>e1</replaceable> <literal>||</literal>
|
|
|
|
|
|
<replaceable>e2</replaceable></entry>
|
|
|
|
|
|
<entry>left</entry>
|
|
|
|
|
|
<entry>Logical OR.</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>13</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
<row>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>Logical Implication</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
<entry><replaceable>e1</replaceable> <literal>-></literal>
|
|
|
|
|
|
<replaceable>e2</replaceable></entry>
|
|
|
|
|
|
<entry>none</entry>
|
|
|
|
|
|
<entry>Logical implication (equivalent to
|
|
|
|
|
|
<literal>!<replaceable>e1</replaceable> ||
|
|
|
|
|
|
<replaceable>e2</replaceable></literal>).</entry>
|
2019-08-23 19:50:54 +00:00
|
|
|
|
<entry>14</entry>
|
2014-08-27 16:41:09 +00:00
|
|
|
|
</row>
|
|
|
|
|
|
</tbody>
|
|
|
|
|
|
</tgroup>
|
|
|
|
|
|
</table>
|
|
|
|
|
|
|
2019-08-23 19:50:54 +00:00
|
|
|
|
</section>
|
