ran
Português

addNumSym

Acrescenta o sinal (+ ou -) a um número.

API

addNumSym

Retorna

Argumento Descrição Tipo
string O número, como string, com o sinal string

Parâmetros

Parâmetro Descrição Tipo Padrão
value Número ou string a processar string | number Obrigatório
flag Marcador de sinal (opcional, para forçá-lo) string | number Opcional

Exemplo

Uso básico

import { addNumSym } from 'ranuts';

console.log(addNumSym(100)); // '+100'
console.log(addNumSym(-50)); // '-50'
console.log(addNumSym(0)); // '0'

Entrada como string

import { addNumSym } from 'ranuts';

console.log(addNumSym('100')); // '+100'
console.log(addNumSym('-50')); // '-50' (já tem sinal, fica como está)

Forçar o sinal

import { addNumSym } from 'ranuts';

console.log(addNumSym(100, 1)); // '+100' (flag > 0)
console.log(addNumSym(100, -1)); // '100' (flag <= 0, o + não é acrescentado)
console.log(addNumSym(100, 0)); // '100'

Quando já vem com sinal

import { addNumSym } from 'ranuts';

console.log(addNumSym('+100')); // '+100' (já tem sinal, fica como está)
console.log(addNumSym('-50')); // '-50' (já tem sinal, fica como está)

Notas

  1. Regras do sinal:

    • Aos positivos é acrescentado +
    • Os negativos mantêm o -
    • O zero não leva sinal

  2. Sinal já presente: se a string começa com + ou -, nenhum outro é acrescentado.

  3. Forçar: com o argumento flag controla-se se o + entra (entra quando flag > 0).

  4. Quando usar: é comum para mostrar ganhos e perdas, variações e qualquer número em que o sinal precise aparecer.