Skip to content

Clarify operator precedence terminology and improve examples in Visual Basic documentation #48257

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Sep 8, 2025
Merged

Clarify operator precedence terminology and improve examples in Visual Basic documentation #48257

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
c286c1e
Initial plan
Copilot Sep 4, 2025
bbf21af
Clarify operator precedence terminology and improve examples
Copilot Sep 4, 2025
ddc3e3e
Add numerical indices to precedence order headings for clarity
Copilot Sep 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 9 additions & 7 deletions docs/visual-basic/language-reference/operators/operator-precedence.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ When several operations occur in an expression, each part is evaluated and resol

When expressions contain operators from more than one category, they are evaluated according to the following rules:

- The arithmetic and concatenation operators have the order of precedence described in the following section, and all have greater precedence than the comparison, logical, and bitwise operators.
- The arithmetic and concatenation operators have the order of precedence described in the following section, and all have greater precedence than the comparison, logical, and bitwise operators. Higher precedence means these operators are evaluated first.

- All comparison operators have equal precedence, and all have greater precedence than the logical and bitwise operators, but lower precedence than the arithmetic and concatenation operators.

Expand All @@ -34,13 +34,13 @@ When several operations occur in an expression, each part is evaluated and resol

## Precedence Order

Operators are evaluated in the following order of precedence:
Operators are evaluated in the following order of precedence. Operators listed first have higher precedence and are evaluated before operators listed later:

### Await Operator
### 1. Await Operator

Await

### Arithmetic and Concatenation Operators
### 2. Arithmetic and Concatenation Operators

Exponentiation (`^`)

Expand All @@ -58,11 +58,11 @@ When several operations occur in an expression, each part is evaluated and resol

Arithmetic bit shift (`<<`, `>>`)

### Comparison Operators
### 3. Comparison Operators

All comparison operators (`=`, `<>`, `<`, `<=`, `>`, `>=`, `Is`, `IsNot`, `Like`, `TypeOf`...`Is`)

### Logical and Bitwise Operators
### 4. Logical and Bitwise Operators

Negation (`Not`)

Expand Down Expand Up @@ -108,7 +108,9 @@ e = 1.0
f = a - b + c / d * e
' The preceding line sets f to 7.0. Because of natural operator
' precedence and associativity, it is exactly equivalent to the
' following line.
' following line. Division and multiplication (/, *) have higher
' precedence than addition and subtraction (+, -), so c / d * e
' is evaluated first, then the addition and subtraction from left to right.
f = (a - b) + ((c / d) * e)
' The following line overrides the natural operator precedence
' and left associativity.
Expand Down