PHPBuilder.com, the best resource for PHP tutorials, templates, PHP manuals, content management systems, scripts, classes and more.

Index: phpdoc/pl/functions/math.xml +++ phpdoc/pl/functions/math.xml Funkcje Matematyczne Math Wprowadzenie Om�wione poni�ej funkcje operuj� na warto�ciach z przedzia��w typ�w integer i float na twoim komputerze (co odpowiada zakresowi long resp. double j�zyka C). Je�li potrzebujesz obs�ugi wi�kszych liczb, zajrzyj do funkcji matematycznych dla liczb dowolnej dok�adno�ci Sta�e matematyczne Poni�sze warto�ci s� zdefiniowane w PHP jako sta�e w rozszerzeniu matematycznym:

Sta�e matematyczne Sta�a Wartos� Opis M_PI 3.14159265358979323846 Pi M_E 2.7182818284590452354 e M_LOG2E 1.4426950408889634074 log_2 e M_LOG10E 0.43429448190325182765 log_10 e M_LN2 0.69314718055994530942 log_e 2 M_LN10 2.30258509299404568402 log_e 10 M_PI_2 1.57079632679489661923 pi/2 M_PI_4 0.78539816339744830962 pi/4 M_1_PI 0.31830988618379067154 1/pi M_2_PI 0.63661977236758134308 2/pi M_SQRTPI 1.77245385090551602729 sqrt(pi) [4.0.2] M_2_SQRTPI 1.12837916709551257390 2/sqrt(pi) M_SQRT2 1.41421356237309504880 sqrt(2) M_SQRT3 1.73205080756887729352 sqrt(3) [4.0.2] M_SQRT1_2 0.70710678118654752440 1/sqrt(2) M_LNPI 1.14472988584940017414 log_e(pi) [4.0.2] M_EULER 0.57721566490153286061 Sta�a Eulera [4.0.2]

Tylko sta�a M_PI by�a dost�pna w wsze�niejszych wersjach PHP do PHP4RC1 w��cznie. Pozosta�e pojawi�y si� w PHP 4.0. Sta�e oznaczone [4.0.2] zosta�y dodane w PHP 4.0.2. abs Warto�� bezwgl�dna (modu� z liczby) Opis mixed abs mixed liczba Zwraca warto�� bezwzgl�dn� podanej liczby. Je�li argument is typu float, zwracana warto�� jest tak�e float, inaczej zwracana jest warto�� integer (float ma zwykle szerszy zakres ni� integer). acos Arcus cosinus Opis float acos float argument Zwraca w radianach arcus cosinus argumentu. Zobacz te� acosh, asin i atan. acosh Odwrotny cosinus hiperboliczny Opis float acosh float arg Zwraca odwrotny cosinus hiperboliczny z liczby arg, tzn. tak� warto��, kt�rej cosinus hiperboliczny r�wny arg. ¬e.no-windows; Zobacz te� acos, asin and atan. asin Arcus sinus Opis float asin float argument Zwraca w radianach arcus sinus argumentu. Zobacz te� asinh, acos i atan. asinh Odwrotny sinus hiperboliczny Opis float asinh float arg Zwraca odwrotny sinus hiperboliczny z liczby arg, tzn. tak� warto��, kt�rej sinus hiperboliczny jest r�wny arg. ¬e.no-windows; Zobacz te� asin, acos and atan. atan Arcus tangens Opis float atan float argument Zwraca w radianach arcus tangens argumentu. Zobacz te� atanh, asin i acos. atanh Odwrotny tangens hiperboliczny Opis float atanh float arg Zwraca odwrotny tangens hiperboliczny z liczby arg, tzn. tak� warto��, dla kt�rej tangens hiperboliczny jest r�wny arg. ¬e.no-windows; Zobacz te� atan, asin and acos. atan2 Arcus tangens dw�ch zmiennych Opis float atan2 float y float x Ta funkcja oblicza arcus tangens dw�ch zmiennych x i y. Jej dzia�anie przypomina obliczanie arcus tangens z y / x, a do tego, znaki obydwu argument�w wykorzystywane s� do okre�lenia �wiartki (kwadrantu) uk�adu wsp�rz�dnych. Funkcja zwraca warto�� w radianach, zawieraj�c� si� mi�dzy -PI a PI w��cznie. Zobacz te� acos i atan. base_convert Konwertuje liczb� pomi�dzy r�nymi systemami liczbowymi Opis string base_convert string liczba int system_bazowy int system_docelowy Zwraca �a�cuch znak�w zawieraj�cy liczb� w reprezentacji w system_docelowy. System w kt�rym podajemy liczb� jest okre�lony w system_bazowy. Parametry system_bazowy i system_docelowy musz� zawiera� si� pomi�dzy 2 a 36 w��cznie. Cyfry w liczbach o bazie wi�kszej ni� 10 s� reprezentowane za pomoc� liter a-z, gdzie a oznacza 10, b oznacza 11, a z oznacza 35. <function>base_convert</function> bindec Konwertuje liczb� dw�jkow� na dziesi�tn� Opis int bindec string liczba_dw�jkowa Zwraca liczb� dziesi�tn� odpowiadaj�c� liczbie dw�jkowej podane w argumencie liczba_dw�jkowa. bindec konwertuje liczby dw�jkowe do liczb ca�kowitych. Najwi�ksz� konwertowan� liczb� jest 31 bit�w 1 czyli 2 147 483 647 dziesi�tnie. Zobacz te� decbin. ceil Zaokr�gla u�amki w g�r� Opis float ceil float liczba Zwraca nabli�sz� liczb� ca�kowit�, wi�ksz� lub r�wn� podanemu argumentowi liczba. Zwracana przez funkcj� ceil warto�� jest nadal typu float gdy� zakres tego typu jest zwykle wi�kszy ni� zakres typu int. Zobacz te� floor i round. cos Cosinus Opis float cos float argument Zwraca cosinus k�ta argument podanego w radianach. Zobacz te� sin i tan. cosh Cosinus hiperboliczny Opis float cosh float arg Zwraca cosinus hiperboliczny z liczby arg, definiowany jako (exp(arg) + exp(-arg))/2. Zobacz te� cos, acosh, sin and tan. decbin Konwertuje liczb� dziesi�tn� do dw�jkowej Opis string decbin int liczba Zwraca �a�cuch znak�w stanowi�cy dw�jkow� reprezentacj� liczby dziesi�tnej podanej jako argument. Najwi�ksz� liczb� mo�liw� do skonwertowania jest 2 147 483 647 dziesi�tnie, co r�wne jest 31 bitom 1. Zobacz te� bindec. dechex Konwersja liczby dziesi�tnej do szesnastkowej Opis string dechex int liczba Zwraca �a�cuch znak�w stanowi�cy szesnastkow� reprezentacj� podanej liczby dziesi�tnej. Najwi�ksz� liczb�, kt�ra mo�e by� skonwertowana jest 2 147 483 647 dziesi�tnie, co odpowiada "7fffffff" szesnastkowo. Zobacz te� hexdec. decoct Konwersja liczby dziesi�tnej do �semkowej Opis string decoct int liczba Zwraca �a�cuch znak�w zawieraj�cy �semkow� reprezentacj� podanej liczby dziesi�tnej. Najwi�ksz liczb�, kt�ra mo�e by� skonwertowana jest 2 147 483 647 dziesi�tnie, co odpowiada "17777777777" �semkowo. Zobacz te� octdec. deg2rad Przelicza stopnie na radiany Opis float deg2rad float liczba deg2rad przelicza stopnie podane w liczba na radiany. Zobacz te� rad2deg. exp e do pot�gi ... Opis float exp float argument Zwraca e podniesione do pot�gi argument. Zobacz te� pow. floor Zaokr�gla u�amki w d� Opis float floor float liczba Zwraca najbli�sz� liczb� ca�kowit�, mniejsz� lub r�wn� podanemu arumentowi liczba. Zwracana przez funkcj� floor warto�� jest nadal typu float gdy� zakres tego typu jest zwykle wi�kszy ni� zakres typu int. Zobacz te� ceil i round. getrandmax Najwi�ksza mo�liwa liczba losowa Opis int getrandmax Zwraca najwi�ksz� liczb�, jaka mo�e by� zwr�cona przez funkcj� rand. Zobacz te� rand, srand, mt_rand, mt_srand, i mt_getrandmax. hexdec Konwersja liczby szesnastkowej do dziesi�tnej Opis int hexdec string hex_string Zwraca dziesi�tny odpowiednik liczby szesnastkowej podanej w argumencie hex_string. hexdeckownertuje szesnastkowy �a�cuch znak�w do postaci liczby dziesi�tnej. Najwi�ksz� liczb�, kt�ra mo�e by� skonwertowana jest 7fffffff, czyli 2147483647 dziesi�tnie. hexdec zast�pi ka�dy znak, nie b�d�cy cyfr� w systemie szesnastkowym liczb� 0. W ten spos�b, wszystko zera stoj�ce z lewej strony s� ignorowane, ale zera z prawej strony s� brane pod uwag�. Przyk�ad zastosowania <function>hexdec</function> Zobacz te� dechex. lcg_value Z�o�ony przystaj�cy generator liniowy Opis float lcg_value lcg_value zwraca liczb� pseudolosow� z przedzia�u (0, 1). Funkcja ��czy dwa CG o okresach 2^31 - 85 i 2^31 - 249. Okres tej funkcji jest r�wny warto�ci obydwu sk�adowych. log Logarytm naturalny Opis float log float argument Zwraca logarytm naturalny z liczby argument. log10 Logarytm dziesi�tny Opis float log10 float argument Zwraca logarytm dziesi�tny z argument. max Znajduje najwi�ksz� liczb� Opis mixed max mixed arg1 mixed arg2 mixed argn max zwraca najwi�ksz� liczb� spo�r�d podanych argument�w. Je�li pierwszy argument jest tablic�, max zwr�ci najwi�ksz� liczb� z tej tablicy. Je�li pierwszy argument jest liczb� ca�kowit�, zmiennoprzecinkow� czy �a�cuchem znak�w, musisz mie� conajmniej dwa argumenty, spomi�dzy kt�rych funkcja max zwr�ci najwi�ksz� warto��. Za pomoc� tej funkcji mo�esz por�wnywa� nieograniczon� ilo�� liczb. Je�li jedna lub wi�cej podanych liczb jest zmiennoprzecinkowa, wszystkie liczby zostan� potraktowane jak zmiennoprzecinkowe i tak�e liczba zmiennoprzecinkowa zostanie zwr�cona. Je�li �adna z liczb nie b�dzie zmiennoprzecinkow�, wszystkie zostan� potraktowane jako ca�kowite i liczba ca�kowita zostanie zwr�cona. min Znajduje najmniejsz� warto�� Opis number min number arg1 number arg2 ... number min array liczby min zwraca najmniejsz� liczb� spo�r�d podanych argument�w. W pierwszym wariancie, po podaniu co najmniej dw�ch argument�w, min zwr�ci najmniejszy z nich. Mo�na por�wnywa� nieograniczon� ilo�� warto�ci. W drugim wariancie, min zwr�ci najmniejsz� warto�� z tablicy liczby. Je�li jedna lub wi�cej warto�ci jest typu , wszystkie warto�ci zostan� potraktowane jako zmiennoprzecinkowe i taka te� liczba zostanie zwr�cona. Je�li �adna spo�r�d warto�ci nie jest typu float, wszystkie zostan� potraktowane jako integer i warto�� ca�kowita zostanie zwr�cona. mt_rand Wygeneruj lepsz� liczb� losow� Opis int mt_rand int mt_rand int min int max Wiele generator�w liczb losowych w starych libc maj� niepewne albo nieznane charakterystyki i s� powolne. Domy�lnie PHP u�ywa generatora liczb losowych z libc w funkcji rand. Funkcja mt_rand jest jej zamiennikiem. U�ywa ona generatora liczb losowych o znanej charakterystyce, Mersenne Twistera, kt�ry generuje liczby losowe w sam raz dla wi�kszo�ci potrzeb kryptografii (aby dowiedzie� si� wi�cej, zajrzyj na strony www Mersenne Twistera) i dzia�a cztery razy szybciej od typowych generator�w zawartych w libc. Stron� www Mersene Twistera mo�na znale�� pod adresem &url.mersenne;, a zoptymalizowan� wersj� kodu �r�d�owego MT pod adresem &url.mersenne.twister;. Je�li funkcja zostanie wywo�ana bez opcjonalnych argument�w min i max, funkcja mt_rand zwr�ci liczb� pseudolosow� z przedzia�u pomi�dzy 0 a RAND_MAX. Je�li na przyk�ad potrzebujesz liczby losowej z przedzia�u od 5 do 15 w��cznie, u�yj mt_rand (5, 15). Pami�taj, aby przed u�yciem tej funkcji inicjalizowa� generator liczb losowych za pomoc� mt_srand. W wersjach przed 3.0.7 argument max znaczy� zakres. Aby otrzyma� takie same wyniki w tych�e wersjach, nale�y u�y� mt_rand (5, 11) aby otrzyma� liczb� losow� z przedzia�u od 5 do 15. Zobacz te� mt_srand, mt_getrandmax, srand, rand i getrandmax. mt_srand Inicjalizuj generator Mersenne Twister Opis void mt_srand int ziarno Inicjalizuje generator liczb losowych za pomoc� ziarna ziarno. Zobacz te� mt_rand, mt_getrandmax, srand, rand, i getrandmax. mt_getrandmax Najwi�ksza mo�liwa liczba losowa Opis int mt_getrandmax Zwraca najwi�ksz� liczb� losow�, jak� mo�e zwr�ci� funkcja mt_rand. Zobacz te� mt_rand, mt_srand rand, srand, i getrandmax. number_format Formatuje liczb� wed�ug szablonu Opis string number_format float liczba int miejsc_dziesi�tnych string przecinek_dziesi�tny string separator_tysi�cy Funkcja number_format zwraca sformatowan� liczb� liczba wed�ug podanych argument�w. Ta funkcja przyjmuje jeden, dwa lub cztery argumenty (nie trzy): Je�li podany jest tylko jeden argument, liczba zostanie sformatowana bez miejsc dziesi�tnych ale z przecinkiem (",") pomi�dzy ka�d� grup� tysi�cy. Je�li podane s� dwa argumenty, liczba b�dzie sformatowana z miejsc_dziesi�tnych, z kropk� (".") w charakterze przecinka dziesi�tnego i przecinkiem (",") pomi�dzy ka�d� grup� tysi�cy. Kiedy wszystkie cztery parametry s� podane, liczba liczba b�dzie sformatowana z miejsc_dziesi�tnych, z przecinek_dziesi�tny zamiast kropki (".") i separator_tysi�cy pomi�dzy ka�d� grup� tysi�cy. Tylko pierwszy znak z separator_tysi�cy jest wykorzystywany. Na przyk�ad, je�li u�yjesz foo jako separatora, to z liczby 1000 funkcja zwr�ci 1f000. <function>number_format</function> - przyk�ady W polskiej notacji liczbowej u�ywa si� przecinka (",") jako przecinka dziesi�tnego i spacji (" ") jako separatora tysi�cy. W PHP mo�na to zrobi� tak: Zobacz te� sprintf, printf i sscanf. octdec Konwersja liczby �semkowej do dziesi�tnej Opis int octdec string liczba_�semkowa Zwraca dziesi�tny odpowiednik liczby �semkowej podanej jako argument liczba_�semkowa. OctDec zamienia an �a�cuch �semkowy na liczb� dziesi�tn�. Najwi�ksz� liczb�, jaka mo�e by� skonwertowana jest 17777777777 �semkowo, czyli 2147483647 dziesi�tnie. Zobacz te� decoct. pi Warto�� liczby Pi Opis float pi Zwraca przybli�on� warto�� liczby pi. pow Pot�gowanie Opis number pow number podstawa number wyk�adnik Zwraca argument podstawa podniesiony do pot�gi wyk�adnik. Je�li mo�liwe, funkcja zwr�ci typ integer. Je�li nie da si� obliczy� pot�gi, zostanie wy�wietlone ostrze�enie a funkcja pow zwr�ci &false;. Par� przyk�ad�w z <function>pow</function> ]]> W PHP 4.0.6 i wcze�niejszych funkcja pow zawsze zwraca�a typ float i nie wy�wietla�a ostrze�e�. Zobacz te� exp. rad2deg Przelicza radiany na stopnie. Opis float rad2deg float liczba rad2deg przelicza k�t liczba podany w radianach na jego odpowiednik w stopniach. Zobacz te� deg2rad. rand Wygeneruj liczb� losow� Opis int rand int rand int min int max Je�li wywo�ana bez opcjonalnych argument�w min i max, funkcja rand zwraca liczb� pseudolosow� z przedzia�u pomi�dzy 0 a RAND_MAX. Je�li potrzebujesz liczby losowej z przedzia�u np. od 5 do 15 (w��cznie), u�yj rand (5,15). Pami�taj, aby przed u�yciem tej funkcji inicjalizowa� generator liczb losowych za pomoc� srand. W wersjach przed 3.0.7 argument max znaczy� zakres. Aby otrzyma� takie same wyniki w tych�e wersjach, nale�y u�y� rand (5, 11) aby otrzyma� liczb� losow� z przedzia�u od 5 do 15. Zobacz te� srand, getrandmax, mt_rand, mt_srand i mt_getrandmax. round Zaokr�gla liczb� zmiennoprzecinkow� Opis float round float warto�� int dok�adno�� Zwraca zaokr�glon� warto�� argumentu warto�� do miejsca po przecinku okre�lonego w dok�adno��. dok�adno�� mo�e by� tak�e ujemny lub r�wny zero (domy�lnie). PHP domy�lnie nie obs�uguje poprawnie �a�cuch�w znak�w takich jak "12,300.2". Zobacz konwersje z �a�cuch�w znak�w . Argument dok�adno�� jest dost�pny tylko w PHP 4. Zobacz te� ceil i floor. sin Sinus Opis float sin float Zwraca sinus k�ta argument podanego w radianach. Zobacz te� cos i tan. sinh Sinus hiperboliczny Opis float sinh float arg Zwraca sinus hiperboliczny z liczby arg, definiowany jako (exp(arg) - exp(-arg))/2. Zobacz te� sin, asinh, cos and tan. sqrt Pierwiastek kwadratowy Opis float sqrt float argument Zwraca pierwiastek kwadratowy z argument. srand Inicjalizuje generator liczb losowych Opis void srand int ziarno Inicjalizuje generator liczb losowych za pomoc� ziarna ziarno. Zobacz te� rand, getrandmax, mt_rand, mt_srand, i mt_getrandmax. tan Tangens Opis float tan float argument Zwraca tangens k�ta argument podanego w radianach. Zobacz te� sin i cos. tanh Tangens hiperboliczny Opis float tanh float arg Zwraca tangens hiperboliczny z liczby arg, definiowanej jako sinh(arg)/cosh(arg). Zobacz te� tan, atanh, sin and cos.