cvs: phpdoc-de /language exceptions.xml oop5.xml

From: Date: Thu, 10 Jul 2008 19:09:35 +0000
Subject: cvs: phpdoc-de /language exceptions.xml oop5.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-2721@lists.php.net to get a copy of this message
sammywg Thu Jul 10 19:09:35 2008 UTC Modified files: /phpdoc-de/language exceptions.xml oop5.xml Log: sync to en switch encoding

http://cvs.php.net/viewvc.cgi/phpdoc-de/language/exceptions.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/language/exceptions.xml diff -u phpdoc-de/language/exceptions.xml:1.6 phpdoc-de/language/exceptions.xml:1.7 --- phpdoc-de/language/exceptions.xml:1.6 Wed Jun 18 00:07:11 2008 +++ phpdoc-de/language/exceptions.xml Thu Jul 10 19:09:35 2008 @@ -1,32 +1,39 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.5 Maintainer: nobody Status: ready --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: sammywg Status: ready --> + <chapter xml:id="language.exceptions" xmlns="http://docbook.org/ns/docbook"> <title>Ausnahmebehandlung</title> + <para> - PHP 5 hat eine Ausnahmebehandlung ähnlich der anderer Programmiersprachen. - Eine Ausnahme kann in PHP geworfen(<literal>throw</literal>) und abgefangen - (<literal>catch</literal>) werden. Code kann von einem <literal>try</literal>- - Block umschlossen werden, um das Fangen von möglichen Exceptions zu ermöglichen. - Jeder <literal>try</literal>-Block muss mindestens einen zugehörigen - <literal>catch</literal> Block besitzen. Mehrere <literal>catch</literal>-Blöcke - können verwendet werden, um verschiedene Klassen von Ausnahmen abzufangen. - Normale Programmausführung (wenn keine Ausnahme innerhalb des + PHP 5 hat ein Exceptionmodell ähnlich dem anderer Programmiersprachen. + Eine Exception kann in PHP geworfen(<literal>throw</literal>) und abgefangen + (<literal>catch</literal>) werden. + + Um das Fangen potentieller Exceptions + zu ermöglichen, sollte der jeweilige Code kann von einem + <literal>try</literal>-Block umschlossen werden. Jeder + <literal>try</literal>-Block muss mindestens einen zugehörigen + <literal>catch</literal> Block besitzen. Mehrere + <literal>catch</literal>-Blöcke können verwendet werden, um verschiedene + Klassen von Exceptions abzufangen. + + Die normale Programmausführung (wenn keine Exception innerhalb des <literal>try</literal>-Blockes geworfen wird oder kein zur Klasse der - Ausnahme passendes catch vorhanden ist) wird nach dem letzten in Folge - definierten catch-Block fortgesetzt. Ausnahmen können innerhalb eines + Exception passendes catch vorhanden ist) wird nach dem letzten in Folge + definierten catch-Block fortgesetzt. Exceptions können innerhalb eines <literal>catch</literal>-Blockes geworfen werden. </para> <para> - Wenn eine Ausnahme geworfen wird, wird der Programmcode hinter der Anweisung - nicht ausgeführt und PHP versucht den ersten passenden <literal>catch</literal>- - Block zu finden. Falls eine Ausnahme nicht abgefangen wird, wird ein - fataler Fehler mit einer "<literal>Uncaught Exception ...</literal>"-Nachricht - ausgegeben, wenn nicht eine Behandlung mittels - <function>set_exception_handler</function> definiert wurde. + Wenn eine Exception geworfen wird, wird der Programmcode hinter der + auslösenden Anweisung nicht ausgeführt, und PHP versucht, den ersten + passenden <literal>catch</literal>-Block zu finden. Falls eine Exception + nicht abgefangen wird, wird ein fataler Fehler mit einer "<literal>Uncaught + Exception ...</literal>"-Nachricht ausgegeben, wenn nicht eine Behandlung + mittels <function>set_exception_handler</function> definiert wurde. </para> <example> - <title>Eine Ausnahme werfen</title> + <title>Eine Exception werfen</title> <programlisting role="php"> <![CDATA[ <?php @@ -41,10 +48,10 @@ echo inverse(5) . "\n"; echo inverse(0) . "\n"; } catch (Exception $e) { - echo 'Ausnahme abgefangen: ', $e->getMessage(), "\n"; + echo 'Exception abgefangen: ', $e->getMessage(), "\n"; } -// Ausführung fortsetzen +// Ausführung fortsetzen echo 'Hallo Welt'; ?> ]]> @@ -53,91 +60,127 @@ <screen> <![CDATA[ 0.2 -Ausnahme abgefangen: Division durch Null -Hello World +Exception abgefangen: Division durch Null +Hallo Welt +]]> + </screen> + </example> + <example> + <title>Verschachtelte Exceptions</title> + <programlisting role="php"> +<![CDATA[ +<?php + +class MyException extends Exception { } + +class Test { + public function testing() { + try { + try { + throw new MyException('foo!'); + } catch (MyException $e) { + /* weiterwerfen der Exception */ + throw $e; + } + } catch (Exception $e) { + var_dump($e->getMessage()); + } + } +} + +$foo = new Test; +$foo->testing(); + +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +string(4) "foo!" ]]> </screen> </example> + <sect1 xml:id="language.exceptions.extending"> - <title>Ausnahmen erweitern</title> + <title>Exceptions erweitern</title> <para> - Eine benutzerdefinierte Ausnahmeklasse kann definiert werden, indem man - die eingebaute Ausnahmeklasse ableitet. Die unten angegebenen Member und - Eigenschaften zeigen, was innerhalb der von der eingebauten Klasse - Exception abgeleiteten Klasse verfügbar ist. + Eine benutzerdefinierte Exceptionklasse kann durch Ableitung von der + eingebauten Exceptionklasse erstellt werden. Die unten angegebenen Methoden + und Eigenschaften zeigen, was innerhalb der Kindklasse von der eingebauten + Exceptionklasse verfügbar ist. </para> <example> - <title>Die eingebaute Ausnahmeklasse</title> + <title>Die eingebaute Exceptionklasse</title> <programlisting role="php"> <![CDATA[ <?php class Exception { - protected $message = 'Unknown exception'; // Ausnahmemitteilung - protected $code = 0; // Benutzerdefinierter Code - protected $file; // Quelldateiname der Ausnahme - protected $line; // Quelldateizeile der Ausnahme + protected $message = 'Unknown exception'; // Exceptionmitteilung + protected $code = 0; // Benutzerdefinierte Fehlernummer + protected $file; // Quelldateiname der Exception + protected $line; // Quelldateizeile der Exception function __construct($message = null, $code = 0); - final function getMessage(); // Mitteilung der Ausnahme - final function getCode(); // Code der Ausnahme + final function getMessage(); // Mitteilung der Exception + final function getCode(); // Fehlercode der Exception final function getFile(); // Quelldateiname final function getLine(); // Quelldateizeile - final function getTrace(); // Array mit Ablaufverfolgung - final function getTraceAsString(); // Formatierter String mit - // Ablaufverfolgung - - /* Überschreibbar */ - function __toString(); // Formatierter String für - // Ausgabe + final function getTrace(); // Array zum Rückverfolgen + final function getTraceAsString(); // Formatierter String der + // Rückverfolgung + + /* Überschreibbar */ + function __toString(); // Formatierter String für + // Ausgabe } ?> ]]> </programlisting> </example> <para> - Wenn eine Klasse die eingebaute Klasse Exception erweitert und den <link - linkend="language.oop5.decon">Konstructor</link> neu definiert, wird es - dringend empfohlen, dass dieser <link + Wenn eine Klasse die eingebaute Exceptionklasse erweitert und den <link + linkend="language.oop5.decon">Konstruktor</link> neu definiert, ist es + dringend empfohlen, dass der Konstruktor der Klasse <link linkend="language.oop5.paamayim-nekudotayim">parent::__construct()</link> - aufruft, um sicherzustellen, dass alle verfügbaren Daten korrekt zugewiesen - wurden. Die magische Methode <link - linkend="language.oop5.magic">__toString()</link> kann überschrieben werden, - um eine maßgeschneiderte Ausgabe anzubieten, wenn das Objekt durch eine - Zeichenkette repräsentiert werden soll. + aufruft, um sicherzustellen, dass alle verfügbaren Daten korrekt zugewiesen + wurden. Die <link linkend="language.oop5.magic">__toString()</link>-Methode + kann überschrieben werden, um eine maßgeschneiderte Ausgabe anzubieten, + wenn das Objekt durch eine Zeichenkette repräsentiert werden soll. </para> <example> - <title>Die Ausnahmeklasse erweitern</title> + <title>Die Exceptionklasse erweitern</title> <programlisting role="php"> <![CDATA[ <?php /** - * Eine maßgeschneiderte Ausnahmeklasse definieren + * Eine maßgeschneiderte Exceptionklasse definieren */ class MyException extends Exception { - // Die Ausnahmemitteilung neu definieren, damit diese nicht optional ist + // Die Exceptionmitteilung neu definieren, damit diese nicht optional ist public function __construct($message, $code = 0) { // etwas Code - - // sicherstelen, dass alles korrekt zugewiesen wird + + // sicherstellen, dass alles korrekt zugewiesen wird parent::__construct($message, $code); } - // maßgeschneiderte Stringdarstellung des Objektes + // maßgeschneiderte Stringdarstellung des Objektes public function __toString() { return __CLASS__ . ": [{$this->code}]: {$this->message}\n"; } public function customFunction() { - echo "Eine eigene Funktion dieses Ausnahmetypen\n"; + echo "Eine eigene Funktion dieses Exceptiontyps\n"; } } /** - * Erzeuge eine Klasse, um die Ausnahme zu testen + * Erzeuge eine Klasse, um die Exception zu testen */ class TestException { @@ -151,8 +194,8 @@ switch ($avalue) { case self::THROW_CUSTOM: - // eigene Ausnahme verwfen - throw new MyException('1 ist ein ungültiger Parameter', 5); + // eigene Exception werfen + throw new MyException('1 ist ein ungültiger Parameter', 5); break; case self::THROW_DEFAULT: @@ -160,8 +203,8 @@ throw new Exception('2 ist kein zugelassener Parameter', 6); break; - default: - // Keine Ausnahme, das Objekt wird erzeugt + default: + // Keine Exception, das Objekt wird erzeugt $this->var = $avalue; break; } @@ -173,13 +216,13 @@ try { $o = new TestException(TestException::THROW_CUSTOM); } catch (MyException $e) { // Wird gefangen - echo "Meine Ausnahme gefangen\n", $e; + echo "Meine Exception gefangen\n", $e; $e->customFunction(); -} catch (Exception $e) { // Übersprungen - echo "Vorgegebene Ausnahme gefangen\n", $e; +} catch (Exception $e) { // Übersprungen + echo "Standardexception gefangen\n", $e; } -// Ausführung fortsetzen +// Ausführung fortsetzen var_dump($o); echo "\n\n"; @@ -187,14 +230,14 @@ // Beispiel 2 try { $o = new TestException(TestException::THROW_DEFAULT); -} catch (MyException $e) { // Dieser typ passt nicht - echo "Meine Ausnahme gefangen\n", $e; +} catch (MyException $e) { // Dieser Typ passt nicht + echo "Meine Exception gefangen\n", $e; $e->customFunction(); } catch (Exception $e) { // Wird gefangen - echo "Vorgegebene Ausnahme gefangen\n", $e; + echo "Standardexception gefangen\n", $e; } -// Ausführung fortsetzen +// Ausführung fortsetzen var_dump($o); echo "\n\n"; @@ -203,10 +246,10 @@ try { $o = new TestException(TestException::THROW_CUSTOM); } catch (Exception $e) { // Wird gefangen - echo "Vorgegebene Ausnahme gefangen\n", $e; + echo "Standardexception gefangen\n", $e; } -// Ausführung fortsetzen +// Ausführung fortsetzen var_dump($o); echo "\n\n"; @@ -214,11 +257,11 @@ // Beispiel 4 try { $o = new TestException(); -} catch (Exception $e) { // Übersprungen, wird nicht ausgeführt - echo "Default Exception caught\n", $e; +} catch (Exception $e) { // Übersprungen, keine Exception ausgelöst + echo "Standardexception gefangen\n", $e; } -// Ausführung fortsetzen +// Ausführung fortsetzen var_dump($o); echo "\n\n"; ?> @@ -228,7 +271,7 @@ </sect1> </chapter> - + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc-de/language/oop5.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/language/oop5.xml diff -u phpdoc-de/language/oop5.xml:1.5 phpdoc-de/language/oop5.xml:1.6 --- phpdoc-de/language/oop5.xml:1.5 Wed Jun 18 00:07:12 2008 +++ phpdoc-de/language/oop5.xml Thu Jul 10 19:09:35 2008 @@ -1,16 +1,16 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.14 Maintainer: nobody Status: ready --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.15 Maintainer: sammywg Status: ready --> + <chapter xml:id="language.oop5" xmlns="http://docbook.org/ns/docbook"> <title>Klassen und Objekte (PHP 5)</title> <sect1 xml:id="op5.intro"> - <title>Einführung</title> + <title>Introduction</title> <para> - In PHP5 gibt es ein neues Objektmodell. - Die Behandlung von Objekten durch PHP5 wurde einer kompletten - Neuentwicklung unterzogen, was eine höhere Leistungsfähigkeit - und mehr Features erlaubt. + In PHP5 gibt es ein neues Objektmodell. Die Behandlung von Objekten durch + PHP wurde vollständig neu geschrieben, was zu deutlich erhöhter + Leistungsfähigkeit und mehr Fähigkeiten in diesem Bereich führte. </para> &tip.userlandnaming; </sect1> @@ -34,8 +34,9 @@ &language.oop5.reflection; &language.oop5.typehinting; &language.oop5.late-static-bindings; + &language.oop5.references; </chapter> - + <!-- Keep this comment at the end of the file Local variables: mode: sgml
« previous php.doc.de (#2721) next »