Wikipedista:Oashi/mod

{{Wikipedista:Oashi/mod|17|9}} = 8

Dokumentace  

[podstránky Šablona:Mod/] - [podstránky Wikipedista:Oashi/mod/]

Operace modulo.

Oproti prosté wiki-syntaxi a funkcím parseru tato šablona přináší i validace vstupů a vysvětlující/navádějící chybová hlášení.

Teoretický základ a varování o dvojznačnosti

Pokud jsou a and d celá čísla, d nenulové, je zbytek po dělení r takové celé číslo, že a = qd + r pro takový celý výsledný koeficitent q, že |r| < |d|.

Při této definici však jsou při použití záporných členů možné dvě hodnoty zbytků. Například při dělení −42 / −5:

• −42 = 9×(−5) + 3
• −42 = 8×(−5) + (−2).

Zbytky tedy jsou buď 3, nebo −2

Pro dvojici zbytků dále platí, že:

d = ⁺r − ⁻r

Tato definiční nejednoznačnost může způsobovat závážné potíže při programování.

Příklady

kladné

• kladné, snadné
  • {{Wikipedista:Oashi/mod|8|7}} = 1
  • {{Wikipedista:Oashi/mod|8|7|w}} = 1 = 1 = {{#expr:8mod7}}
  • {{Wikipedista:Oashi/mod|8|7|}} = 1
  • {{Wikipedista:Oashi/mod|8|7|+}} = 1
• kladné, ale menší
  • {{Wikipedista:Oashi/mod|1|7}} = 1
  • {{Wikipedista:Oashi/mod|1|7|w}} = 1 = 1 = {{#expr:1mod7}}
  • {{Wikipedista:Oashi/mod|1|7|}} = 1
  • {{Wikipedista:Oashi/mod|1|7|+}} = 1

záporný čitatel

• výchozí snadný
  • {{Wikipedista:Oashi/mod|17|9}} = 8
  • {{Wikipedista:Oashi/mod|17|9|w}} = 8 = 8 = {{#expr:17mod9}}
  • {{Wikipedista:Oashi/mod|17|9|}} = 8
  • {{Wikipedista:Oashi/mod|17|9|+}} = 8
• obrácení čitatele
  • {{Wikipedista:Oashi/mod|-17|9}} = 1
  • {{Wikipedista:Oashi/mod|-17|9|w}} = -8 = -8 = {{#expr:-17mod9}}
  • {{Wikipedista:Oashi/mod|-17|9|}} = -8
  • {{Wikipedista:Oashi/mod|-17|9|+}} = 1
• čitatel absolutně menší, záporný
  • {{Wikipedista:Oashi/mod|-8|9}} = 1
  • {{Wikipedista:Oashi/mod|-8|9|w}} = -8 = -8 = {{#expr:-8mod9}}
  • {{Wikipedista:Oashi/mod|-8|9|}} = -8
  • {{Wikipedista:Oashi/mod|-8|9|+}} = 1

záporný jmenovatel

• výchozí snadný
  • {{Wikipedista:Oashi/mod|14|9}} = 5
  • {{Wikipedista:Oashi/mod|14|9|w}} = 5 = 5 = {{#expr:14mod9}}
  • {{Wikipedista:Oashi/mod|14|9|}} = 5
  • {{Wikipedista:Oashi/mod|14|9|+}} = 5
• obrácení jmenovatele
  • {{Wikipedista:Oashi/mod|14|-9}} = -4
  • {{Wikipedista:Oashi/mod|14|-9|w}} = 5 = 5 = {{#expr:14mod-9}}
  • {{Wikipedista:Oashi/mod|14|-9|}} = 5
  • {{Wikipedista:Oashi/mod|14|-9|+}} = 5
• čitatel absolutně menší, kladný
  • {{Wikipedista:Oashi/mod|5|-9}} = -4
  • {{Wikipedista:Oashi/mod|5|-9|w}} = 5 = 5 = {{#expr:5mod-9}}
  • {{Wikipedista:Oashi/mod|5|-9|}} = 5
  • {{Wikipedista:Oashi/mod|5|-9|+}} = 5

oba záporné

• oba záporné
  • {{Wikipedista:Oashi/mod|-14|-9}} = -5
  • {{Wikipedista:Oashi/mod|-14|-9|w}} = -5 = -5 = {{#expr:-14mod-9}}
  • {{Wikipedista:Oashi/mod|-14|-9|}} = -5
  • {{Wikipedista:Oashi/mod|-14|-9|+}} = 4
• čitatel absolutně menší
  • {{Wikipedista:Oashi/mod|-5|-9}} = -5
  • {{Wikipedista:Oashi/mod|-5|-9|w}} = -5 = -5 = {{#expr:-5mod-9}}
  • {{Wikipedista:Oashi/mod|-5|-9|}} = -5
  • {{Wikipedista:Oashi/mod|-5|-9|+}} = 4

metoda	17 mod 9	17 mod -9	-17 mod 9	-17 mod -9
null	8	-1	1	-8
"w"	8	8	-8	-8
""	8	8	-8	-8
"+"	8	8	1	1

validace

• {{Wikipedista:Oashi/mod|x|-9}} =
• {{Wikipedista:Oashi/mod|x|-9|w}} =
• {{Wikipedista:Oashi/mod|x|-9|+}} =

• {{Wikipedista:Oashi/mod|5|}} =
• {{Wikipedista:Oashi/mod|5||w}} =
• {{Wikipedista:Oashi/mod|5||+}} =

• {{Wikipedista:Oashi/mod|5}} =
• {{Wikipedista:Oashi/mod|5}} =
• {{Wikipedista:Oashi/mod|5}} =

• {{Wikipedista:Oashi/mod|0|-9}} = 0
• {{Wikipedista:Oashi/mod|0|-9|w}} = 0
• {{Wikipedista:Oashi/mod|0|-9|+}} = 0

• {{Wikipedista:Oashi/mod|5|0}} =
• {{Wikipedista:Oashi/mod|5|0|w}} =
• {{Wikipedista:Oashi/mod|5|0|+}} =

Validace hodnot

Šablona používá pro účely výpočtu tři nepojmenované hodnoty:

• 1 = čitatel: celé číslo, požadovaný (validováno)
• 2 = jmenovatel: celé číslo, nenulový, požadovaný (validováno)
• 3 = metoda: určuje metodu výpočtu a tedy i vlastnosti výstupu, "volitelný"... (nevalidováno, možnými hodnotami pokryty všechny možnosti, přijme cokoli)
  • a) I jeho nepřítomnost už je považována za hodnotu, určuje "ruční" metodu výpočtu pomocí interní funkce round.
  • b) Metoda pro vracení vždy kladné hodnoty, aktivovaná hodnotou "+" (znaménko plus jako vstupní string).
  • c) Metoda na základě interní funkce mod. Ativována čímkoli jiným: Například stringy "", "w", "wiki"...

Validace parametrů pro použití v šablonách

Účelem je využít již zde existující mechanismus chybových hlášení i pro další šablony, které v sobě budou tuto šablonu používat.

Šablona používá pro účely nastavení textací do chybových hlášení tři pojmenované parametry:

• z - šablona, která se má v chybovém hlášení zobrazovat
• param1 - název vstupu 1, čitatele, jak se má zobrazovat v hlášeních následnických šablon
• param2 - název vstupu 2, jmenovatele, jak se má zobrazovat v hlášeních následnických šablon

-1 null

8 w

8 ""

8 +

• 1 null
• -8 w
• -8 ""
• 1 +

• -8 null
• -8 w
• -8 ""
• 1 +

validace

• {{Wikipedista:Oashi/mod|5|3}} = 2
• {{Wikipedista:Oashi/mod|5|-9}} = -4
• {{Wikipedista:Oashi/mod|-5|-9}} = -5
• {{Wikipedista:Oashi/mod|0|-9}} = 0
• {{mod|0|-9|}} = 0

• {{Wikipedista:Oashi/mod}} =
• {{Wikipedista:Oashi/mod||}} =
• {{Wikipedista:Oashi/mod|5}} =
• {{Wikipedista:Oashi/mod|5|}} =
• {{mod|5||+}} =
• {{Wikipedista:Oashi/mod|x|9}} =
• {{Wikipedista:Oashi/mod|x|-9}} =
• {{mod|x|-9|w}} =
• {{Wikipedista:Oashi/mod|5|y}} =
• {{Wikipedista:Oashi/mod|x|y}} =
• {{Wikipedista:Oashi/mod|2=y|9}} =
• {{Wikipedista:Oashi/mod|5|0}} =
• {{mod|5|0|wiki}} =
• {{Wikipedista:Oashi/mod|5|0|z=M|param1=cit|param2=jm}} =
• {{Wikipedista:Oashi/mod|5|1.5}} =
• {{Wikipedista:Oashi/mod|5.5|3}} =
• {{Wikipedista:Oashi/mod|7.7|-9}} =

• {{Wikipedista:Oashi/mod|x|9|z=M|param1=cit|param2=jm}} =
• {{Wikipedista:Oashi/mod|x|9|z=M|param1=|param2=jm}} =
• {{Wikipedista:Oashi/mod|x|9|z=M|param1=cit}} =
• {{Wikipedista:Oashi/mod|x|9|z=|param1=cit}} =
  
• {{Wikipedista:Oashi/mod|x|9|param1=cit}} =
  
• {{Wikipedista:Oashi/mod|5|9|param1=cit}} =
  5

• {{Wikipedista:Oashi/mod|5|y|z=M|param1=cit|param2=jm}} =
• {{Wikipedista:Oashi/mod|5|y|z=M|param1=cit|param2=}} =
• {{Wikipedista:Oashi/mod|5|y|z=M|param1=cit}} =
• {{Wikipedista:Oashi/mod|5|y|z=M|param1=|param2=jm}} =
• {{Wikipedista:Oashi/mod|5|y|z=M|param2=jm}} =
• {{Wikipedista:Oashi/mod|5|y|z=M|param2=jm}} =
• {{Wikipedista:Oashi/mod|5|y|z=M|param2=}} =
• {{Wikipedista:Oashi/mod|5|y|z=M}} =
• {{Wikipedista:Oashi/mod|5|y|z=|param2=jm}} =
  
• {{Wikipedista:Oashi/mod|5|y|param2=jm}} =
  
• {{Wikipedista:Oashi/mod|5|y|param2=}} =
• {{Wikipedista:Oashi/mod|5|9|param2=}} = 5