about_Operator_Precedence

  • Artigo

Descrição breve

Lista os operadores do PowerShell em ordem de precedência.

Descrição longa

Os operadores do PowerShell permitem que você construa expressões simples, mas poderosas. Este tópico lista os operadores em ordem de precedência. Ordem de precedência é a ordem na qual o PowerShell avalia os operadores quando vários operadores aparecem na mesma expressão.

Quando os operadores têm precedência igual, o PowerShell os avalia da esquerda para a direita conforme aparecem na expressão. As exceções são os operadores de atribuição, os operadores de elenco e os operadores de negação (!, -not, -bnot), que são avaliados da direita para a esquerda.

Você pode usar compartimentos, como parênteses, para substituir a ordem de precedência padrão e forçar o PowerShell a avaliar a parte delimitada de uma expressão antes de uma parte não fechada.

Na lista a seguir, os operadores são listados na ordem em que são avaliados. Operadores na mesma linha, ou no mesmo grupo, têm precedência igual.

A coluna Operador lista os operadores. A coluna Referência lista o tópico da Ajuda do PowerShell no qual o operador é descrito. Para exibir o tópico, digite get-help <topic-name>.

OPERATOR REFERÊNCIA
$() @() () @{} about_Operators
. ?. (acesso de membros) about_Operators
:: (estático) about_Operators
[0] ?[0] (operador de índice) about_Operators
[int] (operadores de elenco) about_Operators
-split (unário) about_Split
-join (unário) about_Join
, (operador de vírgula) about_Operators
++ -- about_Assignment_Operators
! -not about_Logical_Operators
.. (operador de gama) about_Operators
-f (operador de formato) about_Operators
- (unário/negativo) about_Arithmetic_Operators
* / % about_Arithmetic_Operators
+ - about_Arithmetic_Operators

O seguinte grupo de operadores tem precedência igual. Suas variantes que diferenciam maiúsculas de minúsculas e explicitamente diferenciam maiúsculas de minúsculas têm a mesma precedência.

OPERATOR REFERÊNCIA
-split (binário) about_Split
-join (binário) about_Join
-is -isnot -as about_Type_Operators
-eq -ne -gt -ge -lt -le about_Comparison_Operators
-like -notlike about_Comparison_Operators
-match -notmatch about_Comparison_Operators
-in -notIn about_Comparison_Operators
-contains -notContains about_Comparison_Operators
-replace about_Comparison_Operators

A lista é retomada aqui com os seguintes operadores em ordem de precedência:

OPERATOR REFERÊNCIA
-band -bnot -bor -bxor -shr -shl about_Arithmetic_Operators
-and -or -xor about_Logical_Operators

Os itens a seguir não são operadores verdadeiros. Eles fazem parte da sintaxe de comando do PowerShell, não da sintaxe de expressão. A atribuição é sempre a última ação que acontece.

SYNTAX REFERÊNCIA
. (ponto-fonte) about_Operators
& (chamada) about_Operators
? <if-true> : <if-false> (Operador ternário) about_Operators
?? (operador null-coalese) about_Operators
| (operador de gasoduto) about_Operators
> >> 2> 2>> 2>&1 about_Redirection
&& || (operadores da cadeia de dutos) about_Operators
= += -= *= /= %= ??= about_Assignment_Operators

Exemplos

Os dois comandos a seguir mostram os operadores aritméticos e o efeito do uso de parênteses para forçar o PowerShell a avaliar a parte incluída da expressão primeiro.

PS> 2 + 3 * 4
14

PS> (2 + 3) * 4
20

O exemplo a seguir obtém os arquivos de texto somente leitura do diretório local e os salva na $read_only variável.

$read_only = Get-ChildItem *.txt | Where-Object {$_.isReadOnly}

É equivalente ao exemplo a seguir.

$read_only = ( Get-ChildItem *.txt | Where-Object {$_.isReadOnly} )

Como o operador de pipeline (|) tem uma precedência maior do que o operador de atribuição (=), os arquivos que o Get-ChildItem cmdlet obtém são enviados ao Where-Object cmdlet para filtragem antes de serem atribuídos à $read_only variável.

O exemplo a seguir demonstra que o operador de índice tem precedência sobre o operador de transmissão.

Essa expressão cria uma matriz de três cadeias de caracteres. Em seguida, ele usa o operador index com um valor de 0 para selecionar o primeiro objeto na matriz, que é a primeira cadeia de caracteres. Finalmente, ele converte o objeto selecionado como uma cadeia de caracteres. Neste caso, o elenco não surte efeito.

PS> [string]@('Windows','PowerShell','2.0')[0]
Windows

Essa expressão usa parênteses para forçar a operação de conversão a ocorrer antes da seleção de índice. Como resultado, toda a matriz é convertida como uma cadeia de caracteres (única). Em seguida, o operador de índice seleciona o primeiro item na matriz de cadeia de caracteres, que é o primeiro caractere.

PS> ([string]@('Windows','PowerShell','2.0'))[0]
W

No exemplo a seguir, como o -gt operador (maior que) tem uma precedência maior do que o -and operador (lógico E), o resultado da expressão é FALSE.

PS> 2 -gt 4 -and 1
False

É equivalente à expressão a seguir.

PS> (2 -gt 4) -and 1
False

Se o operador -and tivesse maior precedência, a resposta seria TRUE.

PS> 2 -gt (4 -and 1)
True

No entanto, este exemplo demonstra um princípio importante de gerenciamento da precedência do operador. Quando uma expressão for difícil para as pessoas interpretarem, use parênteses para forçar a ordem de avaliação, mesmo quando ela forçar a precedência do operador padrão. Os parênteses deixam suas intenções claras para as pessoas que estão lendo e mantendo seus roteiros.

Confira também