Predefinição:Divide/doc

Descrição

Esta predefinição divide um número A qualquerPredefinição:Nota de rodapé por um outro número B qualquer.Predefinição:Nota de rodapé No caso, A e B são números inteiros e/ou reais: pouco importa se A é inteiro ou real e se B é inteiro ou real.

Predefinição:Início destaque $\frac{A}{B}$ é uma fração com numerador A e denominador B Predefinição:Fim destaque

Além de dividir um número pelo outro, esta predefinição também é capaz de:

• Arredondar o resultado dessa divisão, para que ele seja exibido somente com uma quantidade N de casas decimais.
• Formatar esse resultado com a predefinição Predefinição:T.
• Converter o resultado em valor percentual.

Pode-se somente arredondar o resultado da divisão (sem se ter que formatar, tampouco converter em porcentagem). Também pode-se somente formatar (sem se ter que arredondar, tampouco converter em porcentagem). Enfim: esses recursos são independentes.

Predefinição:Início destaque Em síntese: para dividir A por B, arredondar o resultado dessa divisão de modo a exibir somente a parte inteira mais as N casas decimais à direita da vírgula, e então formatar o resultado desse arredondamento, basta grafar o seguinte:

{{Divide|A|B|N|formatar}}

Ou, convertido em porcentagem:

{{Divide|A|B|N|formatar|porcentagem}} Predefinição:Fim destaque

Parâmetros

• Parâmetro num.
  • Sinônimos: numerador, dividendo.
  • Ordem desse parâmetro: 1º, da esquerda para a direita.
  • Função: numerador da divisão.
  • Tipo de argumento (valor) que aceita: número inteiro ou número real.
  • Obrigatório: sim.

• Parâmetro den.
  • Sinônimos: denominador, divisor.
  • Ordem desse parâmetro: 2º, da esquerda para a direita.
  • Função: denominador da divisão.
  • Tipo de argumento (valor) que aceita: número inteiro ou número real.
  • Obrigatório: sim.

• Parâmetro casas.
  • Sinônimos: c, arred, dec, decimais.
  • Ordem desse parâmetro: 3º, da esquerda para a direita.
  • Função: quantidade de casas decimais que devem restar após o arredondamento (caso ele seja executado).
  • Tipo de argumento (valor) que aceita: número inteiro. Exceção: o número real 0.0 é aceito. Idem qualquer número real que se reduza ao zero inteiro. Exemplos: 0.00, 0.000, 0.0000, 00.0, 000.0, 0000.0, 00.00, 000.000, 0000.0000 etc.
  • Obrigatório: não.

• Parâmetro formatar.
  • Sinônimos: f, formata.
  • Ordem desse parâmetro: 4º, da esquerda para a direita.
  • Função: define se o resultado da divisão (independentemente de haver sido arredondado ou não) deverá ser formatado com Predefinição:T.
  • Tipo de argumento (valor) que aceita: qualquer uma das seguintes strings (sequências de caracteres): s, sim, f, formata, formatar.
    • Sensibilidade a maiúsculas e minúsculas: não há. Tanto faz informar o valor "s", "S", "sim", "SIM", "Sim", "SiM", "sIM", "f", "F", "formata", "FORMATA", "formatar", "FORMAtar", "FoRmAtAr" etc. Qualquer um funcionará.
  • Obrigatório: não.

• Parâmetro porcentagem.
  • Sinônimos: p, por, %.
  • Ordem desse parâmetro: 5º, da esquerda para a direita.
  • Função: converte o resultado da divisão em porcentagem, independentemente de esse resultado haver sido arredondado ou não e haver sido formatado ou não.
  • Tipo de argumento (valor) que aceita: qualquer uma das seguintes strings (sequências de caracteres): s, sim, p, por, porcentagem, %.
    • Sensibilidade a maiúsculas e minúsculas: não há. Tanto faz informar o valor "s", "S", "sim", "Sim", "SIM", "SiM", "sIm", "p", "P", "por", "POR", "PoR", "pOr", "porcentagem", "Porcentagem", "PORCENTAGEM" etc. Qualquer um funcionará.
  • Obrigatório: não.

Observe que os parâmetros podem ser declarados ou explicitamentePredefinição:Nota de rodapé ou implicitamente,Predefinição:Nota de rodapé e que quando declarados implicitamente a ordem ou posição de cada valor atribuído a cada parâmetro é crucial para o correto funcionamento da predefinição.

Sintaxe

Predefinição:Início destaque A predefinição pode ser grafada com os parâmetros declarados explicitamente. Exemplo:

{{Divide |numerador=100 |denominador=7 |casas=3 |f=formatar |porcentagem=%}}

A predefinição também pode ser grafada com os parâmetros declarados implicitamente. Exemplo:

{{Divide |100 |7 |3 |formatar |%}} Predefinição:Fim destaque

Recursos e restrições

• Números negativos podem ser usados tanto no numerador quanto no denominador.
• Para separar os decimais é necessário utilizar ponto, ao invés de vírgula.
• O numerador (dividendo) tem que ser informado, tem que ser um número (inteiro ou real) e não pode ser zero.
• O denominador (divisor) também tem que ser informado, também tem que ser um número (inteiro ou real) e também não pode ser zero.
• Não é necessário arredondar o resultado. Porém, caso deseje arredondá-lo, a quantidade de casas decimais a ser informada terá que ser um número inteiro.
• Também não é necessário formatar o resultado (independentemente de esse resultado estar ou não estar arredondado). Porém, caso decida formatá-lo, o código a ser informado deverá ser um dos que são aceitos.
• Se ao parâmetro porcentagem for atribuído um valor inválido (ou seja: se ele não receber um dos valores que são aceitos), a predefinição não irá emitir aviso/alerta nenhum: ela irá simplesmente ignorar esse parâmetro e executar a divisão normalmente — sem converter o resultado em valor percentual.
• Toda calculadora possui um limite de algarismos (ou dígitos) com que consegue operar em ponto flutuante, e com os computadores da Wikimedia não é diferente: independentemente do cálculo realizado com esta predefinição, a quantidade máxima de dígitos suportada para cada número é 14 (catorze) dígitos: já considerados os dígitos à esquerda e à direita da vírgula.Predefinição:Nota de rodapé Consequentemente, nem o numerador nem o denominador pode ter mais de 14 dígitos: a predefinição retornará algum erro, caso se tente usar algum número que possua mais de 14 dígitos. Por exemplo: o número 12.3456789012345, embora "pequeno", possui 15 dígitos, e isso, para o computador, representa um número "grande", porque ele tem uma quantidade de dígitos que é muito grande para a calculadora do computador da Wikimedia (o número é quantitativamente pequeno, porém é muito extenso, e a calculadora interna não possui "memória" suficiente para armazenar um número tão extenso e realizar operações aritméticas com ele). Consequentemente, a predefinição retornará algum erro, caso se tente usar aquele número.
• Observe, ainda, que embora todos os números a seguir sejam diferentes, todos eles possuem exatamente 14 dígitos numéricos, e por isto qualquer um deles funcionará corretamente com a predefinição:

• 9.5731641398745
• 95.731641398745
• 957.31641398745
• 9573.1641398745
• 95731.641398745
• 957316.41398745
• 9573164.1398745
• 95731641.398745
• 957316413.98745
• 9573164139.8745
• 95731641398.745
• 957316413987.45
• 9573164139874.5
• 95731641398745

• Por fim observe que, para fins de cálculo, a calculadora considera que o número 0.000000000000012345678901234, por exemplo, tem 14 dígitos. Isso ocorre porque, da direita para a esquerda, a calculadora despreza todos os zeros que estejam à esquerda do último dígito não nulo. Consequentemente, o código {{Divide |0.000000000000012345678901234 |1}}, por exemplo, será executado corretamente pela calculadora e resultará em Predefinição:Divide, que em sintaxe matemática equivale a:

$\frac{1.2345678901234}{10^{14}}$

Exemplos

Com parâmetros

Quando os parâmetros são declarados explicitamente, como nos exemplos abaixo, a ordem em que eles aparecem na predefinição é irrelevante. Portanto, embora a ordem original dos parâmetros seja numerador, denominador, casas, formatar e porcentagem, a predefinição funcionará do mesmo jeito caso os parâmetros sejam explicitamente declarados em posições diferentes — contanto que os parâmetros obrigatórios numerador e denominador não deixem de ser declarados.

• Dividir 2 por 4:

Código: {{Divide |numerador=2 |denominador=4}}

Resultado: Predefinição:Divide

• Dividir -3 por 5 (sem arredondar nem formatar):Predefinição:Nota de rodapé

Código: {{Divide |num=-3 |den=5}}

Resultado: Predefinição:Divide

• Dividir -76543.2 por -10.98 sem arredondar nem formatar o resultado:

Código: {{Divide |num=-76543.2 |den=-10.98}}

Resultado: Predefinição:Divide

• Dividir -76543.2 por -10.98 e formatar o resultado:

Código: {{Divide |num=-76543.2 |den=-10.98 |formatar=sim}}

Resultado: Predefinição:Divide

• Repetindo o cálculo acima, só que mudando a posição dos parâmetros declarados explicitamente:Predefinição:Nota de rodapé

Código: {{Divide |formatar=sim |den=-10.98 |num=-76543.2}}

Resultado: Predefinição:Divide

• Dividir -7.65 por 10.98, arredondar para três casas decimais, converter o resultado em porcentagem e então formatá-lo:Predefinição:Nota de rodapé

Código: {{Divide |num=-7.65 |den=10.98 |arred=3 |formatar=sim |porcentagem=%}}

Resultado: Predefinição:Divide

• Dividir -1776 por 15.52 sem formatar nem arredondar:

Código: {{Divide |num=-1776 |den=15.52}}

Resultado: Predefinição:Divide

• Dividir -1776 por 15.52 sem arredondar, mas formatando:Predefinição:Nota de rodapé

Código: {{Divide |num=-1776 |den=15.52 |formatar=s}}

Resultado: Predefinição:Divide

• Mesmo cálculo que acima, porém arredondando para 3 casas decimais:

Código: {{Divide |num=-1776 |den=15.52 |casas=3 |formatar=s}}

Resultado: Predefinição:Divide

• Mesmo cálculo novamente, porém arredondando para apenas 1 casa decimal:

Código: {{Divide |num=-1776 |den=15.52 |casas=1 |formatar=s}}

Resultado: Predefinição:Divide

• Mesmo cálculo novamente, porém arredondando para não mostrar nenhuma casa decimal (o número real/decimal é convertido em número inteiro):Predefinição:Nota de rodapé

Código: {{Divide |num=-1776 |den=15.52 |arred=0 |formatar=s}}

Resultado: Predefinição:Divide

• Mesmo cálculo novamente, mas agora vamos arredondar para não exibir nenhuma casa decimal e além disso ignorar os valores das duas casas à esquerda da vírgula, ou seja, ignorar as unidades e as dezenas e com isto preservar o resultado, da direita para a esquerda, somente a partir da casa das centenas:

Código: {{Divide |num=-1776 |den=15.52 |arred=-2 |formatar=s}}

Resultado: Predefinição:Divide

• Repetição do cálculo acima, porém convertendo o resultado em porcentagem:Predefinição:Nota de rodapé

Código: {{Divide |num=-1776 |den=15.52 |arred=-2 |formatar=s |porcentagem=p}}

Resultado: Predefinição:Divide

Contextos que retornarão erro

• Não informar parâmetro nenhum:

Código: {{Divide}}

Resultado: Predefinição:Divide

• Deixar o numerador em branco:

Código: {{Divide |den=14}}

Resultado: Predefinição:Divide

• Atribuir valor zero ao numerador:

Código: {{Divide |num=0 |den=14}}

Resultado: Predefinição:Divide

• Atribuir ao numerador um valor que não é numérico:

Código: {{Divide |num=Y |den=14}}

Resultado: Predefinição:Divide

• Atribuir valor zero ao denominador:

Código: {{Divide |num=-333.7 |den=0}}

Resultado: Predefinição:Divide

• Atribuir ao denominador um valor que não é numérico:

Código: {{Divide |num=-333.7 |den=$}}

Resultado: Predefinição:Divide

• Declarar o parâmetro casas porém atribuir a ele um número real, ao invés de um número inteiro de casas decimais:

Código: {{Divide |num=-333.7 |den=14 |casas=2.4}}

Resultado: Predefinição:Divide

• Declarar o parâmetro casas porém atribuir a ele um valor que não é sequer numérico:

Código: {{Divide |num=-333.7 |den=14 |casas=@}}

Resultado: Predefinição:Divide

• Declarar o parâmetro formatar porém atribuir a ele um valor inválido:

Código: {{Divide |num=-333.7 |den=14 |casas=2 |formatar=!}}

Resultado: Predefinição:Divide

• Declarar um ou mais parâmetros explicitamente, porém também declarar um ou mais parâmetros implicitamente:

Código: {{Divide |num=-333.7 |den=14 |2}}

Resultado: Predefinição:DividePredefinição:Nota de rodapé

• Informar à predefinição que execute um cálculo com um numerador que possua mais de 14 dígitos:

Código: {{Divide |num=1234567.89012345 |den=10}}

Resultado: Predefinição:Divide

• Informar à predefinição que execute um cálculo com um denominador que possua mais de 14 dígitos:

Código: {{Divide |num=10 |den=1234567.89012345}}

Resultado: Predefinição:Divide

Sem parâmetros

Quando os parâmetros são declarados implicitamente, como nos exemplos abaixo, a ordem ou posição em que o valor de cada parâmetro aparece na predefinição é crucial: a ordem original dos parâmetros — que é numerador, denominador, casas, formatar e porcentagem — tem que ser seguida à risca. Caso contrário, a predefinição não funcionará como esperado.

• Dividir 2 por 4:

Código: {{Divide |2 |4}}

Resultado: Predefinição:Divide

• Dividir -3 por 5 (sem arredondar nem formatar):

Código: {{Divide |-3 |5}}

Resultado: Predefinição:Divide

• Dividir -76543.2 por -10.98 sem arredondar nem formatar o resultado:

Código: {{Divide |-76543.2 |-10.98}}

Resultado: Predefinição:Divide

• Dividir -76543.2 por -10.98 e formatar o resultado:Predefinição:Nota de rodapé

Código: {{Divide |-76543.2 |-10.98 | |formatar}}

Resultado: Predefinição:Divide

• Repetindo o cálculo acima, só que mudando a posição dos valores:Predefinição:Nota de rodapé

Código: {{Divide |-10.98 |-76543.2 | |formatar}}

Resultado: Predefinição:Divide

• Dividir -7.65 por 10.98, arredondar para três casas decimais, converter o resultado em porcentagem e então formatá-lo:

Código: {{Divide |-7.65 |10.98 |3 |f |%}}

Resultado: Predefinição:Divide

• Dividir -1776 por 15.52 sem formatar nem arredondar:

Código: {{Divide |-1776 |15.52}}

Resultado: Predefinição:Divide

• Dividir -1776 por 15.52 sem arredondar, mas formatando:

Código: {{Divide |-1776 |15.52 | |formatar}}

Resultado: Predefinição:Divide

• Mesmo cálculo que acima, porém arredondando para 3 casas decimais:

Código: {{Divide |-1776 |15.52 |3 |formatar}}

Resultado: Predefinição:Divide

• Mesmo cálculo novamente, porém arredondando para apenas 1 casa decimal:

Código: {{Divide |-1776 |15.52 |1 |formatar}}

Resultado: Predefinição:Divide

• Mesmo cálculo novamente, porém arredondando para não mostrar nenhuma casa decimal (o número real/decimal é convertido em número inteiro):

Código: {{Divide |-1776 |15.52 |0 |formatar}}

Resultado: Predefinição:Divide

• Mesmo cálculo novamente, mas agora vamos arredondar para não exibir nenhuma casa decimal e além disso ignorar os valores das duas casas à esquerda da vírgula, ou seja, ignorar as unidades e as dezenas e com isto preservar o resultado, da direita para a esquerda, somente a partir da casa das centenas:

Código: {{Divide |-1776 |15.52 |-2 |formatar}}

Resultado: Predefinição:Divide

• Repetição do cálculo acima, porém convertendo o resultado em porcentagem:

Código: {{Divide |-1776 |15.52 |-2 |f |%}}

Resultado: Predefinição:Divide

Contextos que retornarão erro

• Não informar valor de parâmetro nenhum:

Código: {{Divide}}

Resultado: Predefinição:Divide

• Deixar o numerador em branco:

Código: {{Divide | |14}}

Resultado: Predefinição:Divide

• Atribuir valor zero ao numerador:

Código: {{Divide |0 |14}}

Resultado: Predefinição:Divide

• Atribuir ao numerador um valor que não é numérico:

Código: {{Divide |Y |14}}

Resultado: Predefinição:Divide

• Atribuir valor zero ao denominador:

Código: {{Divide |-333.7 |0}}

Resultado: Predefinição:Divide

• Atribuir ao denominador um valor que não é numérico:

Código: {{Divide |-333.7 |$}}

Resultado: Predefinição:Divide

• Declarar o valor do parâmetro casas, porém atribuir a ele um número real, ao invés de um número inteiro de casas decimais:

Código: {{Divide |-333.7 |14 |2.4}}

Resultado: Predefinição:Divide

• Declarar o valor do parâmetro casas, porém atribuir a ele um valor que não é sequer numérico:

Código: {{Divide |-333.7 |14 |@}}

Resultado: Predefinição:Divide

• Declarar o valor do parâmetro formatar, porém atribuir a ele um valor inválido:

Código: {{Divide |-333.7 |14 |2 |!}}

Resultado: Predefinição:Divide

• Informar à predefinição que execute um cálculo com um numerador que possua mais de 14 dígitos:

Código: {{Divide |1234567.89012345 |10}}

Resultado: Predefinição:Divide

• Informar à predefinição que execute um cálculo com um denominador que possua mais de 14 dígitos:

Código: {{Divide |10 |1234567.89012345}}

Resultado: Predefinição:Divide

Aninhamento

"Aninhar" duas ou mais predefinições (iguais ou distintas entre si) significa colocar uma predefinição "dentro" da outra, ou seja, usar uma predefinição como parâmetro de outra predefinição. Exemplo de aninhamento da predefinição Predefinição:T com ela mesma:

Código:

{{Divide |numerador=150 |denominador=Predefinição:Color |casas=3 |formatar=sim |porcentagem=%}}

Resultado:

No exemplo acima, dentro da predefinição {{Divide}} está aninhada a predefinição Predefinição:Color, que por sua vez está realizando a divisão de 857.22 por 3.14. Em sintaxe matemática, o cálculo que Predefinição:Color executará é este:

Predefinição:Início destaque $\frac{857.22}{3.14}=273$ Predefinição:Fim destaque

Consequentemente, aquele código com as predefinições aninhadas equivale a este, sem aninhamento:

Código:

{{Divide |numerador=150 |denominador=Predefinição:Color |casas=3 |formatar=sim |porcentagem=%}}

Resultado:

Agora vamos repetir o que foi feito aí em cima, só que sem declarar os parâmetros explicitamente:

Código:

{{Divide |150 |Predefinição:Color |3 |sim |%}}

Resultado:

...e portanto o código acima, com as predefinições aninhadas, equivale a este, sem aninhamento:

Código:

{{Divide |150 |Predefinição:Color |3 |sim |%}}

Resultado:

Ver também

• Predefinição:T