Predefinição:Divide/doc

Descrição

Esta predefinição divide um número A qualquer por um outro número B qualquer. 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.

${\frac {A}{B}}$ é uma fração com numerador A e denominador B

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 {{fmtn}}.
• 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.

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}}

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 {{fmtn}}.
  • 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 explicitamente ou implicitamente, 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

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 |%}}

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. 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 1.2345678901234E-14, 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: 0.5

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

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

Resultado: -0.6

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

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

Resultado: 6971.1475409836

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

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

Resultado: 6 971,1475409836

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

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

Resultado: 6 971,1475409836

• 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 |num=-7.65 |den=10.98 |arred=3 |formatar=sim |porcentagem=%}}

Resultado: −69,672

• Dividir -1776 por 15.52 sem formatar nem arredondar:

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

Resultado: -114.43298969072

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

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

Resultado: −114,43298969072

• 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: −114,433

• 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: −114,4

• 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 |num=-1776 |den=15.52 |arred=0 |formatar=s}}

Resultado: −114

• 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: −100

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

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

Resultado: −11 400

Contextos que retornarão erro

• Não informar parâmetro nenhum:

Código: {{Divide}}

Resultado:

• Deixar o numerador em branco:

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

Resultado:

• Atribuir valor zero ao numerador:

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

Resultado:

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

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

Resultado:

• Atribuir valor zero ao denominador:

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

Resultado:

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

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

Resultado:

• 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:

• 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:

• 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:

• 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: 0.14285714285714

• 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:

• 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:

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: 0.5

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

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

Resultado: -0.6

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

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

Resultado: 6971.1475409836

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

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

Resultado: 6 971,1475409836

• Repetindo o cálculo acima, só que mudando a posição dos valores:

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

Resultado: 0,00014344840560625

• 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: −69,672

• Dividir -1776 por 15.52 sem formatar nem arredondar:

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

Resultado: -114.43298969072

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

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

Resultado: −114,43298969072

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

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

Resultado: −114,433

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

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

Resultado: −114,4

• 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: −114

• 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: −100

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

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

Resultado: −11 400

Contextos que retornarão erro

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

Código: {{Divide}}

Resultado:

• Deixar o numerador em branco:

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

Resultado:

• Atribuir valor zero ao numerador:

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

Resultado:

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

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

Resultado:

• Atribuir valor zero ao denominador:

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

Resultado:

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

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

Resultado:

• 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:

• 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:

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

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

Resultado:

• 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:

• 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:

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 {{Divide}} com ela mesma:

Código:

{{Divide |numerador=150 |denominador={{Divide |numerador=857.22 |denominador=3.14}} |casas=3 |formatar=sim |porcentagem=%}}

Resultado:

54,945

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

${\frac {857.22}{3.14}}=273$

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

Código:

{{Divide |numerador=150 |denominador=273 |casas=3 |formatar=sim |porcentagem=%}}

Resultado:

54,945

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

Código:

{{Divide |150 |{{Divide |857.22 |3.14}} |3 |sim |%}}

Resultado:

54,945

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

Código:

{{Divide |150 |273 |3 |sim |%}}

Resultado:

54,945

Cabeçalho de TemplateData

As informações a seguir (editar) são definidas com TemplateData. Isso possibilita o seu uso pelo Editor Visual e por outras ferramentas.

Esta predefinição divide um número 'A' por um número 'B' – sejam eles ambos números inteiros, ou ambos números reais, ou um deles inteiro e o outro real –, contanto que nenhum dos dois possua mais de 14 dígitos (exemplo: o número 1234567.8901234 tem 14 dígitos, portanto é aceito). A predefinição também é capaz de [1] arredondar o resultado da divisão para que mostre somente uma quantidade específica de casas decimais após a vírgula, [2] converter o resultado em porcentagem (o símbolo '%' não é exibido no resultado), e [3] usar a predefinição 'fmtn' para formatar o resultado, de modo que o separador 'ponto' seja substituído por 'vírgula' e as casas dos milhares, milhões, bilhões etc. sejam separadas umas das outras – em grupos de três dígitos – por um pequeno espaço em branco.

Parâmetros da predefinição

Parâmetro		Descrição	Tipo	Estado
Numerador (dividendo)	num numerador dividendo	O numerador (ou dividendo) é o número, inteiro ou real, de no máximo 14 dígitos, que será dividido pelo outro número (inteiro ou real, também com no máximo 14 dígitos). Observe que números negativos são aceitos. Caso esse número possua casas decimais, use 'ponto' para separar os decimais do restante (a parte inteira) do número. Exemplo: -15.19708	Número	obrigatório
Denominador (divisor)	den denominador divisor	O denominador (ou divisor) é o número, inteiro ou real, de no máximo 14 dígitos, que dividirá o outro número (inteiro ou real, também com no máximo 14 dígitos) que foi informado como 'numerador'. Observe que números negativos são aceitos. Caso esse denominador possua casas decimais, use 'ponto' para separar os decimais do restante (a parte inteira) dele. Exemplo: 2.71	Número	obrigatório
Quantidade de casas decimais	casas c arred dec decimais	Este parâmetro é usado para definir quantas casas decimais deverão ser mostradas após a vírgula, no resultado da divisão. Quando esse parâmetro é declarado, o resultado da divisão é automaticamente arredondado para que mostre somente a quantidade de casas decimais que foi definida. Essa quantidade deve ser um 'número inteiro'. Exemplo: 3	Número	recomendado
O resultado deve ser formatado?	formatar f formata	Este parâmetro é usado para definir se o resultado da divisão deverá ser formatado com a predefinição 'fmtn'. Em caso afirmativo, o caractere 'ponto' – usado para separar os decimais (numerais do lado direito) e a parte inteira (numerais do lado esquerdo) de um número – será substituído pelo caractere vírgula. Além disso, um espaço em branco será inserido entre o grupo de três casas dos milhares e o grupo de três casas dos milhões, e assim sucessivamente com os grupos dos bilhões, trilhões etc. (caso haja). Para ativar este parâmetro, deve-se atribuir a este parâmetro uma das seguintes letras ou palavras: 'f', 's', 'sim', 'formata' ou 'formatar'. Exemplo: f	String	opcional
Converter em porcentagem?	porcentagem p por %	Este parâmetro é usado para definir se o resultado da divisão deverá ser convertido em valor percentual. Isso independe de esse resultado haver sido arredondado ou não, assim como também independe de esse resultado haver sido formatado ou não. Por exemplo: 15 dividido por 50 resulta em 0.3, que em valor percentual é expresso pelo número 30 (pois 15 corresponde a 30% do número 50). Caso queira que o resultado da divisão seja convertido em percentual, ative este parâmetro atribuindo a ele um dos seguintes caracteres ou palavras: 'p', 'por', 'porcentagem' ou '%'. Exemplo: %	String	opcional

Ver também

• {{Soma}}