Namespaces
Variants
Views
Actions

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

From cppreference.com
< cpp‎ | language
m (Redirected page to enwiki:Rust (programming language))
(Undo revision 158679 by 0xDEADBEEF (talk))
Line 1: Line 1:
#REDIRECT [[enwiki:Rust_(programming_language)]]
+
{{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 &#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 06:32, 10 September 2023

 
 
C++ language
General topics
Flow control
Conditional execution statements
if
Iteration statements (loops)
for
range-for (C++11)
Jump statements
Functions
Function declaration
Lambda function expression
inline specifier
Dynamic exception specifications (until C++17*)
noexcept specifier (C++11)
Exceptions
Namespaces
Types
Specifiers
const/volatile
decltype (C++11)
auto (C++11)
constexpr (C++11)
consteval (C++20)
constinit (C++20)
Storage duration specifiers
Initialization
Expressions
Operators
Operator precedence
Alternative representations
Literals
Boolean - Integer - Floating-point
Character - String - nullptr (C++11)
User-defined (C++11)
Utilities
Attributes (C++11)
Types
typedef declaration
Type alias declaration (C++11)
Casts
Memory allocation
Classes
Class-specific function properties
explicit (C++11)
static

Special member functions
Templates
Miscellaneous
 
 

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 →
  1. 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).
  2. 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 += b
a -= b
a *= b
a /= b
a %= b
a &= b
a |= b
a ^= b
a <<= b
a >>= b

++a
--a
a++
a--

+a
-a
a + b
a - b
a * b
a / b
a % b
~a
a & b
a | b
a ^ b
a << b
a >> b

!a
a && b
a || b

a == b
a != b
a < b
a > b
a <= b
a >= b
a <=> b

a[...]
*a
&a
a->b
a.b
a->*b
a.*b

function call
a(...)
comma
a, b
conditional
a ? b : c
Special operators

static_cast converts one type to another related type
dynamic_cast converts within inheritance hierarchies
const_cast adds or removes cv-qualifiers
reinterpret_cast converts type to unrelated type
C-style cast converts one type to another by a mix of static_cast, const_cast, and reinterpret_cast
new creates objects with dynamic storage duration
delete destructs objects previously created by the new expression and releases obtained memory area
sizeof queries the size of a type
sizeof... queries the size of a parameter pack (since C++11)
typeid queries the type information of a type
noexcept checks if an expression can throw an exception (since C++11)
alignof queries alignment requirements of a type (since C++11)

C documentation for C operator precedence