georg Sun Nov 25 04:50:49 2001 EDT
Modified files:
/phpdoc/de/functions info.xml
Log:
Inserted translation for assert() and assert_options()
Index: phpdoc/de/functions/info.xml
diff -u phpdoc/de/functions/info.xml:1.21 phpdoc/de/functions/info.xml:1.22
--- phpdoc/de/functions/info.xml:1.21 Sat Nov 24 15:42:06 2001
+++ phpdoc/de/functions/info.xml Sun Nov 25 04:50:49 2001
@@ -2,6 +2,167 @@
<reference id="ref.info">
<title>PHP Optionen und Informationen</title>
<titleabbrev>PHP Optionen/Informationen</titleabbrev>
+<refentry id="function.assert">
+ <refnamediv>
+ <refname>assert</refname>
+ <refpurpose>Pr�ft ab, ob eine Bedingung oder Abfrage &false; ist</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>assert</function></funcdef>
+ <paramdef>string|bool <parameter>assertion</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>assert</function> �berpr�ft den �bergebenen Parameter
+ <parameter>assertion</parameter> und f�hrt ein �ber die Funktion
+ <function>assert_options</function> definiertes Ereignis aus, falls
+ die in <parameter>assertion</parameter> Bedingung &false; ist.
+ </para>
+ <para>
+ Wird der Parameter <parameter>assertion</parameter> als String �bergeben,
+ so wird der String als PHP-Code interpretiert.
+ Der Vorteil der �bergabe des Parameters <parameter>assertion</parameter>
+ als Zeichenkette liegt darin, dass die ausgegebene Meldung
+ die �ber <parameter>assertion</parameter> �bergebene Zeichenkette
+ enth�lt.
+ </para>
+ <para>
+ <function>assert</function> sollte nur zum Debuggen des Codes
+ und nicht in Produktionsumgebungen verwendet werden werden,
+ beispielsweise zur �berpr�fung von Eingaben.
+ </para>
+ <para>
+ Die Optionen f�r die <function>assert</function> k�nnen �ber die
+ Funktion <function>assert_options</function> oder in den Einstellungen
+ der .ini-Datei gesetzt werden.
+ </para>
+ <para>
+ Die Funktion <function>assert_options</function> mit der
+ ASSERT_CALLBACK Direktive erm�glicht eine Funktion anzugeben, die bei
+ fehlender �berpr�fung aufgerufen wird.
+ </para>
+ <para>
+ Callback-Funktionen in Zusammenhang mit <function>assert</function> sind
+ n�tzlich, um beispielsweise automatisierte Tests durchzuf�hren, da die
+ Callback-Funktion pber die Information verf�gt, von welcher Stelle sie
+ aufgerufen wurde.
+ </para>
+ <para>
+ Die Callback-Funktion wird mit drei Parametern aufgerufen. Der erste
+ Der erste Parameter enth�lt den Namen des Scripts, in dem die �berpr�fung
+ statt fand, der zweite Parameter die Zeilennummer, und der dritte Paramter
+ enth�lt die �ber <parameter>assertion</parameter> angegebene Bedingung.
+ </para>
+ <para>
+ <example>
+ <title>�berpr�fung mit benutzerdefinierter Funktion</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// Active assert and make it quiet
+assert_options (ASSERT_ACTIVE, 1);
+assert_options (ASSERT_WARNING, 0);
+assert_options (ASSERT_QUIET_EVAL, 1);
+
+// Create a handler function
+function my_assert_handler ($file, $line, $code) {
+ echo "<hr>Assertion Failed:
+ File '$file'<br>
+ Line '$line'<br>
+ Code '$code'<br><hr>";
+}
+
+// Set up the callback
+assert_options (ASSERT_CALLBACK, 'my_assert_handler');
+
+// Make an assertion that should fail
+assert ('mysql_query ("")');
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.assert-options">
+ <refnamediv>
+ <refname>assert_options</refname>
+ <refpurpose>Setzt oder liefert die Assert-Optionen</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>assert_options</function></funcdef>
+ <paramdef>int <parameter>what</parameter></paramdef>
+ <paramdef>mixed
+ <parameter><optional>value</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>assert_options</function> erm�glicht es, die verschiedenene
+ <function>assert</function> Optionen zu setzen, oder abzufragen, welche
+ Optionen gesetzt sind.
+ </para>
+ <table>
+ <title>assert Optionen</title>
+ <tgroup cols="4">
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Parameter in .ini-Datei</entry>
+ <entry>Standardwert</entry>
+ <entry>Beschreibung</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>ASSERT_ACTIVE</entry>
+ <entry>assert.active</entry>
+ <entry>1</entry>
+ <entry><function>assert</function> �berpr�fung aktivieren</entry>
+ </row>
+ <row>
+ <entry>ASSERT_WARNING</entry>
+ <entry>assert.warning</entry>
+ <entry>1</entry>
+ <entry>gibt eine PHP Warnung f�r jede fehlgeschlagene �berpr�fung an</entry>
+ </row>
+ <row>
+ <entry>ASSERT_BAIL</entry>
+ <entry>assert.bail</entry>
+ <entry>0</entry>
+ <entry>Beendet das Programm bei fehlgeschlagener �berpr�fung</entry>
+ </row>
+ <row>
+ <entry>ASSERT_QUIET_EVAL</entry>
+ <entry>assert.quiet_eval</entry>
+ <entry>0</entry>
+ <entry>
+ Unterdr�ckt die Fehlerausgabe w�hrend der �berpr�fung
+ </entry>
+ </row>
+ <row>
+ <entry>ASSERT_CALLBACK</entry>
+ <entry>assert_callback</entry>
+ <entry>(&null;)</entry>
+ <entry>erm�glicht die Angabe einer benuterdefinierten Funktion</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para>
+ <function>assert_options</function> gibt die Einstellung der gesetzten
+ Optionen zur�ck oder liefert den Wert &false; bei Auftreten eines Fehlers
+ zur�ck.
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.extension-loaded">
<refnamediv>