CKTIS / JavaScript
Sintaxe da negação aritmética: menos unário (`-`)
O menos unário `-x` converte um único operando num valor numérico e calcula o seu simétrico. O resultado é do tipo `Number` ou `BigInt`.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
-x
-(expression)Escreve -x para obter o simétrico do valor de x, ou -(a + b) para obter o simétrico da soma inteira. Em -4, - é um operador e não faz parte do literal numérico. Em a - b, o mesmo sinal indica uma subtração com dois operandos. A negação lógica !x devolve um booleano, enquanto --x decrementa o valor guardado e volta a escrevê-lo. -x, por si só, não faz qualquer atribuição.
O ECMAScript 2024 usa ToNumeric: primeiro obtém um valor primitivo, mantém um BigInt inalterado e, nos restantes casos, aplica ToNumber. Assim, -"4" resulta em -4 do tipo Number, -"abc" resulta em NaN e -Symbol() lança um TypeError. A conversão de um objeto pode chamar um método como Symbol.toPrimitive e propagar uma exceção lançada por esse método.
Para Number, a negação troca +0 por -0 e vice-versa; NaN mantém-se NaN. Object.is distingue os dois zeros. O resultado de -4n é um BigInt e -0n é simplesmente 0n: BigInt não tem um zero negativo distinto. O exemplo requer um ambiente de execução que suporte literais BigInt.
Uma negação sem parênteses não pode ser o operando esquerdo de **: -2 ** 2 causa um SyntaxError durante a análise sintática. (-2) ** 2 eleva a base negativa ao quadrado (4), enquanto -(2 ** 2) nega o resultado (-4). Um expoente negativo à direita é sintaticamente válido, como em 2 ** -2.
Exemplos
{
const fromString = -"4";
const fromBigInt = -4n;
const zero = 0;
const negativeZero = -zero;
console.log(`${typeof fromString} ${fromString}`);
console.log(`${typeof fromBigInt} ${fromBigInt}`);
console.log(`${Object.is(negativeZero, -0)} ${Object.is(-negativeZero, +0)}`);
}Resultado
number -4 bigint -4 true true
As duas primeiras linhas mostram o mesmo valor numérico com dois tipos diferentes. A última confirma a passagem de `+0` para `-0` e o regresso a `+0`.
Lições relacionadas
- JavaScript · Lição 35 · Avançado · Versão: 4
Fontes
- ECMAScript 2024 — Unary `-` Operator
- ECMAScript — Unary `-` Operator (living specification)
- ECMAScript 2024 — ToNumeric
- ECMAScript 2024 — ToNumber
- ECMAScript 2024 — Number::unaryMinus
- ECMAScript 2024 — BigInt::unaryMinus
- ECMAScript 2024 — Exponentiation Operator
- ECMAScript 2024 — Object.is
- ECMAScript 2024 — Number::sameValue