pt Predefini%C3%A7%C3%A3o:Divide

Documentação da predefinição[ver] [editar] [histórico] [purgar]

Esta predefinição é usada em aproximadamente 5 000 páginas. (Ver Wikipedia:Predefinições em alto risco)
Para evitar sobrecargas desnecessárias ao servidor e outros transtornos, quaisquer mudanças devem ser previamente testadas, seja na subpágina de testes desta predefinição ou em sua subpágina da predefinição de testes (ou ainda em sua subpágina de testes). Por favor, sempre considere expor eventuais mudanças na página de discussão, antes de implementá-las.

Esta predefinição emprega sintaxe possivelmente complexa.

Por favor, não tente alterar algo a menos que esteja certo de que compreende a sintaxe de predefinições e esteja preparado para reparar danos colaterais se os resultados forem inesperados.

Antes de realizar qualquer modificação significativa, sempre considere primeiro testá-la em Predefinição:Divide/Testes (ou ainda em sua página de testes).

Descrição

Esta predefinição divide um número A qualquer^{[nota 1]} por um outro número B qualquer.^{[nota 2]} 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^{[nota 3]} ou implicitamente,^{[nota 4]} 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.^{[nota 5]} 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):^{[nota 6]}

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:^{[nota 7]}

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:^{[nota 8]}

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:^{[nota 9]}

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):^{[nota 10]}

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:^{[nota 11]}

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: Informe o numerador (dividendo)!

Deixar o numerador em branco:

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

Resultado: Informe o numerador (dividendo)!

Atribuir valor zero ao numerador:

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

Resultado: O numerador (dividendo) não pode ser zero! A divisão de zero por qualquer número não nulo resulta em zero mesmo!

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

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

Resultado: O numerador (dividendo) tem que ser um número!

Atribuir valor zero ao denominador:

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

Resultado: O denominador (divisor) não pode ser zero! Não existe divisão por zero!

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

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

Resultado: O denominador (divisor) tem que ser um número!

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: A quantidade de casas a arredondar tem de ser um número inteiro!

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: A quantidade de casas a arredondar tem de ser um número inteiro!

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: Se quiser formatar o resultado, informe um dos valores válidos para este parâmetro. Caso contrário, deixe-o em branco!

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^{[nota 12]}

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: O numerador (dividendo) tem que ser um número!

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: O denominador (divisor) tem que ser um número!

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:^{[nota 13]}

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:^{[nota 14]}

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: Informe o numerador (dividendo)!

Deixar o numerador em branco:

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

Resultado: Informe o numerador (dividendo)!

Atribuir valor zero ao numerador:

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

Resultado: O numerador (dividendo) não pode ser zero! A divisão de zero por qualquer número não nulo resulta em zero mesmo!

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

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

Resultado: O numerador (dividendo) tem que ser um número!

Atribuir valor zero ao denominador:

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

Resultado: O denominador (divisor) não pode ser zero! Não existe divisão por zero!

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

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

Resultado: O denominador (divisor) tem que ser um número!

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: A quantidade de casas a arredondar tem de ser um número inteiro!

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: A quantidade de casas a arredondar tem de ser um número inteiro!

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

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

Resultado: Se quiser formatar o resultado, informe um dos valores válidos para este parâmetro. Caso contrário, deixe-o em branco!

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: O numerador (dividendo) tem que ser um número!

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: O denominador (divisor) tem que ser um número!

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[Editar dados 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

Notas

↑ Um numerador de fração, ou seja, um dividendo.
↑ Um denominador de fração, ou seja, um divisor.
↑ Declarar explicitamente um parâmetro significa grafar o parâmetro, seguido do sinal = (sinal de igual), seguido do valor desse parâmetro. Exemplo de declaração explícita: numerador=-333.7 (o valor do parâmetro é o número que foi grafado imediatamente após o sinal de igual).
↑ Declarar um parâmetro implicitamente significa grafar somente 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 | (que se denomina pipe). Se esse valor for posto após o primeiro | da esquerda, a predefinição atribuirá o valor 10.5 ao parâmetro numerador. Se esse valor for posto após o segundo |, a predefinição atribuirá o valor 10.5 ao parâmetro denominador. E assim sucessivamente. Portanto, na declaração implícita a ordem em que os valores aparecem importa, pois a posição de cada valor será usada pela predefinição para identificar a qual parâmetro esse valor está sendo atribuído.
↑ Mas os zeros à esquerda não são contabilizados.
↑ 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.
↑ 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.
↑ A predefinição não acrescenta o caractere % ao final do resultado que foi convertido em porcentagem.
↑ 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=s, f=sim, f=formata, f=formatar, formata=s, formata=sim, formata=formata, formata=formatar, formatar=s, formatar=sim, formatar=formata, e formatar=formatar.
↑ Lembre-se de que o parâmetro casas tem como sinônimos os códigos c, arred, dec e decimais.
↑ Observe que ao invés de 10 000 (dez mil), o resultado foi 11 400 (onze mil e quatrocentos). Por quê? Isso ocorreu porque o arredondamento é sempre o último cálculo que a predefinição executa. E qual o porquê disso? Isso é feito porque todo arredondamento descarta dígitos, e isso diminui a precisão dos cálculos posteriores, 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 primeiro o resultado de todos os cálculos for convertido em percentual e somente depois (no final) ele for arredondado (que é quando algumas casas decimais poderão ser descartadas sem prejudicar a precisão dos cálculos que foram executados antes disso).
↑ 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.
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.142857142857142857142857142857..., 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.
↑ 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 |) 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=formatar, por exemplo, a palavra formatar que está à esquerda do = é um parâmetro, ao passo que a palavra formatar que está à direita do = é o valor que foi atribuído ao parâmetro formatar.
↑ Observe que o resultado final ficou diferente. Como explicado anteriormente, isso ocorreu porque quando os parâmetros são declarados implicitamente, como foi o caso, torna-se crucial a ordem em que se declaram os valores atribuídos aos parâmetros, ou seja, a posição que cada valor está ocupando faz diferença, dentro da predefinição: se, por exemplo, o valor que está na 2^a posição (da esquerda para a direita) for movido para a 1^a 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".

Ver também

{{Soma}}

A documentação acima é transcluída de Predefinição:Divide/doc.
Editores podem experimentar nas páginas de teste e de exemplos para testes desta predefinição.
Adicione categorias à subpágina /doc. Subpáginas desta predefinição.

[1] Um numerador de fração, ou seja, um dividendo.

[2] Um denominador de fração, ou seja, um divisor.

[3] Declarar explicitamente um parâmetro significa grafar o parâmetro, seguido do sinal = (sinal de igual), seguido do valor desse parâmetro. Exemplo de declaração explícita: numerador=-333.7 (o valor do parâmetro é o número que foi grafado imediatamente após o sinal de igual).

[4] Declarar um parâmetro implicitamente significa grafar somente 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 | (que se denomina pipe). Se esse valor for posto após o primeiro | da esquerda, a predefinição atribuirá o valor 10.5 ao parâmetro numerador. Se esse valor for posto após o segundo |, a predefinição atribuirá o valor 10.5 ao parâmetro denominador. E assim sucessivamente. Portanto, na declaração implícita a ordem em que os valores aparecem importa, pois a posição de cada valor será usada pela predefinição para identificar a qual parâmetro esse valor está sendo atribuído.

[5] Mas os zeros à esquerda não são contabilizados.

[6] 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.

[7] 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.

[8] A predefinição não acrescenta o caractere % ao final do resultado que foi convertido em porcentagem.

[9] 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=s, f=sim, f=formata, f=formatar, formata=s, formata=sim, formata=formata, formata=formatar, formatar=s, formatar=sim, formatar=formata, e formatar=formatar.

[10] Lembre-se de que o parâmetro casas tem como sinônimos os códigos c, arred, dec e decimais.

[11] Observe que ao invés de 10 000 (dez mil), o resultado foi 11 400 (onze mil e quatrocentos). Por quê? Isso ocorreu porque o arredondamento é sempre o último cálculo que a predefinição executa. E qual o porquê disso? Isso é feito porque todo arredondamento descarta dígitos, e isso diminui a precisão dos cálculos posteriores, 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 primeiro o resultado de todos os cálculos for convertido em percentual e somente depois (no final) ele for arredondado (que é quando algumas casas decimais poderão ser descartadas sem prejudicar a precisão dos cálculos que foram executados antes disso).

[12] 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.
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.142857142857142857142857142857..., 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.

[13] 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 |) 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=formatar, por exemplo, a palavra formatar que está à esquerda do = é um parâmetro, ao passo que a palavra formatar que está à direita do = é o valor que foi atribuído ao parâmetro formatar.

[14] Observe que o resultado final ficou diferente. Como explicado anteriormente, isso ocorreu porque quando os parâmetros são declarados implicitamente, como foi o caso, torna-se crucial a ordem em que se declaram os valores atribuídos aos parâmetros, ou seja, a posição que cada valor está ocupando faz diferença, dentro da predefinição: se, por exemplo, o valor que está na 2^a posição (da esquerda para a direita) for movido para a 1^a 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".

[nota 1]

[nota 2]

[nota 3]

[nota 4]

[nota 5]

[nota 6]

[nota 7]

[nota 8]

[nota 9]

[nota 10]

[nota 11]

[nota 12]

[nota 13]

[nota 14]