<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.math">
  <title>Mathematische Funktionen</title>
  <titleabbrev>Math.</titleabbrev>
 
  <partintro>
   <sect1 id="math.intro">
    <title>Einleitung</title>
    <para>
     Die mathematischen Funktionen behandeln nur Werte im Bereich der
     Datentypen long und double der jeweiligen Architektur.  Wenn Sie
     grere Zahlen oder Werte mit hherer Genauigkeit bentigen,
     sollten Sie sich die <link linkend="ref.bc">mathematische
     Funktionen mit beliebiger Genauigkeit</link> ansehen.
    </para>
    <sect2 id="math.constants">
     <title>Mathematische Konstanten</title>
     <para>
      Die folgenden Werte werden von diesem Packet definiert:
      <table>
       <title>Mathematische Konstanten</title>
       <tgroup cols="3">
	<thead>
	 <row>
	  <entry>Konstante</entry>
	  <entry>Wert</entry>
	  <entry>Beschreibung</entry>
	 </row>
	</thead>
	<tbody>
	 <row>
	  <entry>M_PI</entry>
	  <entry>3.14159265358979323846</entry>
	  <entry>Der Wert &para; (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_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_SQRT1_2</entry>	
	  <entry>0.70710678118654752440</entry>	
	  <entry>1/sqrt(2)</entry>
	 </row>
	</tbody>
       </tgroup>
      </table>
      Bis auf M_PI sind diese Konstanten erst ab PHP4.0 verfgbar.
     </para>
    </sect2>
   </sect1>
  </partintro>

  <refentry id="function.abs">
   <refnamediv>
    <refname>abs</refname>
    <refpurpose>Absolutwert</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>mixed</type><methodname>abs</methodname>
      <methodparam><type>mixed</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liefert den Absolutwert einer Zahl.  Ist
     <parameter>number</parameter> vom Typ float, so ist auch das
     Ergebnis vom Typ float, ansonsten ist es vom Typ int.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.acos">
   <refnamediv>
    <refname>acos</refname>
    <refpurpose>Arcuscosinus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>acos</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liefert den Arcuscosinus zum Wert <parameter>arg</parameter> im
     Bogenma.
    </para>
    <para>
     Siehe auch <function>asin</function>, <function>atan</function>
     und <function>cos</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.asin">
   <refnamediv>
    <refname>asin</refname>
    <refpurpose>Arcussinus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>asin</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liefert den Arcussinus zum Wert <parameter>arg</parameter> im
     Bogenma.
    </para>
    <para>
     Siehe auch <function>acos</function>, <function>atan</function>
     und <function>sin</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.atan">
   <refnamediv>
    <refname>atan</refname>
    <refpurpose>Arcustangens</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>atan</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liefert den Arcustangens zum Wert <parameter>arg</parameter> im
     Bogenma im Bereich (-&para;/2 ; &para;/2].  
    </para>
    <para>
     See also <function>asin</function>, <function>acos</function>,
     <function>atan2</function> und <function>tan</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.atan2">
   <refnamediv>
    <refname>atan2</refname>
    <refpurpose>Arcustangens aus zwei Werten</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>atan2</methodname>
      <methodparam><type>float</type><parameter>y</parameter></methodparam>
      <methodparam><type>float</type><parameter>x</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion berechnet den Arcustangens aus den Parametern
     <parameter>x</parameter> und <parameter>y</parameter> im Bereich
     (-&para;; &para;].  Dieser entspricht weitgehend dem Arcustangens
     aus x / y, allerdingskann hier das Vorzeichen beider Parameter
     ausgewertet und so der Quadrant des Ergebnises bestimmt werden.
    </para>
    <para>
     Siehe auch <function>atan</function>, <function>acos</function>,
     <function>asin</function>, und <function>tan</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.base-convert">
   <refnamediv>
    <refname>base_convert</refname>
    <refpurpose>Konvertiert Werte zwischen Zahlensystemen unterschiedlicher Basis</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>strin</type><methodname>base_convert</methodname>
      <methodparam><type>string</type><parameter>number</parameter></methodparam>
      <methodparam><type>int</type><parameter>frombase</parameter></methodparam>
      <methodparam><type>int</type><parameter>tobase</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert einen String, der
     <parameter>number</parameter> zur Basis
     <parameter>tobase</parameter> enthlt. Der Parameter
     <parameter>frombase</parameter> giebt die Basis des Eingabewertes
     <parameter>number</parameter> an. <parameter>tobase</parameter>
     und <parameter>tobase</parameter> knnen Werte von 2 bis
     einschlielich 36 enthalten. Fr die Darstellung von Werten mit
     einer Basis grer als 10 werden neben den Ziffern '0' bis '9'
     auch die Buchstaben von 'a' bis 'z' eingesetzt, wobei 'a' einem
     Wert von 10 entspricht, 'b' steht dementsprechend fr den Wert
     11, bis hin zum 'z', das den Wert 36 darstellt.
     <example>
      <title>base_convert()</title>
      <programlisting role="php">
$binary = base_convert($hexadecimal, 16, 2);
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.bindec">
   <refnamediv>
    <refname>BinDec</refname>
    <refpurpose>Binr zu dezimal Konvertierung</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>bindec</methodname>
      <methodparam><type>string</type><parameter>binary_string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liefert die dezimale Entsprechnung der in
     <parameter>binary_string</parameter> bergebenen binren
     Zahl. Der grte konvertierbare Wert ist ein String aus 31
     Einsen, das entspricht 2147483647 dezimal (2 hoch 32 minus 1).
    </para>
    <para>
     Siehe auch <function>decbin</function>,
     <function>octdec</function>, und <function>hexdec</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ceil">
   <refnamediv>
    <refname>ceil</refname>
    <refpurpose>Aufrunden</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ceil</methodname>
      <methodparam><type>float</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert diejenige ganze Zahl, die grer oder
     gleich dem Parameter <parameter>number</parameter> ist.  
    </para>
    <para>
     Siehe auch <function>floor</function> und <function>round</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.cos">
   <refnamediv>
    <refname>cos</refname>
    <refpurpose>Cosinus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>cos</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liefert den Cosinus des Winkels <parameter>arg</parameter>
     (<parameter>arg</parameter> in Bogenma).
    </para>
    <para>
     Siehe auch <function>sin</function>, <function>tan</function> und
     <function>acos</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.decbin">
   <refnamediv>
    <refname>DecBin</refname>
    <refpurpose>Dezimal zu binr Konvertierung</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>decbin</methodname>
      <methodparam><type>int</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert eine binre Representation von
     <parameter>number</parameter> als String zurck.  Der grte
     konvertierbare Wert fr <parameter>number</parameter> ist dezimal
     4294967295, dies entspricht (2 hoch 32)-1 und liefert einen String
     aus 32 Einsen.
    </para>
    <para>
     Siehe auch <function>bindec</function> sowie
     <function>dechex</function> und <function>decoct</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.dechex">
   <refnamediv>
    <refname>DecHex</refname>
    <refpurpose>Dezimal zu hexadezimal Konvertierung</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>dechex</methodname>
      <methodparam><type>int</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert eine hexadezimale Representation von
     <parameter>number</parameter> als String zurck.  Der grte
     konvertierbare Wert fr <parameter>number</parameter> ist dezimal
     2147483647, dies entspricht (2 hoch 32)-1 und liefet als Ergebnis
     den String "7fffffff" zurck.
    </para>
    <para>
     Siehe auch <function>hexdec</function> sowie
     <function>decbin</function> und <function>decoct</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.decoct">
   <refnamediv>
    <refname>DecOct</refname>
    <refpurpose>Dezimal zu oktal Konvertierung</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>decoct</methodname>
      <methodparam><type>int</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert eine oktale (zur Basis 8) Representation
     von <parameter>number</parameter> als String zurck.  Der grte
     konvertierbare Wert fr <parameter>number</parameter> ist dezimal
     2147483647, dies entspricht (2 hoch 32)-1 und liefet als Ergebnis
     den String "17777777777" zurck.
    </para>
    <para>
     Siehe auch <function>octdec</function> sowie
     <function>decbin</function> und <function>dechex</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.deg2rad">
   <refnamediv>
    <refname>deg2rad</refname>
    <refpurpose>Grad in Bogenma wandeln</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>double</type><methodname>deg2rad</methodname>
      <methodparam><type>double</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion wandelt den bergebenen Winkel von Grad in
     Bogenma.
    </para>
    <para>
     Siehe auch <function>rad2deg</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.exp">
   <refnamediv>
    <refname>exp</refname>
    <refpurpose>e hoch ...</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>exp</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liefert e potenziert mit <parameter>arg</parameter>.
    </para>
    <para>
     Siehe auch <function>pow</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.floor">
   <refnamediv>
    <refname>floor</refname>
    <refpurpose>Abrunden</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>floor</methodname>
      <methodparam><type>float</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert die ganze Zahl, die kleiner oder gleich
     dem Parameter <parameter>number</parameter> ist.
    </para>
    <para>
     Siehe auch <function>ceil</function> und <function>round</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.getrandmax">
   <refnamediv>
    <refname>getrandmax</refname>
    <refpurpose>Grtmglicher Zufallswert</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>getrandmax</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Diese Funktion liefert den hchsten Wert, den ein Aufruf der
     Funktion <function>rand</function> auf dieser Plattform
     zurckgeben kann.
    </para>
    <para>
     Siehe auch <function>rand</function>, <function>srand</function>
     <function>mt_rand</function>, <function>mt_srand</function> und
     <function>mt_getrandmax</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.hexdec">
   <refnamediv>
    <refname>HexDec</refname>
    <refpurpose>Hexadezimal zu dezimal Konvertierung</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>hexdec</methodname>
      <methodparam><type>string</type><parameter>hex_string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liefert die dezimale Entsprechnung der in
     <parameter>hex_string</parameter> bergebenen hexadezimalen
     Zahl. Der grte konvertierbare Wert ist "7fffffff", das
     entspricht 2147483647 dezimal (2 hoch 32 minus 1).
    </para>
    <para>
     Siehe auch <function>dechex</function> sowie
     <function>bindec</function> und <function>octdec</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.log">
   <refnamediv>
    <refname>log</refname>
    <refpurpose>Natrlicher Logarithmus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>log</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert den natrlichen Logarithmus (zur Basis e)
     des Parameters <parameter>arg</parameter>.
    </para>
    <para>
     Siehe auch <function>exp</function> und <function>log10</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.log10">
   <refnamediv>
    <refname>log10</refname>
    <refpurpose>Zehner-Logarithmus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>log10</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert den Logarithmus des Parameters
     <parameter>arg</parameter> zur Basis zehn.
    </para>
    <para>
     Siehe auch <function>log</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.max">
   <refnamediv>
    <refname>max</refname>
    <refpurpose>Maximalwert bestimmen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>mixed</type><methodname>max</methodname>
      <methodparam><type>mixed</type><parameter>arg1</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>arg2</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>argn</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>max</function> liefert den numerisch grten
     Eingabewert zurck.
    </para>
    <para>
     Ist der erste Parameter ein Array, so wird der grte Wert
     innerhalb dieses Array zurckgegeben. Anderenfalls men
     mindestens zwei Parameter bergeben werden, und
     <function>max</function> liefert den Wert des grten Parameters
     zurck. Die Anzahl der Eingabe-Paramter ist nur durch den
     verfgbaren Hauptspeicher begrenzt.
    </para>
    <para>
     Ist mindestens einer der Eigabewerte vom Typ double, so werden
     alle Werte als double behandelt und der Rckgabewert ist
     ebenfalls vom Typ double. Anderenfalls werden alle Eingabewerte
     als int behandelt und auch ein int zurckgegeben.
    </para>
    <para>
     Siehe auch <function>min</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.min">
   <refnamediv>
    <refname>min</refname>
    <refpurpose>Minimalwert bestimmen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>mixed</type><methodname>min</methodname>
      <methodparam><type>mixed</type><parameter>arg1</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>arg2</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>argn</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>min</function> liefert den numerisch kleinsten
     Eingabewert zurck.
    </para>
    <para>
     Ist der erste Parameter ein Array, so wird der kleinste Wert
     innerhalb dieses Array zurckgegeben. Anderenfalls men
     mindestens zwei Parameter bergeben werden, und
     <function>min</function> liefert den Wert des kleinsten
     Parameters zurck. Die Anzahl der Eingabe-Paramter ist nur durch
     den verfgbaren Hauptspeicher begrenzt.
    </para>
    <para>
     Ist mindestens einer der Eigabewerte vom Typ double, so werden
     alle Werte als double behandelt und der Rckgabewert ist
     ebenfalls vom Typ double. Anderenfalls werden alle Eingabewerte
     als int behandelt und auch ein int zurckgegeben.
    </para>
    <para>
     Siehe auch <function>max</function>. 
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.mt-rand">
   <refnamediv>
    <refname>mt_rand</refname>
    <refpurpose>Erzeugt 'bessere' Zufallszahlen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>mt_rand</methodname>
      <methodparam choice="opt"><type></type><parameter>int min</parameter></methodparam>
      <methodparam choice="opt"><type></type><parameter>int max</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die PHP <function>rand</function> Funktion benutzt den in der
     jeweiligen libc enthaltenen Zufallsgenerator. Gerade in lteren
     libc-Versionen ist dieser aber oft langsam und die Qualitt der
     erzeugten Pseudozufalls-Sequenzen ist unbefriedigend bis
     unbekannt.
    </para>
    <para>
     Die Funktion <function>mt_rand</function> bietet einen Drop-In
     Ersatz fr die von der libc bereitgestellten Funktionen.  Sie
     benutzt einen Zufallsgenerator mit bekannter Characteristik, den
     sogenannten "Mersenne Twister", der Pseudozufalls-Sequenzen
     generiert, die auch kryptografischen Ansprchen gengen sollten
     und viermal so schnell arbeitet wie der typische
     libc-Algorithmus.
    </para>
    <para>
     Weitere Informationen zum Mersenne Twister und zur opmimierten
     Implementation finden sich unter <ulink
     url="&url.mersenne;">&url.mersenne;</ulink> und <ulink
     url="&url.mersenne.twister;">&url.mersenne.twister;</ulink>.
    </para>
    <para>
     Ohne die optionalen Parameter <parameter>min</parameter> und
     <parameter>max</parameter> liefert <function>mt_rand</function>
     eine Pseudo-Zufallszahl zwischen 0 und einem plattformabhngigen
     Maximalwert, der mit <function>mt_getrandmax</function> ermittelt
     werden kann.
    </para>
    <para>
     Benutzen Sie unbedingt <function>mt_srand</function>, um vor dem
     ersten Aufruf von <function>mt_rand</function> einen neuen
     Startwert festzulegen, ansonsten erhalten Sie bei jedem
     Programmlauf dieselbe Sequenz von Werten.
    </para>
    <note>
     <para>
      In PHP-Versionen vor 3.0.7 hatte der zweite Parameter
      <parameter>max</parameter> nicht den Maximalwert sondern die
      Gre des Werteintervalls an, d.h. in diesen lteren Version mu
      statt <literal>mt_rand(min,max) mt_rand(min,max-min)</literal>
      benutzt werden, um dasselbe Ergebnis zu erhalten.
     </para>
    </note>
    <para>
     Siehe auch <function>mt_srand</function>,
     <function>mt_getrandmax</function>, <function>srand</function>,
     <function>rand</function> und <function>getrandmax</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.mt-srand">
   <refnamediv>
    <refname>mt_srand</refname>
    <refpurpose>seed the better random number generator</refpurpose>
   </refnamediv>
   <refsect1>
   <title>Beschreibung</title>
     <methodsynopsis>
      <type>void</type><methodname>mt_srand</methodname>
      <methodparam><type>int</type><parameter>seed</parameter></methodparam>
     </methodsynopsis>
    <para>
     Legt einen internen Startwert fr den Zufallsgenerator in
     <function>mt_rand</function> fest. Gleiche Startwerte fhren
     auch jeweils zu derselben Pseudo-Zufallssequenzen daher ist es
     blich, diese ber die aktuelle Uhrzeit festzulegen:
     <informalexample>
      <programlisting role="php">
// seed with microseconds since last "whole" second
mt_srand((double)microtime()*1000000);
$randval = mt_rand();
      </programlisting>
     </informalexample>
    </para>
    <para>
     Siehe auch <function>mt_rand</function>,
     <function>mt_getrandmax</function>, <function>srand</function>,
     <function>rand</function> und <function>getrandmax</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.mt-getrandmax">
   <refnamediv>
    <refname>mt_getrandmax</refname>
    <refpurpose>show largest possible random value</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>mt_getrandmax</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Diese Funktion liefert den hchsten Wert, den ein Aufruf der
     Funktion <function>mt_rand</function> auf dieser Plattform
     zurckgeben kann.
    </para>
    <para>
     Siehe auch <function>mt_rand</function>,
     <function>mt_srand</function> <function>rand</function>,
     <function>srand</function> and <function>getrandmax</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.number-format">
   <refnamediv>
    <refname>number_format</refname>
    <refpurpose>Formartiert eine Zahl mit Tausendergruppen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>number_format</methodname>
      <methodparam><type>float</type><parameter>number</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>decimals</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>dec_point</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>thousands_sep</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>number_format</function> erzeugt aus
     <parameter>number</parameter> einen formatierten String.  Die
     Funktion akzeptiert ein, zwei oder vier Parameter (nicht drei).
    </para>
    <para>
     Wird nur <parameter>number</parameter> bergeben, so wird diese
     Zahl ohne Nachkommastellen, aber mit durch Komma getrennten
     Tausendergruppen ausgegeben. ( 1234567 -> 1,234,567 )
    </para>
    <para>
     Der optionale Parameter <parameter>decimals</parameter> giebt die
     Anzahl der auszugebenden Nachkommastellen an, diese werden durch
     einen Punkt getrennt ausgegeben.
    </para>
    <para>
     Mit Hilfe der weiteren Parameter <parameter>dec_point</parameter>
     und <parameter>thousands_sep</parameter> knnen andere
     Trennzeichen fr Tausendergruppen und Nachkommastellen festgelegt
     werden. Diese beiden Parameter knnen nur zusammen angegeben
     werden.
    </para>
    <para>
     Im deutschen Sprachraum werden die Trennzeichen i.A. genau
     umgekehrt benutzt, d.h. Nachkommastellen werden durch ein Komma
     und Tausender durch einen Punkt getrennt.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.octdec">
   <refnamediv>
    <refname>OctDec</refname>
    <refpurpose>Oktal zu dezimal Konvertierung</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>octdec</methodname>
      <methodparam><type>string</type><parameter>octal_string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liefert die dezimale Entsprechnung der in
     <parameter>octal_string</parameter> bergebenen oktalen Zahl. Der
     grte konvertierbare Wert ist "17777777777", das entspricht
     2147483647 dezimal (2 hoch 32 minus 1).
    </para>
    <para>
     Siehe auch <function>decoct</function> sowie
     <function>bindec</function> und <function>hexdec</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pi">
   <refnamediv>
    <refname>pi</refname>
    <refpurpose>Wert von PI</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>double</type><methodname>pi</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Diese Funktionen liefert (im Rahmen der mglichen Genauigkeit)
     den Wert der Kreiszahl Pi. Die Konstante M_PI erfllt denselben
     Zweck allerdings wesentlich effektiver.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pow">
   <refnamediv>
    <refname>pow</refname>
    <refpurpose>Exponentialfunktion</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>pow</methodname>
      <methodparam><type>float</type><parameter>base</parameter></methodparam>
      <methodparam><type>float</type><parameter>exp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert <parameter>base</parameter> potenziert mit
     <parameter>exp</parameter>, also <parameter>base</parameter> hoch
     <parameter>exp</parameter>.
    </para>
    <para> 
     Siehe auch <function>exp</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.rad2deg">
   <refnamediv>
    <refname>rad2deg</refname>
    <refpurpose>Bogenma in Grad wandeln</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>double</type><methodname>rad2deg</methodname>
      <methodparam><type>double</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion wandelt den bergebenen Winkel von Bogenma in
     Grad.
    </para>
    <para>
     Siehe auch <function>deg2rad</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.rand">
   <refnamediv>
    <refname>rand</refname>
    <refpurpose>(Pseudo-) Zufallszahl generieren</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>rand</methodname>
      <methodparam choice="opt"><type></type><parameter>int min</parameter></methodparam>
      <methodparam choice="opt"><type></type><parameter>int max</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert eine Pseudo-Zufallszahl zwischen
     <parameter>min</parameter> und <parameter>max</parameter>
     (inclusive).  Ohne die optionalen Parameter
     <parameter>min</parameter> und <parameter>max</parameter> liefert
     <function>rand</function> eine Pseudo-Zufallszahl zwischen 0 und
     einem plattformabhngigen Maximalwert, der mit
     <function>getrandmax</function> ermittelt werden kann.
    </para>
    <para>
     Benutzen Sie unbedingt <function>srand</function>, um vor dem
     ersten Aufruf von <function>rand</function> einen neuen Startwert
     festzulegen, ansonsten erhalten Sie bei jedem Programmlauf
     dieselbe Sequenz von Werten.
    </para>
    <note>
     <para>
      In PHP-Versionen vor 3.0.7 hatte der zweite Parameter
      <parameter>max</parameter> nicht den Maximalwert sondern die
      Gre des Werteintervalls an, d.h. in diesen lteren Version mu
      statt <literal>rand (min, max) rand (min, max-min)</literal>
      benutzt werden, um dasselbe Ergebnis zu erhalten.
     </para>
    </note>
    <para>
     Siehe auch <function>srand</function>,
     <function>getrandmax</function>, <function>mt_rand</function>,
     <function>mt_srand</function> und
     <function>mt_getrandmax</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.round">
   <refnamediv>
    <refname>round</refname>
    <refpurpose>Runden eines Wertes</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>double</type><methodname>round</methodname>
      <methodparam><type>double</type><parameter>val</parameter></methodparam>
      <methodparam choice="opt"><type></type><parameter>int precision</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion rundet den Eingabewert <parameter>val</parameter>
     auf <parameter>precision</parameter> Stellen nach dem Komma
	 auf oder ab.
     <informalexample>
      <programlisting role="php">
$foo = round (3.4);   // $foo == 3.0
$foo = round (3.5);   // $foo == 4.0
$foo = round (3.6);   // $foo == 4.0

$foo = round (1.95583,2);   // $foo == 1.96
      </programlisting>
     </informalexample>
    </para>
		<note>
		 <simpara> 
			Der Parameter <parameter>precision</parameter> ist nur in PHP 4
			verfgbar.
		 </simpara>
		</note>
    <para>
     Siehe auch <function>ceil</function> und
     <function>floor</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.sin">
   <refnamediv>
    <refname>sin</refname>
    <refpurpose>Sinus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>sin</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liefert den Sinus des Eingabewertes <parameter>arg</parameter>.
     <parameter>arg</parameter> wird im Bogenma angegeben.
    </para>
    <para>
     Siehe auch <function>cos</function>, <function>tan</function> und
     <function>asin</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.sqrt">
   <refnamediv>
    <refname>sqrt</refname>
    <refpurpose>Quadratwurzel</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>sqrt</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert die Quadratwurzel des Wertes
     <parameter>arg</parameter>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.srand">
   <refnamediv>
    <refname>srand</refname>
    <refpurpose>Startwert fr den Zufallsgenerator festlegen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>void</type><methodname>srand</methodname>
      <methodparam><type>int</type><parameter>seed</parameter></methodparam>
     </methodsynopsis>
    <para>
     Legt einen internen Startwert fr den Zufallsgenerator in
     <function>rand</function> fest. Gleiche Startwerte fhren
     auch jeweils zu derselben Pseudo-Zufallssequenzen daher ist
     es blich, diese ber die aktuelle Uhrzeit festzulegen:
     <informalexample>
      <programlisting role="php">
// seed with microseconds since last "whole" second
srand ((double)microtime()*1000000);
$randval = rand();
      </programlisting>
     </informalexample>
    </para>
    <para>
     Siehe auch <function>rand</function>,
     <function>getrandmax</function>, <function>mt_rand</function>,
     <function>mt_srand</function> und
     <function>mt_getrandmax</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.tan">
   <refnamediv>
    <refname>tan</refname>
    <refpurpose>Tangens</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>tan</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liefert den Tangens des Wertes <parameter>arg</parameter>.
     <parameter>arg</parameter> wird dabei im Bogenma angegeben.
    </para>
    <para>
     Siehe auch <function>sin</function>, <function>cos</function>,
     <function>atan</function> und <function>atan2</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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->