cvs: phpdoc /de/functions info.xml

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>