authorgravatar for squeek502@hotmail.comRyan Liptak <squeek502@hotmail.com> 2026-10-16 00:03:55-07:00
committergravatar for alex@alexrp.comAlex Rønne Petersen <alex@alexrp.com> 2026-10-22 12:21:43+02:00
log29f793b3bf0316efba5085d9c3f4c9ca98e1b2cf
tree461314d371e86f6308e527309421c5f330636b45
parenta2ce4c1bfbf28d1bd2f0b783ee6bef083327e98f

langref: another pass at the precedence tables section

1 files changed, 35 insertions(+), 16 deletions(-)

doc/langref.html.in+35-16
......@@ -1906,47 +1906,66 @@ const B = error{Two};
19061906 {#code|ambiguous_precedence_orelse.zig#}
19071907
19081908 <p>
1909 Simplified operator precedence tables are provided below, each tailored to a general group of
1910 operators. For all of the groups shown below, the operators that have higher precedence are
1911 the same, and themselves have the following precedence table:
1909 There is a set of operators (prefix operators, suffix operators, etc) that have unambiguously
1910 higher precedence than all other operators. That set of operators has the following precedence table:
19121911 </p>
19131912
19141913 <pre>{#syntax#}x() x[] x.y x.* x.?
19151914a!b
19161915x{}
1917!x -x -%x ~x &x ?x try{#endsyntax#}</pre>
1916!x -x -%x ~x &x ?x try
1917// lower precedence operators omitted{#endsyntax#}</pre>
19181918
19191919 <p>
1920 For the tables below, the operators that have ambiguous precedence or semantic errors with the
1921 given operators have been omitted, as have operators with higher precedence.
1922 The operators colored <span style="color: #C54675;">red</span> and
1923 <span style="color: #419AFF;">blue</span> have ambiguous precedence with the other operators
1924 on the same line. Those colored <span style="color: #C54675;">red</span> also have ambiguous
1920 For the other operators, simplified operator precedence tables are provided below, each containing only
1921 the information that you'll need to know when reading/writing code that uses that particular category of operators.
1922 The operators that have ambiguous precedence or semantic errors with the relevant operators have been omitted,
1923 as have the operators with higher precedence (those shown above).
1924 </p>
1925
1926 <details style="display:none;" id="ambig-details">
1927 <summary style="cursor:pointer;">Toggle operator precedence ambiguity details</summary>
1928 <p>
1929 The operators that look <span class="ambig-chain">like this</span> have ambiguous precedence with the other operators
1930 on the same line. Those that look <span class="ambig-nonchain">like this</span> also have ambiguous
19251931 precedence with themselves (they cannot be chained).
19261932 </p>
1933 </details>
1934
1935 <script>
1936 let ambig_details = document.getElementById("ambig-details");
1937 ambig_details.style.display = 'block';
1938 ambig_details.addEventListener("toggle", (event) => {
1939 document.querySelectorAll('.ambig-chain').forEach(e => { e.classList.toggle('tok-number'); });
1940 document.querySelectorAll('.ambig-nonchain').forEach(e => {
1941 e.classList.toggle('tok-number');
1942 e.style.borderBottom = ambig_details.open ? '1px dotted' : '';
1943 });
1944 });
1945 </script>
19271946
19281947 <p>
19291948 For arithmetic operators:
19301949 </p>
19311950
1932 <pre><code>* / *% *| <span style="color: #C54675;">%</span>
1951 <pre><code>* / *% *| <span class="ambig-nonchain">%</span>
19331952+ - +% -% +| -|
1934<span style="color: #C54675;">== != &lt; > &lt;= >=</span>
1935<span style="color: #419AFF;">and or</span></code></pre>
1953<span class="ambig-nonchain">==</span> <span class="ambig-nonchain">!=</span> <span class="ambig-nonchain">&lt;</span> <span class="ambig-nonchain">></span> <span class="ambig-nonchain">&lt;=</span> <span class="ambig-nonchain">>=</span>
1954<span class="ambig-chain">and or</span></code></pre>
19361955
19371956 <p>
19381957 For bitwise operators:
19391958 </p>
19401959
1941 <pre><code><span style="color: #C54675;">&lt;&lt; &lt;&lt;| >></span> <span style="color: #419AFF;">& ^ |</span>
1942<span style="color: #C54675;">== != &lt; > &lt;= >=</span>
1943<span style="color: #419AFF;">and or</span></code></pre>
1960 <pre><code><span class="ambig-nonchain">&lt;&lt;</span> <span class="ambig-nonchain">&lt;&lt;|</span> <span class="ambig-nonchain">>></span> <span class="ambig-chain">& ^ |</span>
1961<span class="ambig-nonchain">==</span> <span class="ambig-nonchain">!=</span> <span class="ambig-nonchain">&lt;</span> <span class="ambig-nonchain">></span> <span class="ambig-nonchain">&lt;=</span> <span class="ambig-nonchain">>=</span>
1962<span class="ambig-chain">and or</span></code></pre>
19441963
19451964 <p>
19461965 For null and error recovery operators:
19471966 </p>
19481967
1949 <pre><code><span style="color: #419AFF;">catch orelse</span></code></pre>
1968 <pre><code><span class="ambig-chain">catch orelse</span></code></pre>
19501969
19511970 <p>
19521971 For error set operators: