about_Operator_Precedence
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de