Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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