leszek Fri Nov 30 03:06:54 2001 EDT
Added files:
/phpdoc/pl/functions math.xml
Log:
Math.xml FINISHED! After more than six weeks...
Index: phpdoc/pl/functions/math.xml
+++ phpdoc/pl/functions/math.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- $Revision: 1.1 $ -->
<!-- t�umacz Tomasz W�jtowicz <[EMAIL PROTECTED]>
t�umaczone z wersji 1.2 angielskiego math.xml 2001-10-12
aktualizacja do wersji en 1.8 z naszego CVSu w dniu 2001-11-29
-->
<reference id="ref.math">
<title>Funkcje Matematyczne</title>
<titleabbrev>Math</titleabbrev>
<partintro>
<sect1 id="math.intro">
<title>Wprowadzenie</title>
<para>
Om�wione poni�ej funkcje operuj� na warto�ciach z przedzia��w typ�w
<type>integer</type> i <type>float</type> na twoim komputerze (co odpowiada
zakresowi long resp. double j�zyka C).
Je�li potrzebujesz obs�ugi wi�kszych liczb, zajrzyj do <link
linkend="ref.bc">funkcji matematycznych dla liczb dowolnej dok�adno�ci
</link>
</para>
<sect2 id="math.constants">
<title>Sta�e matematyczne</title>
<para>
Poni�sze warto�ci s� zdefiniowane w PHP jako sta�e w rozszerzeniu
matematycznym:
<table>
<title>Sta�e matematyczne</title>
<tgroup cols="3">
<thead>
<row>
<entry>Sta�a</entry>
<entry>Wartos�</entry>
<entry>Opis</entry>
</row>
</thead>
<tbody>
<row>
<entry>M_PI</entry>
<entry>3.14159265358979323846</entry>
<entry>Pi</entry>
</row>
<row>
<entry>M_E</entry>
<entry>2.7182818284590452354</entry>
<entry>e</entry>
</row>
<row>
<entry>M_LOG2E</entry>
<entry>1.4426950408889634074</entry>
<entry>log_2 e</entry>
</row>
<row>
<entry>M_LOG10E</entry>
<entry>0.43429448190325182765</entry>
<entry>log_10 e</entry>
</row>
<row>
<entry>M_LN2</entry>
<entry>0.69314718055994530942</entry>
<entry>log_e 2</entry>
</row>
<row>
<entry>M_LN10</entry>
<entry>2.30258509299404568402</entry>
<entry>log_e 10</entry>
</row>
<row>
<entry>M_PI_2</entry>
<entry>1.57079632679489661923</entry>
<entry>pi/2</entry>
</row>
<row>
<entry>M_PI_4</entry>
<entry>0.78539816339744830962</entry>
<entry>pi/4</entry>
</row>
<row>
<entry>M_1_PI</entry>
<entry>0.31830988618379067154</entry>
<entry>1/pi</entry>
</row>
<row>
<entry>M_2_PI</entry>
<entry>0.63661977236758134308</entry>
<entry>2/pi</entry>
</row>
<row>
<entry>M_SQRTPI</entry>
<entry>1.77245385090551602729</entry>
<entry>sqrt(pi) [4.0.2]</entry>
</row>
<row>
<entry>M_2_SQRTPI</entry>
<entry>1.12837916709551257390</entry>
<entry>2/sqrt(pi)</entry>
</row>
<row>
<entry>M_SQRT2</entry>
<entry>1.41421356237309504880</entry>
<entry>sqrt(2)</entry>
</row>
<row>
<entry>M_SQRT3</entry>
<entry>1.73205080756887729352</entry>
<entry>sqrt(3) [4.0.2]</entry>
</row>
<row>
<entry>M_SQRT1_2</entry>
<entry>0.70710678118654752440</entry>
<entry>1/sqrt(2)</entry>
</row>
<row>
<entry>M_LNPI</entry>
<entry>1.14472988584940017414</entry>
<entry>log_e(pi) [4.0.2]</entry>
</row>
<row>
<entry>M_EULER</entry>
<entry>0.57721566490153286061</entry>
<entry>Sta�a Eulera [4.0.2]</entry>
</row>
</tbody>
</tgroup>
</table>
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.
</para>
</sect2>
</sect1>
</partintro>
<refentry id="function.abs">
<refnamediv>
<refname>abs</refname>
<refpurpose>Warto�� bezwgl�dna (modu� z liczby)</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>abs</function></funcdef>
<paramdef>mixed <parameter>liczba</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca warto�� bezwzgl�dn� podanej liczby. Je�li argument is typu
<type>float</type>, zwracana warto�� jest tak�e <type>float</type>,
inaczej zwracana jest warto�� <type>integer</type> (<type>float</type>
ma zwykle szerszy zakres ni� <type>integer</type>).
</para>
</refsect1>
</refentry>
<refentry id="function.acos">
<refnamediv>
<refname>acos</refname>
<refpurpose>Arcus cosinus</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>acos</function></funcdef>
<paramdef>float <parameter>argument</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca w radianach arcus cosinus argumentu.
</para>
<para>
Zobacz te� <function>acosh</function>,
<function>asin</function> i <function>atan</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.acosh">
<refnamediv>
<refname>acosh</refname>
<refpurpose>Odwrotny cosinus hiperboliczny</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>acosh</function></funcdef>
<paramdef>float <parameter>arg</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca odwrotny cosinus hiperboliczny z liczby <parameter>arg</parameter>,
tzn. tak� warto��, kt�rej cosinus hiperboliczny r�wny
<parameter>arg</parameter>.
</para>
¬e.no-windows;
<para>
Zobacz te� <function>acos</function>, <function>asin</function>
and <function>atan</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.asin">
<refnamediv>
<refname>asin</refname>
<refpurpose>Arcus sinus</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>asin</function></funcdef>
<paramdef>float <parameter>argument</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca w radianach arcus sinus argumentu.
</para>
<para>
Zobacz te� <function>asinh</function>, <function>acos</function>
i <function>atan</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.asinh">
<refnamediv>
<refname>asinh</refname>
<refpurpose>Odwrotny sinus hiperboliczny</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>asinh</function></funcdef>
<paramdef>float <parameter>arg</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca odwrotny sinus hiperboliczny z liczby <parameter>arg</parameter>,
tzn. tak� warto��, kt�rej sinus hiperboliczny jest r�wny
<parameter>arg</parameter>.
</para>
¬e.no-windows;
<para>
Zobacz te� <function>asin</function>, <function>acos</function>
and <function>atan</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.atan">
<refnamediv>
<refname>atan</refname>
<refpurpose>Arcus tangens</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>atan</function></funcdef>
<paramdef>float <parameter>argument</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca w radianach arcus tangens argumentu.
</para>
<para>
Zobacz te� <function>atanh</function>,
<function>asin</function> i <function>acos</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.atanh">
<refnamediv>
<refname>atanh</refname>
<refpurpose>Odwrotny tangens hiperboliczny</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>atanh</function></funcdef>
<paramdef>float <parameter>arg</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca odwrotny tangens hiperboliczny z liczby <parameter>arg</parameter>,
tzn. tak� warto��, dla kt�rej tangens hiperboliczny jest r�wny
<parameter>arg</parameter>.
</para>
¬e.no-windows;
<para>
Zobacz te� <function>atan</function>, <function>asin</function>
and <function>acos</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.atan2">
<refnamediv>
<refname>atan2</refname>
<refpurpose>Arcus tangens dw�ch zmiennych</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>atan2</function></funcdef>
<paramdef>float <parameter>y</parameter></paramdef>
<paramdef>float <parameter>x</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Ta funkcja oblicza arcus tangens dw�ch zmiennych <parameter>x</parameter>
i <parameter>y</parameter>. Jej dzia�anie przypomina obliczanie arcus
tangens z <parameter>y</parameter> / <parameter>x</parameter>, a do tego,
znaki obydwu argument�w wykorzystywane s� do okre�lenia �wiartki
(kwadrantu) uk�adu wsp�rz�dnych.
</simpara>
<simpara>
Funkcja zwraca warto�� w radianach, zawieraj�c� si� mi�dzy -PI a PI
w��cznie.
</simpara>
<para>
Zobacz te� <function>acos</function> i <function>atan</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.base-convert">
<refnamediv>
<refname>base_convert</refname>
<refpurpose>Konwertuje liczb� pomi�dzy r�nymi systemami liczbowymi
</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>base_convert</function></funcdef>
<paramdef>string <parameter>liczba</parameter></paramdef>
<paramdef>int <parameter>system_bazowy</parameter></paramdef>
<paramdef>int <parameter>system_docelowy</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca �a�cuch znak�w zawieraj�cy <parameter>liczb�</parameter> w
reprezentacji w <parameter>system_docelowy</parameter>. System w kt�rym
podajemy liczb� jest okre�lony w <parameter>system_bazowy</parameter>.
Parametry <parameter>system_bazowy</parameter> i
<parameter>system_docelowy</parameter> 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.
<example>
<title><function>base_convert</function></title>
<programlisting role="php">
<![CDATA[
$binary = base_convert ($hexadecimal, 16, 2);
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.bindec">
<refnamediv>
<refname>bindec</refname>
<refpurpose>Konwertuje liczb� dw�jkow� na dziesi�tn�</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>bindec</function></funcdef>
<paramdef>string <parameter>liczba_dw�jkowa</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca liczb� dziesi�tn� odpowiadaj�c� liczbie dw�jkowej podane w
argumencie <parameter>liczba_dw�jkowa</parameter>.
</para>
<para>
<function>bindec</function> konwertuje liczby dw�jkowe do liczb
ca�kowitych. Najwi�ksz� konwertowan� liczb� jest 31 bit�w 1 czyli
2 147 483 647 dziesi�tnie.
</para>
<para>
Zobacz te� <function>decbin</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.ceil">
<refnamediv>
<refname>ceil</refname>
<refpurpose>Zaokr�gla u�amki w g�r�</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>ceil</function></funcdef>
<paramdef>float <parameter>liczba</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Zwraca nabli�sz� liczb� ca�kowit�, wi�ksz� lub r�wn� podanemu argumentowi
<parameter>liczba</parameter>.
Zwracana przez funkcj� <function>ceil</function> warto�� jest nadal typu
<type>float</type> gdy� zakres tego typu jest zwykle wi�kszy ni� zakres
typu <type>int</type>.
</simpara>
<simpara>
Zobacz te� <function>floor</function> i
<function>round</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.cos">
<refnamediv>
<refname>cos</refname>
<refpurpose>Cosinus</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>cos</function></funcdef>
<paramdef>float <parameter>argument</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca cosinus k�ta <parameter>argument</parameter> podanego w radianach.
</para>
<para>
Zobacz te� <function>sin</function> i <function>tan</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.cosh">
<refnamediv>
<refname>cosh</refname>
<refpurpose>Cosinus hiperboliczny</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>cosh</function></funcdef>
<paramdef>float <parameter>arg</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca cosinus hiperboliczny z liczby <parameter>arg</parameter>,
definiowany jako <literal>(exp(arg) + exp(-arg))/2</literal>.
</para>
<para>
Zobacz te� <function>cos</function>, <function>acosh</function>,
<function>sin</function> and <function>tan</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.decbin">
<refnamediv>
<refname>decbin</refname>
<refpurpose>Konwertuje liczb� dziesi�tn� do dw�jkowej</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>decbin</function></funcdef>
<paramdef>int <parameter>liczba</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
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.
</para>
<para>
Zobacz te� <function>bindec</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.dechex">
<refnamediv>
<refname>dechex</refname>
<refpurpose>Konwersja liczby dziesi�tnej do szesnastkowej</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>dechex</function></funcdef>
<paramdef>int <parameter>liczba</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
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.
</para>
<para>
Zobacz te� <function>hexdec</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.decoct">
<refnamediv>
<refname>decoct</refname>
<refpurpose>Konwersja liczby dziesi�tnej do �semkowej</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>decoct</function></funcdef>
<paramdef>int <parameter>liczba</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
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.
</para>
<para>
Zobacz te� <function>octdec</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.deg2rad">
<refnamediv>
<refname>deg2rad</refname>
<refpurpose>
Przelicza stopnie na radiany
</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>deg2rad</function></funcdef>
<paramdef>float <parameter>liczba</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>deg2rad</function> przelicza stopnie podane w
<parameter>liczba</parameter> na radiany.
</para>
<para>
Zobacz te� <function>rad2deg</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.exp">
<refnamediv>
<refname>exp</refname>
<refpurpose>e do pot�gi ...</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>exp</function></funcdef>
<paramdef>float <parameter>argument</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca e podniesione do pot�gi <parameter>argument</parameter>.
</para>
<para>
Zobacz te� <function>pow</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.floor">
<refnamediv>
<refname>floor</refname>
<refpurpose>Zaokr�gla u�amki w d�</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>floor</function></funcdef>
<paramdef>float <parameter>liczba</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Zwraca najbli�sz� liczb� ca�kowit�, mniejsz� lub r�wn� podanemu arumentowi
<parameter>liczba</parameter>.
Zwracana przez funkcj� <function>floor</function> warto�� jest nadal typu
<type>float</type> gdy� zakres tego typu jest zwykle wi�kszy ni� zakres
typu <type>int</type>.
</simpara>
<simpara>
Zobacz te� <function>ceil</function> i
<function>round</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.getrandmax">
<refnamediv>
<refname>getrandmax</refname>
<refpurpose>Najwi�ksza mo�liwa liczba losowa</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>getrandmax</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<simpara>
Zwraca najwi�ksz� liczb�, jaka mo�e by� zwr�cona przez funkcj�
<function>rand</function>.
</simpara>
<simpara>
Zobacz te� <function>rand</function>, <function>srand</function>,
<function>mt_rand</function>, <function>mt_srand</function>, i
<function>mt_getrandmax</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.hexdec">
<refnamediv>
<refname>hexdec</refname>
<refpurpose>Konwersja liczby szesnastkowej do dziesi�tnej</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>hexdec</function></funcdef>
<paramdef>string <parameter>hex_string</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca dziesi�tny odpowiednik liczby szesnastkowej podanej w argumencie
<parameter>hex_string</parameter>. <function>hexdec</function>kownertuje
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.
</para>
<para>
<function>hexdec</function> zast�pi ka�dy znak, nie b�d�cy cyfr� w systemie
szesnastkowym liczb� <literal>0</literal>. W ten spos�b, wszystko zera
stoj�ce z lewej strony s� ignorowane, ale zera z prawej strony s� brane
pod uwag�.
<example>
<title>Przyk�ad zastosowania <function>hexdec</function></title>
<programlisting role="php">
<![CDATA[
var_dump(hexdec("See"));
var_dump(hexdec("ee"));
// obydwa zwracaj� "int(238)"
var_dump(hexdec("that"));
var_dump(hexdec("a0"));
// obydwa zwracaj� int(160)
]]>
</programlisting>
</example>
</para>
<para>
Zobacz te� <function>dechex</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.lcg-value">
<refnamediv>
<refname>lcg_value</refname>
<refpurpose>Z�o�ony przystaj�cy generator liniowy</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>lcg_value</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<para>
<function>lcg_value</function> 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.
</para>
</refsect1>
</refentry>
<refentry id="function.log">
<refnamediv>
<refname>log</refname>
<refpurpose>Logarytm naturalny</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>log</function></funcdef>
<paramdef>float <parameter>argument</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca logarytm naturalny z liczby <parameter>argument</parameter>.
</para>
</refsect1>
</refentry>
<refentry id="function.log10">
<refnamediv>
<refname>log10</refname>
<refpurpose>Logarytm dziesi�tny</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>log10</function></funcdef>
<paramdef>float <parameter>argument</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca logarytm dziesi�tny z <parameter>argument</parameter>.
</para>
</refsect1>
</refentry>
<refentry id="function.max">
<refnamediv>
<refname>max</refname>
<refpurpose>Znajduje najwi�ksz� liczb�</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>max</function></funcdef>
<paramdef>mixed <parameter>arg1</parameter></paramdef>
<paramdef>mixed <parameter>arg2</parameter></paramdef>
<paramdef>mixed <parameter>argn</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>max</function> zwraca najwi�ksz� liczb� spo�r�d podanych
argument�w.
</para>
<para>
Je�li pierwszy argument jest tablic�, <function>max</function> 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 <function>max</function> zwr�ci
najwi�ksz� warto��. Za pomoc� tej funkcji mo�esz por�wnywa� nieograniczon�
ilo�� liczb.
</para>
<para>
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.
</para>
</refsect1>
</refentry>
<refentry id="function.min">
<refnamediv>
<refname>min</refname>
<refpurpose>Znajduje najmniejsz� warto��</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>number <function>min</function></funcdef>
<paramdef>number <parameter>arg1</parameter></paramdef>
<paramdef>number <parameter>arg2</parameter></paramdef>
<paramdef><parameter><optional>...</optional></parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>number <function>min</function></funcdef>
<paramdef>array <parameter>liczby</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>min</function> zwraca najmniejsz� liczb� spo�r�d podanych
argument�w.
</para>
<para>
W pierwszym wariancie, po podaniu co najmniej dw�ch argument�w,
<function>min</function> zwr�ci najmniejszy z nich. Mo�na por�wnywa�
nieograniczon� ilo�� warto�ci.
</para>
<para>
W drugim wariancie, <function>min</function> zwr�ci najmniejsz� warto��
z tablicy <parameter>liczby</parameter>.
</para>
<para>
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 <type>float</type>, wszystkie
zostan� potraktowane jako <type>integer</type> i warto�� ca�kowita
zostanie zwr�cona.
</para>
</refsect1>
</refentry>
<refentry id="function.mt-rand">
<refnamediv>
<refname>mt_rand</refname>
<refpurpose>Wygeneruj lepsz� liczb� losow�</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>mt_rand</function></funcdef>
<void/>
</funcprototype>
<funcprototype>
<funcdef>int <function>mt_rand</function></funcdef>
<paramdef>int
<parameter>min</parameter>
</paramdef>
<paramdef>int
<parameter>max</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
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 <function>rand</function>. Funkcja
<function>mt_rand</function> 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
<ulink url="&url.mersenne;">&url.mersenne;</ulink>, a zoptymalizowan�
wersj� kodu �r�d�owego MT pod adresem
<ulink url="&url.mersenne.twister;">&url.mersenne.twister;</ulink>.
</simpara>
<simpara>
Je�li funkcja zostanie wywo�ana bez opcjonalnych argument�w
<parameter>min</parameter> i <parameter>max</parameter>, funkcja
<function>mt_rand</function> zwr�ci liczb� pseudolosow� z przedzia�u
pomi�dzy 0 a <constant>RAND_MAX</constant>. Je�li na przyk�ad
potrzebujesz liczby losowej z przedzia�u od 5 do 15 w��cznie, u�yj
<literal>mt_rand (5, 15)</literal>.
</simpara>
<simpara>
Pami�taj, aby przed u�yciem tej funkcji inicjalizowa� generator liczb
losowych za pomoc� <function>mt_srand</function>.
</simpara>
<note>
<para>
W wersjach przed 3.0.7 argument <parameter>max</parameter> znaczy�
<parameter>zakres</parameter>. Aby otrzyma� takie same wyniki w tych�e
wersjach, nale�y u�y� <literal>mt_rand (5, 11)</literal> aby otrzyma�
liczb� losow� z przedzia�u od 5 do 15.
</para>
</note>
<simpara>
Zobacz te� <function>mt_srand</function>,
<function>mt_getrandmax</function>, <function>srand</function>,
<function>rand</function> i <function>getrandmax</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.mt-srand">
<refnamediv>
<refname>mt_srand</refname>
<refpurpose>Inicjalizuj generator Mersenne Twister</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>mt_srand</function></funcdef>
<paramdef>int <parameter>ziarno</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Inicjalizuje generator liczb losowych za pomoc� ziarna
<parameter>ziarno</parameter>.
<informalexample>
<programlisting role="php">
<![CDATA[
// naziarnij mikrosekundami
function make_seed() {
list($usec,$sec) = explode(" ", microtime());
return ((float)$sec+(float)$usec) * 100000;
}
mt_srand(make_seed());
$randval = mt_rand();
]]>
</programlisting>
</informalexample>
</para>
<simpara>
Zobacz te� <function>mt_rand</function>,
<function>mt_getrandmax</function>, <function>srand</function>,
<function>rand</function>, i
<function>getrandmax</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.mt-getrandmax">
<refnamediv>
<refname>mt_getrandmax</refname>
<refpurpose>Najwi�ksza mo�liwa liczba losowa</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>mt_getrandmax</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<simpara>
Zwraca najwi�ksz� liczb� losow�, jak� mo�e zwr�ci� funkcja
<function>mt_rand</function>.
</simpara>
<simpara>
Zobacz te� <function>mt_rand</function>,
<function>mt_srand</function> <function>rand</function>,
<function>srand</function>, i
<function>getrandmax</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.number-format">
<refnamediv>
<refname>number_format</refname>
<refpurpose>Formatuje liczb� wed�ug szablonu</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>number_format</function></funcdef>
<paramdef>float <parameter>liczba</parameter></paramdef>
<paramdef>int <parameter><optional>miejsc_dziesi�tnych</optional>
</parameter></paramdef>
<paramdef>string <parameter><optional>przecinek_dziesi�tny</optional>
</parameter></paramdef>
<paramdef>string <parameter><optional>separator_tysi�cy</optional>
</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Funkcja <function>number_format</function> zwraca sformatowan� liczb�
<parameter>liczba</parameter> wed�ug podanych argument�w. Ta funkcja
przyjmuje jeden, dwa lub cztery argumenty (nie trzy):
</para>
<para>
Je�li podany jest tylko jeden argument, <parameter>liczba</parameter>
zostanie sformatowana bez miejsc dziesi�tnych ale z przecinkiem (",")
pomi�dzy ka�d� grup� tysi�cy.
</para>
<para>
Je�li podane s� dwa argumenty, <parameter>liczba</parameter> b�dzie
sformatowana z <parameter>miejsc_dziesi�tnych</parameter>, z kropk�
(".") w charakterze przecinka dziesi�tnego i przecinkiem (",")
pomi�dzy ka�d� grup� tysi�cy.
</para>
<para>
Kiedy wszystkie cztery parametry s� podane, <parameter>liczba</parameter>
liczba b�dzie sformatowana z <parameter>miejsc_dziesi�tnych</parameter>,
z <parameter>przecinek_dziesi�tny</parameter> zamiast kropki (".") i
<parameter>separator_tysi�cy</parameter> pomi�dzy ka�d� grup� tysi�cy.
</para>
<note>
<para>
Tylko pierwszy znak z <parameter>separator_tysi�cy</parameter> jest
wykorzystywany. Na przyk�ad, je�li u�yjesz <literal>foo</literal> jako
separatora, to z liczby <literal>1000</literal> funkcja zwr�ci
<literal>1f000</literal>.
</para>
</note>
<para>
<example>
<title><function>number_format</function> - przyk�ady</title>
<para>
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:
</para>
<programlisting role="php">
<![CDATA[
<?php
$liczba = 1234.56;
// notacja angielska (domy�lna)
$notacja_angielska = number_format($liczba);
// 1,234.56
// notacja polska
$notacja_polska = number_format($liczba, 2, ',', ' ');
// 1 234,56
$number = 1234.5678;
// notacja angielska bez separatora tysi�cy
$notacja_angielska = number_format($liczba, 2, '.', '');
// 1234.56
?>
]]>
</programlisting>
</example>
</para>
<note>
<para>
Zobacz te� <function>sprintf</function>,
<function>printf</function> i <function>sscanf</function>.
</para>
</note>
</refsect1>
</refentry>
<refentry id="function.octdec">
<refnamediv>
<refname>octdec</refname>
<refpurpose>Konwersja liczby �semkowej do dziesi�tnej</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>octdec</function></funcdef>
<paramdef>string <parameter>liczba_�semkowa</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca dziesi�tny odpowiednik liczby �semkowej podanej jako argument
<parameter>liczba_�semkowa</parameter>.
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.
</para>
<para>
Zobacz te� <function>decoct</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.pi">
<refnamediv>
<refname>pi</refname>
<refpurpose>Warto�� liczby Pi</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>pi</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<simpara>
Zwraca przybli�on� warto�� liczby pi.
</simpara>
<para>
<informalexample>
<programlisting>
<![CDATA[
echo pi();
// wy�wietli 3.1415926535898
]]>
</programlisting>
</informalexample>
</para>
</refsect1>
</refentry>
<refentry id="function.pow">
<refnamediv>
<refname>pow</refname>
<refpurpose>Pot�gowanie</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>number <function>pow</function></funcdef>
<paramdef>number <parameter>podstawa</parameter></paramdef>
<paramdef>number <parameter>wyk�adnik</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca argument <parameter>podstawa</parameter> podniesiony do pot�gi
<parameter>wyk�adnik</parameter>. Je�li mo�liwe, funkcja zwr�ci typ
<type>integer</type>.
</para>
<para>
Je�li nie da si� obliczy� pot�gi, zostanie wy�wietlone ostrze�enie
a funkcja <function>pow</function> zwr�ci &false;.
</para>
<example>
<title>Par� przyk�ad�w z <function>pow</function></title>
<programlisting role="php">
<![CDATA[
<?php
var_dump( pow(2,8) ); // int(256)
echo pow(-1,20); // 1
echo pow(0, 0); // 1
echo pow(-1, 5.5); // b��d
?>
]]>
</programlisting>
</example>
<warning>
<para>
W PHP 4.0.6 i wcze�niejszych funkcja <function>pow</function> zawsze
zwraca�a typ <type>float</type> i nie wy�wietla�a ostrze�e�.
</para>
</warning>
<para>
Zobacz te� <function>exp</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.rad2deg">
<refnamediv>
<refname>rad2deg</refname>
<refpurpose>
Przelicza radiany na stopnie.
</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>rad2deg</function></funcdef>
<paramdef>float <parameter>liczba</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>rad2deg</function> przelicza k�t <parameter>liczba</parameter>
podany w radianach na jego odpowiednik w stopniach.
</para>
<para>
Zobacz te� <function>deg2rad</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.rand">
<refnamediv>
<refname>rand</refname>
<refpurpose>Wygeneruj liczb� losow�</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>rand</function></funcdef>
<void/>
</funcprototype>
<funcprototype>
<funcdef>int <function>rand</function></funcdef>
<paramdef>int
<parameter>min</parameter>
</paramdef>
<paramdef>int
<parameter>max</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Je�li wywo�ana bez opcjonalnych argument�w <parameter>min</parameter> i
<parameter>max</parameter>, funkcja <function>rand</function> zwraca liczb�
pseudolosow� z przedzia�u pomi�dzy 0 a <constant>RAND_MAX</constant>.
Je�li potrzebujesz liczby losowej z przedzia�u np. od 5 do 15 (w��cznie),
u�yj <literal>rand (5,15)</literal>.
</simpara>
<simpara>
Pami�taj, aby przed u�yciem tej funkcji inicjalizowa� generator liczb
losowych za pomoc� <function>srand</function>.
</simpara>
<note>
<para>
W wersjach przed 3.0.7 argument <parameter>max</parameter> znaczy�
<parameter>zakres</parameter>. Aby otrzyma� takie same wyniki w tych�e
wersjach, nale�y u�y� <literal>rand (5, 11)</literal> aby otrzyma�
liczb� losow� z przedzia�u od 5 do 15.
</para>
</note>
<simpara>
Zobacz te� <function>srand</function>,
<function>getrandmax</function>, <function>mt_rand</function>,
<function>mt_srand</function> i
<function>mt_getrandmax</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.round">
<refnamediv>
<refname>round</refname>
<refpurpose>Zaokr�gla liczb� zmiennoprzecinkow�</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>round</function></funcdef>
<paramdef>float <parameter>warto��</parameter></paramdef>
<paramdef>int
<parameter><optional>dok�adno��</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca zaokr�glon� warto�� argumentu <parameter>warto��</parameter> do
miejsca po przecinku okre�lonego w <parameter>dok�adno��</parameter>.
<parameter>dok�adno��</parameter> mo�e by� tak�e ujemny lub r�wny zero
(domy�lnie).
</para>
<para>
<caution>
<simpara>
PHP domy�lnie nie obs�uguje poprawnie �a�cuch�w znak�w takich jak
<literal>"12,300.2"</literal>. Zobacz <link
linkend="language.types.string.conversion">konwersje z �a�cuch�w znak�w
</link>.
</simpara>
</caution>
</para>
<para>
<informalexample>
<programlisting role="php">
<![CDATA[
$foo = round(3.4); // $foo == 3.0
$foo = round(3.5); // $foo == 4.0
$foo = round(3.6); // $foo == 4.0
$foo = round(3.6, 0); // znaczy to samo, co zapis 1 wiersz wy�ej
$foo = round(1.95583, 2); // $foo == 1.96
$foo = round(1241757, -3); // $foo == 1242000
]]>
</programlisting>
</informalexample>
</para>
<note>
<simpara>
Argument <parameter>dok�adno��</parameter> jest dost�pny tylko w PHP 4.
</simpara>
</note>
<simpara>
Zobacz te� <function>ceil</function> i
<function>floor</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.sin">
<refnamediv>
<refname>sin</refname>
<refpurpose>Sinus</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>sin</function></funcdef>
<paramdef>float </paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca sinus k�ta <parameter>argument</parameter> podanego w radianach.
</para>
<para>
Zobacz te� <function>cos</function> i <function>tan</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.sinh">
<refnamediv>
<refname>sinh</refname>
<refpurpose>Sinus hiperboliczny</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>sinh</function></funcdef>
<paramdef>float <parameter>arg</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca sinus hiperboliczny z liczby <parameter>arg</parameter>,
definiowany jako <literal>(exp(arg) - exp(-arg))/2</literal>.
</para>
<para>
Zobacz te� <function>sin</function>, <function>asinh</function>,
<function>cos</function> and <function>tan</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.sqrt">
<refnamediv>
<refname>sqrt</refname>
<refpurpose>Pierwiastek kwadratowy</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>sqrt</function></funcdef>
<paramdef>float <parameter>argument</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca pierwiastek kwadratowy z <parameter>argument</parameter>.
</para>
</refsect1>
</refentry>
<refentry id="function.srand">
<refnamediv>
<refname>srand</refname>
<refpurpose>Inicjalizuje generator liczb losowych</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>srand</function></funcdef>
<paramdef>int <parameter>ziarno</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Inicjalizuje generator liczb losowych za pomoc� ziarna
<parameter>ziarno</parameter>.
<informalexample>
<programlisting role="php">
<![CDATA[
// naziarnij mikrosekundami
function make_seed() {
list($usec,$sec) = explode(" ", microtime());
return ((float)$sec+(float)$usec) * 100000;
}
srand(make_seed());
$randval = rand();
]]>
</programlisting>
</informalexample>
</para>
<simpara>
Zobacz te� <function>rand</function>,
<function>getrandmax</function>, <function>mt_rand</function>,
<function>mt_srand</function>, i
<function>mt_getrandmax</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.tan">
<refnamediv>
<refname>tan</refname>
<refpurpose>Tangens</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>tan</function></funcdef>
<paramdef>float <parameter>argument</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca tangens k�ta <parameter>argument</parameter> podanego w radianach.
</para>
<para>
Zobacz te� <function>sin</function> i <function>cos</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.tanh">
<refnamediv>
<refname>tanh</refname>
<refpurpose>Tangens hiperboliczny</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>tanh</function></funcdef>
<paramdef>float <parameter>arg</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zwraca tangens hiperboliczny z liczby <parameter>arg</parameter>,
definiowanej jako <literal>sinh(arg)/cosh(arg)</literal>.
</para>
<para>
Zobacz te� <function>tan</function>, <function>atanh</function>,
<function>sin</function> and <function>cos</function>.
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
