Difference between revisions of "cpp/language/operator precedence"
0xDEADBEEF (Talk | contribs) m (Redirected page to enwiki:Rust (programming language)) |
(Undo revision 158679 by 0xDEADBEEF (talk)) |
||
Line 1: | Line 1: | ||
− | # | + | {{title|C++ Operator Precedence}} |
+ | {{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 → | ||
+ | |- | ||
+ | !rowspan=5|2 | ||
+ | |style="border-bottom-style: none"|{{tt|a++}} {{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''()}} {{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|.}} {{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}} {{tt|--a}} | ||
+ | |style="border-bottom-style: none"|Prefix {{rlp|operator incdec|increment and decrement}} | ||
+ | |style="vertical-align: top" rowspan="10"|Right-to-left ← | ||
+ | |- | ||
+ | |style="border-bottom-style: none; border-top-style: none"|{{tt|+a}} {{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|!}} {{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}} {{rlpt|new|new[]}} | ||
+ | |style="border-bottom-style: none; border-top-style: none"|{{rlp|new|Dynamic memory allocation}} | ||
+ | |- | ||
+ | |style="border-top-style: none"|{{rlpt|delete}} {{rlpt|delete|delete[]}} | ||
+ | |style="border-top-style: none"|{{rlp|delete|Dynamic memory deallocation}} | ||
+ | |- | ||
+ | !4 | ||
+ | |{{tt|.*}} {{tt|->*}} | ||
+ | |{{rlp|operator_member_access#Built-in_pointer-to-member_access_operators|Pointer-to-member}} | ||
+ | |style="vertical-align: top" rowspan="12"|Left-to-right → | ||
+ | |- | ||
+ | !5 | ||
+ | |{{tt|a*b}} {{tt|a/b}} {{tt|a%b}} | ||
+ | |{{rlp|operator_arithmetic#Multiplicative_operators|Multiplication, division, and remainder}} | ||
+ | |- | ||
+ | !6 | ||
+ | |{{tt|a+b}} {{tt|a-b}} | ||
+ | |{{rlp|operator_arithmetic#Additive_operators|Addition and subtraction}} | ||
+ | |- | ||
+ | !7 | ||
+ | |{{tt|<<}} {{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|<}} {{tt|1= <=}} {{tt|>}} {{tt|1= >=}} | ||
+ | |For {{rlp|operator_comparison|relational operators}} < and ≤ and > and ≥ respectively | ||
+ | |- | ||
+ | !10 | ||
+ | |{{tt|1= ==}} {{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 ← | ||
+ | |- | ||
+ | |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= +=}} {{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= *=}} {{tt|1= /=}} {{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= <<=}} {{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= &=}} {{tt|1= ^=}} {{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 → | ||
+ | |} | ||
+ | <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 06:32, 10 September 2023
The following table lists the precedence and associativity of C++ operators. Operators are listed top to bottom, in descending precedence.
Precedence | Operator | Description | Associativity |
---|---|---|---|
1 | ::
|
Scope resolution | Left-to-right → |
2 | a++ a--
|
Suffix/postfix increment and decrement | |
type() type{}
|
Functional cast | ||
a()
|
Function call | ||
a[]
|
Subscript | ||
. ->
|
Member access | ||
3 | ++a --a
|
Prefix increment and decrement | Right-to-left ← |
+a -a
|
Unary plus and minus | ||
! ~
|
Logical NOT and bitwise NOT | ||
(type)
|
C-style cast | ||
*a
|
Indirection (dereference) | ||
&a
|
Address-of | ||
sizeof
|
Size-of[note 1] | ||
co_await | await-expression (C++20) | ||
new new[]
|
Dynamic memory allocation | ||
delete delete[]
|
Dynamic memory deallocation | ||
4 | .* ->*
|
Pointer-to-member | Left-to-right → |
5 | a*b a/b a%b
|
Multiplication, division, and remainder | |
6 | a+b a-b
|
Addition and subtraction | |
7 | << >>
|
Bitwise left shift and right shift | |
8 | <=>
|
Three-way comparison operator (since C++20) | |
9 | < <= > >=
|
For relational operators < and ≤ and > and ≥ respectively | |
10 | == !=
|
For equality operators = and ≠ respectively | |
11 | a&b
|
Bitwise AND | |
12 | ^
|
Bitwise XOR (exclusive or) | |
13 | |
|
Bitwise OR (inclusive or) | |
14 | &&
|
Logical AND | |
15 | ||
|
Logical OR | |
16 | a?b:c
|
Ternary conditional[note 2] | Right-to-left ← |
throw
|
throw operator | ||
co_yield | yield-expression (C++20) | ||
=
|
Direct assignment (provided by default for C++ classes) | ||
+= -=
|
Compound assignment by sum and difference | ||
*= /= %=
|
Compound assignment by product, quotient, and remainder | ||
<<= >>=
|
Compound assignment by bitwise left shift and right shift | ||
&= ^= |=
|
Compound assignment by bitwise AND, XOR, and OR | ||
17 | ,
|
Comma | Left-to-right → |
- ↑ The operand of
sizeof
can't be a C-style type cast: the expression sizeof (int) * p is unambiguously interpreted as (sizeof(int)) * p, but not sizeof((int)*p). - ↑ The expression in the middle of the conditional operator (between
?
and:
) is parsed as if parenthesized: its precedence relative to?:
is ignored.
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 std::cout << a & b and *p++ are parsed as (std::cout << a) & b and *(p++), and not as std::cout << (a & b) or (*p)++.
Operators that have the same precedence are bound to their arguments in the direction of their associativity. For example, the expression a = b = c is parsed as a = (b = c), and not as (a = b) = c because of right-to-left associativity of assignment, but a + b - c is parsed (a + b) - c and not 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 (delete ++*p is delete(++(*p))) and unary postfix operators always associate left-to-right (a[1][2]++ is ((a[1])[2])++). Note that the associativity is meaningful for member access operators, even though they are grouped with unary postfix operators: a.b++ is parsed (a.b)++ and not a.(b++).
Operator precedence is unaffected by operator overloading. For example, std::cout << a ? b : c; parses as (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 order of evaluation, which is a runtime concept.
The standard itself doesn't specify precedence levels. They are derived from the grammar.
const_cast
, static_cast
, dynamic_cast
, reinterpret_cast
, typeid
, sizeof...
, noexcept
and alignof
are not included since they are never ambiguous.
Some of the operators have alternate spellings (e.g., and for &&
, or for ||
, not for !
, etc.).
In C, the ternary conditional operator has higher precedence than assignment operators. Therefore, the expression e = a < d ? a++ : a = d, which is parsed in C++ as 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
Common operators | ||||||
---|---|---|---|---|---|---|
assignment | increment decrement |
arithmetic | logical | comparison | member access |
other |
a = b |
++a |
+a |
!a |
a == b |
a[...] |
function call |
a(...) | ||||||
comma | ||||||
a, b | ||||||
conditional | ||||||
a ? b : c | ||||||
Special operators | ||||||
static_cast converts one type to another related type |
C documentation for C operator precedence
|