Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/language/operator precedence"

From cppreference.com
< cpp‎ | languageRedirect page
m (fmt)
m (Redirected page to enwiki:Rust (programming language))
Line 1: Line 1:
{{title|C++ Operator Precedence}}
+
#REDIRECT [[enwiki:Rust_(programming_language)]]
{{cpp/language/expressions/navbar}}
+
The following table lists the precedence and associativity of C++ operators. Operators are listed top to bottom, in descending precedence.
+
 
+
{|class="wikitable"
+
|-
+
!style="text-align: left"|Precedence
+
!style="text-align: left"|Operator
+
!style="text-align: left"|Description
+
!style="text-align: left"|Associativity
+
|-
+
!1<!-- Numbering should start from the highest precedence. See also the discussion page. -->
+
|{{tt|::}}
+
|{{rlp|identifiers#Qualified_identifiers|Scope resolution}}
+
|style="vertical-align: top" rowspan="6"|Left-to-right &#8594;
+
|-
+
!rowspan=5|2
+
|style="border-bottom-style: none"|{{tt|a++}} &nbsp; {{tt|a--}}
+
|style="border-bottom-style: none"|Suffix/postfix {{rlp|operator incdec|increment and decrement}}
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|''type''()}} &nbsp; {{tt|''type''{} }}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|explicit cast|Functional cast}}
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|a()}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|operator_other#Built-in_function_call_operator|Function call}}
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|a[]}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|operator_member_access#Built-in_subscript_operator|Subscript}}
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|.}} &nbsp; {{tt|->}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|operator_member_access#Built-in_member_access_operators|Member access}}
+
|-
+
!rowspan=10|3
+
|style="border-bottom-style: none"|{{tt|++a}} &nbsp; {{tt|--a}}
+
|style="border-bottom-style: none"|Prefix {{rlp|operator incdec|increment and decrement}}
+
|style="vertical-align: top" rowspan="10"|Right-to-left &#8592;
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|+a}} &nbsp; {{tt|-a}}
+
|style="border-bottom-style: none; border-top-style: none"|Unary {{rlp|operator_arithmetic#Unary_arithmetic_operators|plus and minus}}
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|!}} &nbsp; {{tt|~}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|operator logical|Logical NOT}} and {{rlp|operator_arithmetic#Bitwise_logic_operators|bitwise NOT}}
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|(''type'')}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|explicit cast|C-style cast}}
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|*a}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|operator_member_access#Built-in_indirection_operator|Indirection}} (dereference)
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|&a}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|operator_member_access#Built-in_address-of_operator|Address-of}}
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{rlpt|sizeof}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|sizeof|Size-of}}<ref group="note">The operand of {{tt|sizeof}} can't be a C-style type cast: the expression {{c|sizeof (int) * p}} is unambiguously interpreted as {{c|(sizeof(int)) * p}}, but not {{c|sizeof((int)*p)}}.</ref>
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{ltt|cpp/keyword/co_await}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|coroutines|await-expression}} {{mark c++20}}
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{rlpt|new}} &nbsp; {{rlpt|new|new[]}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|new|Dynamic memory allocation}}
+
|-
+
|style="border-top-style: none"|{{rlpt|delete}} &nbsp; {{rlpt|delete|delete[]}}
+
|style="border-top-style: none"|{{rlp|delete|Dynamic memory deallocation}}
+
|-
+
!4
+
|{{tt|.*}} &nbsp; {{tt|->*}}
+
|{{rlp|operator_member_access#Built-in_pointer-to-member_access_operators|Pointer-to-member}}
+
|style="vertical-align: top" rowspan="12"|Left-to-right &#8594;
+
|-
+
!5
+
|{{tt|a*b}} &nbsp; {{tt|a/b}} &nbsp; {{tt|a%b}}
+
|{{rlp|operator_arithmetic#Multiplicative_operators|Multiplication, division, and remainder}}
+
|-
+
!6
+
|{{tt|a+b}} &nbsp; {{tt|a-b}}
+
|{{rlp|operator_arithmetic#Additive_operators|Addition and subtraction}}
+
|-
+
!7
+
|{{tt|<<}} &nbsp; {{tt|>>}}
+
|Bitwise {{rlp|operator_arithmetic#Bitwise_shift_operators|left shift and right shift}}
+
|-
+
!8
+
|{{tt|1= <=>}}
+
|[[cpp/language/operator_comparison#Three-way_comparison|Three-way comparison operator]] {{mark since c++20}}
+
|-
+
!9
+
|{{tt|<}} &nbsp; {{tt|1= <=}} &nbsp; {{tt|>}} &nbsp; {{tt|1= >=}}
+
|For {{rlp|operator_comparison|relational operators}} < and ≤ and > and ≥ respectively
+
|-
+
!10
+
|{{tt|1= ==}} &nbsp; {{tt|1= !=}}
+
|For {{rlp|operator_comparison|equality operators}} = and ≠ respectively
+
|-
+
!11
+
|{{tt|a&b}}
+
|{{rlp|operator_arithmetic#Bitwise_logic_operators|Bitwise AND}}
+
|-
+
!12
+
|{{tt|^}}
+
|{{rlp|operator_arithmetic#Bitwise_logic_operators|Bitwise XOR}} (exclusive or)
+
|-
+
!13
+
|<code><nowiki>|</nowiki></code>
+
|{{rlp|operator_arithmetic#Bitwise_logic_operators|Bitwise OR}} (inclusive or)
+
|-
+
!14
+
|{{tt|&&}}
+
|{{rlp|operator_logical|Logical AND}}
+
|-
+
!15
+
|<code><nowiki>||</nowiki></code>
+
|{{rlp|operator_logical|Logical OR}}
+
|-
+
!rowspan=8|16
+
|style="border-bottom-style: none"|{{tt|a?b:c}}
+
|style="border-bottom-style: none"|{{rlp|operator_other#Conditional_operator|Ternary conditional}}<ref group="note">The expression in the middle of the conditional operator (between {{ttb|?}} and {{ttb|:}}) is parsed as if parenthesized: its precedence relative to {{ttb|?:}} is ignored.</ref>
+
|style="vertical-align: top" rowspan="8"|Right-to-left &#8592;
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{rlpt|throw}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|throw|throw operator}}
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{ltt|cpp/keyword/co_yield}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|coroutines|yield-expression}} {{mark c++20}}
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|1= =}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|operator_assignment#Builtin_direct_assignment|Direct assignment}} (provided by default for C++ classes)
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|1= +=}} &nbsp; {{tt|1= -=}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|operator_assignment#Builtin_compound_assignment|Compound assignment}} by sum and difference
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|1= *=}} &nbsp; {{tt|1= /=}} &nbsp; {{tt|1= %=}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|operator_assignment#Builtin_compound_assignment|Compound assignment}} by product, quotient, and remainder
+
|-
+
|style="border-bottom-style: none; border-top-style: none"|{{tt|1= <<=}} &nbsp; {{tt|1= >>=}}
+
|style="border-bottom-style: none; border-top-style: none"|{{rlp|operator_assignment#Builtin_compound_assignment|Compound assignment}} by bitwise left shift and right shift
+
|-
+
|style="border-top-style: none"|{{tt|1= &=}} &nbsp; {{tt|1= ^=}} &nbsp; {{tt|1= {{!}}=}}
+
|style="border-top-style: none"|{{rlp|operator_assignment#Builtin_compound_assignment|Compound assignment}} by bitwise AND, XOR, and OR
+
|-
+
!17
+
|{{tt|,}}
+
|{{rlp|operator_other#Built-in_comma_operator|Comma}}
+
|Left-to-right &#8594;
+
|}
+
<references group="note" />
+
 
+
When parsing an expression, an operator which is listed on some row of the table above with a precedence will be bound tighter (as if by parentheses) to its arguments than any operator that is listed on a row further below it with a lower precedence. For example, the expressions {{c|std::cout << a & b}} and  {{c|*p++}} are parsed as {{c|(std::cout << a) & b}} and {{c|*(p++)}}, and not as {{c|std::cout << (a & b)}} or {{c|(*p)++}}.
+
 
+
Operators that have the same precedence are bound to their arguments in the direction of their associativity. For example, the expression {{c|1=a = b = c}} is parsed as {{c|1=a = (b = c)}}, and not as {{c|1=(a = b) = c}} because of right-to-left associativity of assignment, but {{c|a + b - c}} is parsed {{c|(a + b) - c}} and not {{c|a + (b - c)}} because of left-to-right associativity of addition and subtraction.
+
 
+
Associativity specification is redundant for unary operators and is only shown for completeness: unary prefix operators always associate right-to-left ({{c|delete ++*p}} is {{c|delete(++(*p))}}) and unary postfix operators always associate left-to-right ({{c|a[1][2]++}} is {{c|((a[1])[2])++}}). Note that the associativity is meaningful for member access operators, even though they are grouped with unary postfix operators: {{c|a.b++}} is parsed {{c|(a.b)++}} and not {{c|a.(b++)}}.
+
 
+
Operator precedence is unaffected by {{rlp|operators|operator overloading}}. For example, {{c|std::cout << a ? b : c;}} parses as {{c|(std::cout << a) ? b : c;}} because the precedence of arithmetic left shift is higher than the conditional operator.
+
 
+
===Notes===
+
Precedence and associativity are compile-time concepts and are independent from {{rlp|eval_order|order of evaluation}}, which is a runtime concept.
+
 
+
The standard itself doesn't specify precedence levels. They are derived from the grammar.
+
 
+
{{rlpt|const_cast}}, {{rlpt|static_cast}}, {{rlpt|dynamic_cast}}, {{rlpt|reinterpret_cast}}, {{rlpt|typeid}}, {{rlpt|sizeof...}}, {{rlpt|noexcept}} and {{rlpt|alignof}} are not included since they are never ambiguous.
+
 
+
Some of the operators have {{rlp|operator_alternative|alternate spellings}} (e.g., {{c|and}} for {{tt|&&}}, {{c|or}} for {{tt|{{!!}}}}, {{c|not}} for {{tt|!}}, etc.).
+
 
+
In C, the ternary conditional operator has higher precedence than assignment operators. Therefore, the expression {{c|1=e = a < d ? a++ : a = d}}, which is parsed in C++ as {{c|1=e = ((a < d) ? (a++) : (a = d))}}, will fail to compile in C due to grammatical or semantic constraints in C. See the corresponding C page for details.
+
 
+
===See also===
+
{{cpp/language/operators}}
+
{{dsc begin}}
+
{{dsc see c|c/language/operator_precedence|C operator precedence|nomono=true}}
+
{{dsc end}}
+
 
+
{{langlinks|ar|cs|de|es|fr|it|ja|ko|pt|ru|tr|zh}}
+

Revision as of 09:15, 31 July 2023