28. Práce s čísly - základy

Ilustrační obrázek k článku: Práce s čísly - základy
Čísla patří k základům každého jazyka. Začneme proto právě funkcemi, které se týkají čísel. Jak už jsem dříve zmínil, tak funkce týkající se čísel budu prefixovat nm_.

A funkce prefixované nm_ uložím logicky do knihovny nm_Util. Knihovnu začneme již definovanou ošetřenou hlavičkou pro PHP včetně zapnutí strict módu pro javascript. V jednotlivých funkcích budu používat pro rozvětvení JS a PHP kódu již dříve definovaný CombiScriptový přepínač.

A jako první si vytvoříme funkci nm_IsNumber, která nám ověří zda v proměnné je číslo. Pro JS použijeme klasickou konstrukci typeof. V PHP existují dva číselné typy float a int a proto pro detekci použijeme pro to určené funkce is_int a is_float samozřejmě s operátorem OR. Výsledná funkce bude vypadat takto:

  1. <!-- --><?php /*
  2. "use strict";
  3. //*/
  5. function nm_IsNumber($num)
  6. {
  7. 0&&0<!--$_;/*
  8. return typeof $num === 'number';
  9. /*/
  10. return is_int($num) OR is_float($num);
  11. //*/
  12. }

Jako další bychom si chtěli vytvořit funkci vracející absolutní hodnotu čísla. Pro PHP použijeme abs a pro JS použijeme Math.abs

  1. function nm_Abs($num)
  2. {
  3. 0&&0<!--$_;/*
  4. return Math.abs($num);
  5. /*/
  6. return abs($num);
  7. //*/
  8. }

Ovšem u této funkce se na chvilku zastavíme. V definici jazyka jsme se shodli, že bude striktně kontrolovat typy. A funkce nm_Abs by měla vracet absolutní hodnotu jen čísel, bez automatického přetypování, které by v každém jazyce dopadlo jinak. Dál jsme říkali, že při chybném vstupu funkce budeme vyhazovat výjimku.

Teď je otázka jaký by měl být obsah této výjimky. Preferuji, aby výjimka šla snadno strojově zpracovat - teprve potom lidsky číst. Měla by obsahovat jasný kód a parametry s podrobnostmi. Opravdu nesnáším výjimky (či SQL error kódy) ve tvaru "Duplicate entry abc for key xyz", kde si programátor musí parametry "abc" a "xyz" vyparsovat (a pak mu někdo přepne SQL engine do češtiny).

Funkce s kódem volajícím výjimku by podle mne měla vypadat nějak takto:

  1. function nm_Abs($num)
  2. {
  3. if (!nm_IsNumber($num)) throw new cs_Error('nm_Abs-$num-NotNumber', [cs_Type($num)]);
  4. 0&&0<!--$_;/*
  5. return Math.abs($num);
  6. /*/
  7. return abs($num);
  8. //*/
  9. }

Kde cs_Error je třída výjimky a cs_Type je funkce vracející typ proměnné. Zároveň je vidět jak budu konstruovat chybové kódy výjimek. Odděluji znakem "-", jako první uvádím název funkce, kde chyba nastala, jako další v jakém parametru a jako další typ chyby, kde používám PascalCase (Upper-CamelCase) syntaxi.

Dále si stejným způsobem naprogramujeme funkci nm_Sign. Pro JS můžeme využít Math.sign PHP funkci sign nemá. Musíme si jí naprogramovat sami. Jako nejhezčí algoritmus se mi jeví rozdíl mezi boolean hodnotami :-) konstatujících zde je číslo větší a menší než nula.

  1. function nm_Sign($num)
  2. {
  3. if (!nm_IsNumber($num)) throw new cs_Error('nm_Sign-$num-NotNumber', [cs_Type($num)]);
  4. 0&&0<!--$_;/*
  5. return Math.sign($num);
  6. /*/
  7. return ($num > 0) - ($num < 0);
  8. //*/
  9. }

A nakonec přidáme funkci nm_AsInt. V této funkci budeme kontrolovat zda se nějaké číslo "tváří" jako celé. V JS toto zjistit není problém, má na to přímo funkci Number.isInteger($num). V PHP docílíme stejné funkčnosti odříznutím desetinné části a porovnáním.

  1. function nm_IsAsInt($num)
  2. {
  3. 0&&0<!--$_;/*
  4. return Number.isInteger($num);
  5. /*/
  6. if (is_int($num)) return true;
  7. return (is_float($num) && floor($num) === $num);
  8. //*/
  9. }

Nyní si celou naši knihovnu můžeme shrnout:

nm_Util.php.js
  1. <!-- --><?php /*
  2. "use strict";
  3. //*/
  4. function nm_IsNumber($num)
  5. {
  6. 0&&0<!--$_;/*
  7. return typeof $num === 'number'
  8. /*/
  9. return is_int($num) OR is_float($num);
  10. //*/
  11. }
  13. function nm_Abs($num)
  14. {
  15. if (!nm_IsNumber($num)) throw new cs_Error('nm_Abs-$num-NotNumber', [cs_Type($num)]);
  16. 0&&0<!--$_;/*
  17. return Math.abs($num);
  18. /*/
  19. return abs($num);
  20. //*/
  21. }
  23. function nm_Sign($num)
  24. {
  25. if (!nm_IsNumber($num)) throw new cs_Error('nm_Sign-$num-NotNumber', [cs_Type($num)]);
  26. 0&&0<!--$_;/*
  27. return Math.sign($num);
  28. /*/
  29. return ($num > 0) - ($num < 0);
  30. //*/
  31. }
  33. function nm_IsAsInt($num)
  34. {
  35. 0&&0<!--$_;/*
  36. return Number.isInteger($num);
  37. /*/
  38. if (is_int($num)) return true;
  39. return (is_float($num) && floor($num) === $num);
  40. //*/
  41. }

Tvorbu nm_Util tady na chvíli přerušíme. Příště se pustíme do knihovny cs_Util, kde vznikne třída cs_Error. Ta bude umět přijímat více parametrů - což není u výjimek zcela běžné a může se Vám to hodit i v čistém PHP nebo JS.

Předchozí   Následující