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>