Mostrar código-fonte de Predefinição:Divide/doc

{{Subpágina de documentação}}
<includeonly>
{{alto-risco |5000}}
{{Predefinição complexa}}
</includeonly>

==Descrição==
Esta [[Wikipédia:Predefinições|predefinição]] divide um [[número]] ''A'' qualquer{{nota de rodapé|Um numerador de fração, ou seja, um dividendo.}} por um outro número ''B'' qualquer.{{nota de rodapé|Um denominador de fração, ou seja, um divisor.}} No caso, ''A'' e ''B'' são [[número inteiro|números inteiros]] e/ou [[número real|reais]]: pouco importa se ''A'' é inteiro ou real e se ''B'' é inteiro ou real.

{{início destaque}}
<math>\frac{A}{B}</math> é uma [[fração]] com numerador ''A'' e denominador ''B''
{{fim destaque}}

Além de dividir um número pelo outro, esta predefinição também é capaz de:
*<u>Arredondar</u> o resultado dessa divisão, para que ele seja exibido somente com uma quantidade ''N'' de casas decimais.
*<u>Formatar</u> esse resultado com a predefinição {{t|fmtn}}.
*<u>Converter</u> o resultado em valor [[porcentagem|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.

{{início destaque}}
<u>Em síntese</u>: 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:

'''<code><nowiki>{{Divide|A|B|N|formatar}}</nowiki></code>'''

Ou, convertido em porcentagem:

'''<code><nowiki>{{Divide|A|B|N|formatar|porcentagem}}</nowiki></code>'''
{{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 [[fração|divisão]].
**Tipo de argumento (valor) que aceita: [[número inteiro]] ou [[número real]].
**Obrigatório: <u>sim</u>.

*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: <u>sim</u>.

*Parâmetro '''casas'''.
**Sinônimos: '''c''', '''arred''', '''dec''', '''decimais'''.
**Ordem desse parâmetro: 3º, da esquerda para a direita.
**Função: quantidade de [[Número_decimal#Casa_decimal|casas decimais]] que devem restar após o arredondamento (caso ele seja executado).
**Tipo de argumento (valor) que aceita: número inteiro. <u>Exceção</u>: 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 {{t|fmtn}}.
**Tipo de argumento (valor) que aceita: qualquer uma das seguintes ''[[Cadeia de caracteres|strings]]'' (sequências de caracteres): ''s'', ''sim'', ''f'', ''formata'', ''formatar''.
***[[case-sensitive|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'', ''%''.
***[[case-sensitive|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 <u>explicitamente</u>{{nota de rodapé|Declarar explicitamente um parâmetro significa grafar o '''parâmetro''', seguido do sinal '''<nowiki>=</nowiki>''' ([[sinal de igual]]), seguido do '''valor''' desse parâmetro. Exemplo de declaração explícita: '''numerador<nowiki>=</nowiki>-333.7''' (o valor do parâmetro é o número que foi grafado imediatamente após o sinal de igual).}} ou <u>implicitamente</u>,{{nota de rodapé|Declarar um parâmetro implicitamente significa grafar <u>somente</u> o '''valor''' desse parâmetro, na posição sequencial correta dele. Exemplo de declaração implícita: ''10.5''. Neste exemplo, o valor do parâmetro será grafado imediatamente após o sinal '''<nowiki>|</nowiki>''' (que se denomina ''[[pipe]]''). Se esse valor for posto após o primeiro '''<nowiki>|</nowiki>''' da esquerda, a predefinição atribuirá o valor ''10.5'' ao parâmetro '''numerador'''. Se esse valor for posto após o segundo '''<nowiki>|</nowiki>''', a predefinição atribuirá o valor ''10.5'' ao parâmetro '''denominador'''. E assim sucessivamente. Portanto, na declaração implícita a <u>ordem</u> em que os valores aparecem importa, pois a <u>posição</u> de cada valor será usada pela predefinição para identificar a qual parâmetro esse valor está sendo atribuído.}} e que quando declarados implicitamente a ordem ou posição de cada <u>valor</u> atribuído a cada parâmetro é crucial para o correto funcionamento da predefinição.

==Sintaxe==
{{início destaque}}
A predefinição pode ser grafada com os parâmetros declarados explicitamente. Exemplo:

<code><nowiki>{{Divide |numerador=100 |denominador=7 |casas=3 |f=formatar |porcentagem=%}}</nowiki></code>

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

<code><nowiki>{{Divide |100 |7 |3 |formatar |%}}</nowiki></code>
{{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 final|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 <u>não irá emitir aviso/alerta nenhum</u>: ela irá simplesmente <u>ignorar</u> esse parâmetro e executar a divisão normalmente — sem converter o resultado em valor percentual.
*Toda [[calculadora]] possui um limite de [[algarismo]]s (ou dígitos) com que consegue operar em [[ponto flutuante]], e com os [[computador]]es da [[Wikimedia]] não é diferente: independentemente do [[aritmética|cálculo]] realizado com esta predefinição, a quantidade máxima de dígitos suportada para cada número é '''14 <span style="color: #B20000;">(catorze)</span>''' dígitos: já considerados os dígitos à esquerda e à direita da vírgula.{{nota de rodapé|Mas os zeros à esquerda não são contabilizados.}} 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 <u>quantidade de dígitos</u> 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 <u>diferentes</u>, 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 <code><nowiki>{{Divide |0.000000000000012345678901234 |1}}</nowiki></code>, por exemplo, será executado corretamente pela calculadora e resultará em {{Divide |0.000000000000012345678901234 |1}}, que em sintaxe matemática equivale a:


<div style="margin:0 auto; text-align:center;"><math>\frac{1.2345678901234}{10^{14}}</math></div>

==Exemplos==
===Com parâmetros===
Quando os parâmetros são declarados <u>explicitamente</u>, como nos exemplos abaixo, a <u>ordem</u> em que eles aparecem na predefinição é <u>irrelevante</u>. 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''': <code><nowiki>{{Divide |numerador=2 |denominador=4}}</nowiki></code>

'''Resultado''': {{Divide|2|4}}


*Dividir -3 por 5 (sem arredondar nem formatar):{{nota de rodapé|Lembre-se de que o parâmetro '''num''' tem como sinônimos os códigos '''numerador''' e '''dividendo''', assim como o parâmetro '''den''' tem como sinônimos os códigos '''denominador''' e '''divisor'''.}}
'''Código''': <code><nowiki>{{Divide |num=-3 |den=5}}</nowiki></code>

'''Resultado''': {{Divide|-3|5}}


*Dividir -76543.2 por -10.98 sem arredondar nem formatar o resultado:
'''Código''': <code><nowiki>{{Divide |num=-76543.2 |den=-10.98}}</nowiki></code>

'''Resultado''': {{Divide |num=-76543.2 |den=-10.98}}


*Dividir -76543.2 por -10.98 e formatar o resultado:
'''Código''': <code><nowiki>{{Divide |num=-76543.2 |den=-10.98 |formatar=sim}}</nowiki></code>

'''Resultado''': {{Divide |num=-76543.2 |den=-10.98 |formatar=sim}}


*Repetindo o cálculo acima, só que mudando a posição dos parâmetros declarados explicitamente:{{nota de rodapé|Observe que o resultado final foi exatamente o mesmo. Isso ocorreu porque, como explicado anteriormente, se os parâmetros são declarados explicitamente não importa a ordem em que eles foram declarados, ou seja, não importa a posição que cada parâmetro está ocupando, dentro da predefinição.}}
'''Código''': <code><nowiki>{{Divide |formatar=sim |den=-10.98 |num=-76543.2}}</nowiki></code>

'''Resultado''': {{Divide |formatar=sim |den=-10.98 |num=-76543.2}}


*Dividir -7.65 por 10.98, arredondar para três casas decimais, converter o resultado em porcentagem e então formatá-lo:{{nota de rodapé|A predefinição <u>não</u> acrescenta o caractere '''%''' ao final do resultado que foi convertido em porcentagem.}}
'''Código''': <code><nowiki>{{Divide |num=-7.65 |den=10.98 |arred=3 |formatar=sim |porcentagem=%}}</nowiki></code>

'''Resultado''': {{Divide |num=-7.65 |den=10.98 |arred=3 |formatar=sim |porcentagem=%}}


*Dividir -1776 por 15.52 sem formatar nem arredondar:
'''Código''': <code><nowiki>{{Divide |num=-1776 |den=15.52}}</nowiki></code>

'''Resultado''': {{Divide |num=-1776 |den=15.52}}


*Dividir -1776 por 15.52 sem arredondar, mas formatando:{{nota de rodapé|Lembre-se de que o parâmetro '''formatar''' tem como sinônimos os códigos '''f''' e '''formata''', e que qualquer um deles três aceita qualquer um destes valores: ''s'', ''sim'', ''formata'' e ''formatar''. Qualquer um desses 4 valores produz o mesmo efeito: ativa o parâmetro '''formatar''' (ou um de seus dois sinônimos) e com isto faz com que o resultado da divisão seja formatado. Exemplos de códigos que produzirão exatamente o mesmo resultado: '''f'''<nowiki>=</nowiki>''s'', '''f'''<nowiki>=</nowiki>''sim'', '''f'''<nowiki>=</nowiki>''formata'', '''f'''<nowiki>=</nowiki>''formatar'', '''formata'''<nowiki>=</nowiki>''s'', '''formata'''<nowiki>=</nowiki>''sim'', '''formata'''<nowiki>=</nowiki>''formata'', '''formata'''<nowiki>=</nowiki>''formatar'', '''formatar'''<nowiki>=</nowiki>''s'', '''formatar'''<nowiki>=</nowiki>''sim'', '''formatar'''<nowiki>=</nowiki>''formata'', e '''formatar'''<nowiki>=</nowiki>''formatar''.}}
'''Código''': <code><nowiki>{{Divide |num=-1776 |den=15.52 |formatar=s}}</nowiki></code>

'''Resultado''': {{Divide |num=-1776 |den=15.52 |formatar=s}}


*Mesmo cálculo que acima, porém arredondando para 3 casas decimais:
'''Código''': <code><nowiki>{{Divide |num=-1776 |den=15.52 |casas=3 |formatar=s}}</nowiki></code>

'''Resultado''': {{Divide |num=-1776 |den=15.52 |casas=3 |formatar=s}}


*Mesmo cálculo novamente, porém arredondando para apenas 1 casa decimal:
'''Código''': <code><nowiki>{{Divide |num=-1776 |den=15.52 |casas=1 |formatar=s}}</nowiki></code>

'''Resultado''': {{Divide |num=-1776 |den=15.52 |casas=1 |formatar=s}}


*Mesmo cálculo novamente, porém arredondando para não mostrar <u>nenhuma casa decimal</u> (o número real/decimal é convertido em número inteiro):{{nota de rodapé|Lembre-se de que o parâmetro '''casas''' tem como sinônimos os códigos '''c''', '''arred''', '''dec''' e '''decimais'''.}}
'''Código''': <code><nowiki>{{Divide |num=-1776 |den=15.52 |arred=0 |formatar=s}}</nowiki></code>

'''Resultado''': {{Divide |num=-1776 |den=15.52 |arred=0 |formatar=s}}


*Mesmo cálculo novamente, mas agora vamos arredondar para não exibir <u>nenhuma casa decimal</u> e além disso ignorar os valores das <u>duas casas à esquerda da vírgula</u>, ou seja, ignorar [[Sistema de numeração decimal|as unidades e as dezenas]] e com isto preservar o resultado, da direita para a esquerda, somente a partir da casa das [[cem|centenas]]:
'''Código''': <code><nowiki>{{Divide |num=-1776 |den=15.52 |arred=-2 |formatar=s}}</nowiki></code>

'''Resultado''': {{Divide |num=-1776 |den=15.52 |arred=-2 |formatar=s}}


*Repetição do cálculo acima, porém convertendo o resultado em porcentagem:{{nota de rodapé|Observe que ao invés de {{fmtn|10000}} (dez mil), o resultado foi {{fmtn|11400}} (onze mil e quatrocentos). Por quê? Isso ocorreu porque o arredondamento é sempre o <u>último</u> cálculo que a predefinição executa. E qual o porquê disso? Isso é feito porque todo arredondamento descarta dígitos, e isso <u>diminui a precisão dos cálculos posteriores</u>, já que os "cálculos posteriores" serão efetuados com um "número novo", que é esse número arredondado. Em outras palavras: o cálculo fica mais preciso se <u>primeiro</u> o resultado de todos os cálculos for convertido em percentual e <u>somente depois</u> (no final) ele for arredondado (que é quando algumas casas decimais poderão ser descartadas <u>sem prejudicar a precisão dos cálculos que foram executados antes disso</u>).}}
'''Código''': <code><nowiki>{{Divide |num=-1776 |den=15.52 |arred=-2 |formatar=s |porcentagem=p}}</nowiki></code>

'''Resultado''': {{Divide |num=-1776 |den=15.52 |arred=-2 |formatar=s |porcentagem=p}}


====Contextos que retornarão erro====
*Não informar parâmetro nenhum:
'''Código''': <code><nowiki>{{Divide}}</nowiki></code>

'''Resultado''': {{Divide}}


*Deixar o numerador em branco:
'''Código''': <code><nowiki>{{Divide |den=14}}</nowiki></code>

'''Resultado''': {{Divide |den=14}}


*Atribuir valor zero ao numerador:
'''Código''': <code><nowiki>{{Divide |num=0 |den=14}}</nowiki></code>

'''Resultado''': {{Divide |num=0 |den=14}}


*Atribuir ao numerador um valor que não é numérico:
'''Código''': <code><nowiki>{{Divide |num=Y |den=14}}</nowiki></code>

'''Resultado''': {{Divide |num=Y |den=14}}


*Atribuir valor zero ao denominador:
'''Código''': <code><nowiki>{{Divide |num=-333.7 |den=0}}</nowiki></code>

'''Resultado''': {{Divide |num=-333.7 |den=0}}


*Atribuir ao denominador um valor que não é numérico:
'''Código''': <code><nowiki>{{Divide |num=-333.7 |den=$}}</nowiki></code>

'''Resultado''': {{Divide |num=-333.7 |den=$}}


*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''': <code><nowiki>{{Divide |num=-333.7 |den=14 |casas=2.4}}</nowiki></code>

'''Resultado''': {{Divide |num=-333.7 |den=14 |casas=2.4}}


*Declarar o parâmetro '''casas''' porém atribuir a ele um valor que não é sequer numérico:
'''Código''': <code><nowiki>{{Divide |num=-333.7 |den=14 |casas=@}}</nowiki></code>

'''Resultado''': {{Divide |num=-333.7 |den=14 |casas=@}}


*Declarar o parâmetro '''formatar''' porém atribuir a ele um valor inválido:
'''Código''': <code><nowiki>{{Divide |num=-333.7 |den=14 |casas=2 |formatar=!}}</nowiki></code>

'''Resultado''': {{Divide |num=-333.7 |den=14 |casas=2 |formatar=!}}


*Declarar um ou mais parâmetros <u>explicitamente</u>, porém também declarar um ou mais parâmetros <u>implicitamente</u>:
'''Código''': <code><nowiki>{{Divide |num=-333.7 |den=14 |2}}</nowiki></code>

'''Resultado''': {{Divide |num=-333.7 |den=14 |2}}{{nota de rodapé|Observe que o terceiro parâmetro, declarado implicitamente, foi '''casas''', pois esse parâmetro ocupa a terceira posição dentro da predefinição (logo após '''num''' e '''den'''). Porém, como os parâmetros obrigatórios foram declarados explicitamente, a predefinição esperava que o parâmetro '''casas''' também fosse ser declarado explicitamente. Como ele foi declarado implicitamente, ocorreu um erro e o arredondamento para 2 casas decimais acabou não sendo executado.<br> A título de curiosidade: o resultado (errado) exibido pela predefinição foi ''0.14285714285714'' porque a mistura de parâmetros declarados explicitamente e implicitamente ocasionou um erro que fez com que a predefinição incorretamente usasse ''2'' como numerador e ''14'' como denominador. Observe que a divisão de ''2'' por ''14'' resulta em ''0.142857'''142857'''142857'''142857'''142857...'', que arredondado para 14 dígitos (o zero à esquerda do ponto não é computado) resulta em ''0.14285714285714''. Para evitar esse tipo de problema, sempre declare todos os parâmetros explicitamente, ou então declare todos os parâmetros implicitamente.}}


*Informar à predefinição que execute um cálculo com um numerador que possua mais de 14 dígitos:
'''Código''': <code><nowiki>{{Divide |num=1234567.89012345 |den=10}}</nowiki></code>

'''Resultado''': {{Divide |num=1234567.89012345 |den=10}}


*Informar à predefinição que execute um cálculo com um denominador que possua mais de 14 dígitos:
'''Código''': <code><nowiki>{{Divide |num=10 |den=1234567.89012345}}</nowiki></code>

'''Resultado''': {{Divide |num=10 |den=1234567.89012345}}


===Sem parâmetros===
Quando os parâmetros são declarados <u>implicitamente</u>, 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''': <code><nowiki>{{Divide |2 |4}}</nowiki></code>

'''Resultado''': {{Divide|2|4}}


*Dividir -3 por 5 (sem arredondar nem formatar):
'''Código''': <code><nowiki>{{Divide |-3 |5}}</nowiki></code>

'''Resultado''': {{Divide|-3|5}}


*Dividir -76543.2 por -10.98 sem arredondar nem formatar o resultado:
'''Código''': <code><nowiki>{{Divide |-76543.2 |-10.98}}</nowiki></code>

'''Resultado''': {{Divide |-76543.2 |-10.98}}


*Dividir -76543.2 por -10.98 e formatar o resultado:{{nota de rodapé|Observe que o terceiro parâmetro é '''casas''' e o quarto parâmetro é '''formatar'''. Como neste exemplo os parâmetros não foram declarados explicitamente, temos que inserir um "campo vazio" entre dois ''[[pipes]]'' (caracteres '''<nowiki>|</nowiki>''') para indicar que o espaço reservado para o valor do parâmetro '''casas''' não foi preenchido e que o campo seguinte (iniciado pelo ''pipe'' seguinte) corresponde à posição do parâmetro '''formatar'''. Mas não confunda o parâmetro '''formatar''' com o valor que é atribuído a esse parâmetro: no texto '''''formatar'''<nowiki>=</nowiki>formatar'', por exemplo, a palavra '''formatar''' que está à esquerda do '''<nowiki>=</nowiki>''' é um <u>parâmetro</u>, ao passo que a palavra ''formatar'' que está à direita do '''<nowiki>=</nowiki>''' é o <u>valor que foi atribuído ao parâmetro '''formatar'''</u>.}}
'''Código''': <code><nowiki>{{Divide |-76543.2 |-10.98 | |formatar}}</nowiki></code>

'''Resultado''': {{Divide |-76543.2 |-10.98 | |formatar}}


*Repetindo o cálculo acima, só que mudando a posição dos valores:{{nota de rodapé|Observe que o resultado final ficou diferente. Como explicado anteriormente, isso ocorreu porque quando os parâmetros são declarados <u>implicitamente</u>, como foi o caso, torna-se crucial a <u>ordem</u> em que se declaram os valores atribuídos aos parâmetros, ou seja, a <u>posição</u> que cada valor está ocupando faz diferença, dentro da predefinição: se, por exemplo, o valor que está na 2<sup><small>a</small></sup> posição (da esquerda para a direita) for movido para a 1<sup><small>a</small></sup> posição, a predefinição deixará de tratar esse valor como o "valor que foi atribuído ao denominador" e passará a tratá-lo como o "valor que foi atribuído ao numerador".}}
'''Código''': <code><nowiki>{{Divide |-10.98 |-76543.2 | |formatar}}</nowiki></code>

'''Resultado''': {{Divide |-10.98 |-76543.2 | |formatar}}


*Dividir -7.65 por 10.98, arredondar para três casas decimais, converter o resultado em porcentagem e então formatá-lo:
'''Código''': <code><nowiki>{{Divide |-7.65 |10.98 |3 |f |%}}</nowiki></code>

'''Resultado''': {{Divide |-7.65 |10.98 |3 |f |%}}


*Dividir -1776 por 15.52 sem formatar nem arredondar:
'''Código''': <code><nowiki>{{Divide |-1776 |15.52}}</nowiki></code>

'''Resultado''': {{Divide |-1776 |15.52}}


*Dividir -1776 por 15.52 sem arredondar, mas formatando:
'''Código''': <code><nowiki>{{Divide |-1776 |15.52 | |formatar}}</nowiki></code>

'''Resultado''': {{Divide |-1776 |15.52 | |formatar}}


*Mesmo cálculo que acima, porém arredondando para 3 casas decimais:
'''Código''': <code><nowiki>{{Divide |-1776 |15.52 |3 |formatar}}</nowiki></code>

'''Resultado''': {{Divide |-1776 |15.52 |3 |formatar}}


*Mesmo cálculo novamente, porém arredondando para apenas 1 casa decimal:
'''Código''': <code><nowiki>{{Divide |-1776 |15.52 |1 |formatar}}</nowiki></code>

'''Resultado''': {{Divide |-1776 |15.52 |1 |formatar}}


*Mesmo cálculo novamente, porém arredondando para não mostrar <u>nenhuma casa decimal</u> (o número real/decimal é convertido em número inteiro):
'''Código''': <code><nowiki>{{Divide |-1776 |15.52 |0 |formatar}}</nowiki></code>

'''Resultado''': {{Divide |-1776 |15.52 |0 |formatar}}


*Mesmo cálculo novamente, mas agora vamos arredondar para não exibir <u>nenhuma casa decimal</u> e além disso ignorar os valores das <u>duas casas à esquerda da vírgula</u>, ou seja, ignorar [[Sistema de numeração decimal|as unidades e as dezenas]] e com isto preservar o resultado, da direita para a esquerda, somente a partir da casa das [[cem|centenas]]:
'''Código''': <code><nowiki>{{Divide |-1776 |15.52 |-2 |formatar}}</nowiki></code>

'''Resultado''': {{Divide |-1776 |15.52 |-2 |formatar}}


*Repetição do cálculo acima, porém convertendo o resultado em porcentagem:
'''Código''': <code><nowiki>{{Divide |-1776 |15.52 |-2 |f |%}}</nowiki></code>

'''Resultado''': {{Divide |-1776 |15.52 |-2 |f |%}}


====Contextos que retornarão erro====
*Não informar valor de parâmetro nenhum:
'''Código''': <code><nowiki>{{Divide}}</nowiki></code>

'''Resultado''': {{Divide}}


*Deixar o numerador em branco:
'''Código''': <code><nowiki>{{Divide | |14}}</nowiki></code>

'''Resultado''': {{Divide | |14}}


*Atribuir valor zero ao numerador:
'''Código''': <code><nowiki>{{Divide |0 |14}}</nowiki></code>

'''Resultado''': {{Divide |0 |14}}


*Atribuir ao numerador um valor que não é numérico:
'''Código''': <code><nowiki>{{Divide |Y |14}}</nowiki></code>

'''Resultado''': {{Divide |Y |14}}


*Atribuir valor zero ao denominador:
'''Código''': <code><nowiki>{{Divide |-333.7 |0}}</nowiki></code>

'''Resultado''': {{Divide |-333.7 |0}}


*Atribuir ao denominador um valor que não é numérico:
'''Código''': <code><nowiki>{{Divide |-333.7 |$}}</nowiki></code>

'''Resultado''': {{Divide |-333.7 |$}}


*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''': <code><nowiki>{{Divide |-333.7 |14 |2.4}}</nowiki></code>

'''Resultado''': {{Divide |-333.7 |14 |2.4}}


*Declarar o valor do parâmetro '''casas''', porém atribuir a ele um valor que não é sequer numérico:
'''Código''': <code><nowiki>{{Divide |-333.7 |14 |@}}</nowiki></code>

'''Resultado''': {{Divide |-333.7 |14 |@}}


*Declarar o valor do parâmetro '''formatar''', porém atribuir a ele um valor inválido:
'''Código''': <code><nowiki>{{Divide |-333.7 |14 |2 |!}}</nowiki></code>

'''Resultado''': {{Divide |-333.7 |14 |2 |!}}


*Informar à predefinição que execute um cálculo com um numerador que possua mais de 14 dígitos:
'''Código''': <code><nowiki>{{Divide |1234567.89012345 |10}}</nowiki></code>

'''Resultado''': {{Divide |1234567.89012345 |10}}


*Informar à predefinição que execute um cálculo com um denominador que possua mais de 14 dígitos:
'''Código''': <code><nowiki>{{Divide |10 |1234567.89012345}}</nowiki></code>

'''Resultado''': {{Divide |10 |1234567.89012345}}

===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 (ciência da computação)|parâmetro]] de outra predefinição. Exemplo de aninhamento da predefinição {{t|Divide}} com ela mesma:

'''Código''':

<code><nowiki>{{Divide |numerador=150 |denominador=</nowiki>{{Color|#8000FF|{{<nowiki>Divide |numerador=857.22 |denominador=3.14</nowiki>}}}}<nowiki> |casas=3 |formatar=sim |porcentagem=%}}</nowiki></code>

'''Resultado''':

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

No exemplo acima, dentro da predefinição <nowiki>{{</nowiki>Divide<nowiki>}}</nowiki> está aninhada a predefinição {{Color|#8000FF|{{<nowiki>Divide</nowiki>}}}}, que por sua vez está realizando a divisão de 857.22 por 3.14. Em sintaxe [[matemática]], o cálculo que {{Color|#8000FF|{{<nowiki>Divide</nowiki>}}}} executará é este:

{{início destaque}}
<math>\frac{857.22}{3.14} = 273</math>
{{fim destaque}}

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

'''Código''':

<code><nowiki>{{Divide |numerador=150 |denominador=</nowiki>{{Color|#8000FF|273}}<nowiki> |casas=3 |formatar=sim |porcentagem=%}}</nowiki></code>

'''Resultado''':

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

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

'''Código''':

<code><nowiki>{{Divide |150 |</nowiki>{{Color|#8000FF|{{<nowiki>Divide |857.22 |3.14</nowiki>}}}}<nowiki> |3 |sim |%}}</nowiki></code>

'''Resultado''':

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

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

'''Código''':

<code><nowiki>{{Divide |150 |</nowiki>{{Color|#8000FF|273}}<nowiki> |3 |sim |%}}</nowiki></code>

'''Resultado''':

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

{{Documentação dos parâmetros}}

{{Notas}}

==Ver também==
*{{t|Soma}}

<includeonly>
[[Categoria:!Predefinições sobre matemática]]
</includeonly>