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

CKTIS / Aprendizagem e prática

Pedimos à IA um desconto de 10%. Quanto deve ficar no talão?

Um cabaz de 100,05 USD pode custar 90,04 ou 90,05 USD depois do desconto. A diferença ajuda a escolher três testes antes de pedir uma função à IA.

CKTIS Group

Capa azul-marinho da CKTiS com o título «O desconto sobre 100,05 USD» e um ícone de código.

Numa loja, as compras a partir de 100 USD têm 10% de desconto. Se levares exatamente 100,00 USD em compras, pagas 90,00 USD. Agora acrescenta cinco cêntimos ao cabaz. Com o total em 100,05 USD, duas caixas que apliquem o desconto podem chegar a valores diferentes. Uma cobra 90,05 USD e a outra 90,04 USD.

Imagina que pediste a uma IA para escrever a função da caixa. Antes de corrigires o código, precisas de decidir qual dos dois talões está certo para esta loja. A diferença vem do momento em que arredondas.

A quem cabe o meio cêntimo?

Um dólar americano divide-se em cem cêntimos. Vamos trabalhar nessa unidade mais pequena, por isso os 100,05 USD do cabaz passam a 10005 cêntimos. Para calcular o preço final, a primeira caixa multiplica o valor por nove e divide-o por dez. Obtém 9004,5 cêntimos. Como não pode cobrar meio cêntimo, arredonda para o inteiro mais próximo e, em caso de empate, escolhe o de cima. Ficam 9005 cêntimos a pagar, ou 90,05 USD.

A segunda caixa faz a conta pela ordem que provavelmente usarias para preencher a linha «desconto» no talão. Dez por cento de 10005 são 1000,5 cêntimos. A caixa arredonda o desconto para 1001 e subtrai-o ao preço inicial. A conta dá 10005 menos 1001, ou seja, 9004 cêntimos. Aqui o cliente paga 90,04 USD. O arredondamento seguiu o mesmo critério nas duas caixas, mas só a segunda o aplicou ao desconto.

Vamos escolher a primeira opção. Na descrição da promoção escrevemos que se arredonda o preço final ao cêntimo mais próximo e que se arredonda meio cêntimo para cima. É uma instrução que podes dar à IA e uma decisão que consegues verificar à mão.

Guarda os resultados antes de pedir o código

Anota três compras com o que esperas ver no talão. Para 99,99 USD, o total continua a ser 99,99 USD. Para 100,00 USD, já deve ser 90,00 USD. Para 100,05 USD, deve ser 90,05 USD. Se gerares os valores esperados com a própria função que queres testar, ela pode repetir o mesmo erro dos dois lados da comparação.

Neste exemplo, a função recebe um número inteiro de cêntimos, entre zero e um milhão, inclusive. Devolve o preço final na mesma unidade. Os limites fazem parte do pedido. Se alguém passar 100,05 como argumento, a função tem de o rejeitar. O cabaz desse valor representa-se com o inteiro 10005.

function priceAfterDiscount(cents) {
  if (!Number.isInteger(cents) || cents < 0 || cents > 1_000_000) {
    throw new RangeError("0..1_000_000");
  }
  return cents >= 10_000 ? Math.round(cents * 9 / 10) : cents;
}

Repara na multiplicação por nove. É a parte que o cliente tem de pagar que vai ser arredondada. Assim podes comparar a linha de código com a conta que fizeste em papel. Os testes usam os talões que guardaste e verificam também se a função rejeita uma entrada inválida.

import assert from "node:assert/strict";

assert.equal(priceAfterDiscount(9_999), 9_999);
assert.equal(priceAfterDiscount(10_000), 9_000);
assert.equal(priceAfterDiscount(10_005), 9_005);

assert.equal(priceAfterDiscount(0), 0);
assert.equal(priceAfterDiscount(1_000_000), 900_000);
for (const value of [-1, 1.5, "10000", 1_000_001]) {
  assert.throws(() => priceAfterDiscount(value), RangeError);
}

Copia os dois blocos de código, pela ordem em que aparecem, para um ficheiro chamado discount.mjs. Abre o terminal na pasta onde o guardaste e executa node discount.mjs. Se todos os testes passarem, o programa termina sem escrever nada no terminal.

Para veres o que cada teste deteta, troca o operador >= por > na condição do desconto. A compra de 100,00 USD passa a custar os 100,00 USD por inteiro. O teste esperava 9000 cêntimos e recebe 10000. Uma compra de 100,05 USD continua a ter desconto, pelo que, sozinha, teria deixado passar a alteração.

Repõe o sinal original. Experimenta agora subtrair o desconto já arredondado em vez de arredondar o preço final. Antes de executar os testes, escolhe o talão que deve falhar. É o de 100,05 USD que permite distinguir as duas regras, por mais convincente que pareça a explicação da IA.