betz Wed May 29 11:47:51 2002 EDT
Modified files:
/phpdoc-de/language constants.xml
Log:
sync to en
Index: phpdoc-de/language/constants.xml
diff -u phpdoc-de/language/constants.xml:1.5 phpdoc-de/language/constants.xml:1.6
--- phpdoc-de/language/constants.xml:1.5 Wed Dec 12 15:46:21 2001
+++ phpdoc-de/language/constants.xml Wed May 29 11:47:50 2002
@@ -1,132 +1,260 @@
<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.25 Maintainer: betz Status: ready -->
+<!-- CREDITS: tzwenny -->
+
<chapter id="language.constants">
<title>Konstanten</title>
+ <simpara>
+ Eine Konstante ist ein Bezeichner (Name) f�r eine simple Variable.
+ Wie der Name schon ausdr�ckt, kann sich der Wert einer Konstanten
+ zur Laufzeit eines Skripts nicht �ndern. (Die 'Magischen Konstanten'
+ <constant>__FILE__</constant> und <constant>__LINE__</constant> scheinen
+ eine Ausnahme von dieser Regel zu sein, aber in Wahrheit sind dies
+ keine Konstanten). Eine Konstante unterscheidet zwischen Gro�- und
+ KLeinschreinbung (case-sensitive). Nach g�ngiger Konvention werden
+ Konstanten immer in Gro�buchstaben geschrieben.
+ </simpara>
+ <para>
+ Der Name einer Konstanten folgt den gleichen Regeln wie alle anderen
+ Bezeichner in PHP. Ein g�ltiger Name beginnt mit einem Buchstaben
+ oder einem Unterstrich, gefolgt von beliebig vielen Buchstaben, Nummern
+ oder Understrichen. Als regul�rer Ausdruck geschrieben:
+ <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal>
+ </para>
+ <note>
+ <simpara>
+ F�r unsere Zwecke ist ein Buchstabe a-z, A-Z und die ASCII-Zeichen
+ von 127 bis 255 (0x7f-0xff).
+ </simpara>
+ </note>
+
+ <simpara>
+ Der G�ltigkeitsbereich einer Konstanten ist global -- Sie k�nnen unabh�ngig
+ vom G�ltigkeitsbereich �berall auf eine Konstante zugreifen.
+ </simpara>
+
+ <sect1 id="language.constants.syntax">
+ <title>Syntax</title>
+ <simpara>
+ Eine Konstante k�nnen Sie �ber die Funktion <function>define</function>
+ definieren. Einmal definiert, kann eine Konstane weder ver�ndert
+ noch gel�scht werden.
+ </simpara>
+ <simpara>
+ Konstanten k�nnen nur scalare Daten (<type>boolean</type>,
+ <type>integer</type>, <type>float</type> und <type>string</type>)
+ enthalten.
+ </simpara>
+ <simpara>
+ Den Wert einer Konstanten erhalten Sie ganz einfach durch die Angabe ihres
+ Namens. Einer Konstanten sollten Sie <emphasis>nicht</emphasis>,wie bei
+ Variablen, ein $ voranstellen. Ebenso k�nnen Sie die Funktion
+ <function>constant</function> benutzen um den Wert einer Konstanten
+ auszulesen, wenn Sie den Namen der Konstanten dynamisch erhalten wollen.
+ Benutzen Sie <function>get_defined_constants</function> um eine Liste
+ aller definierten Konstanten zu erhalten.
+ </simpara>
+ <note>
+ <simpara>
+ Konstanten und (globale) Variablen befinden sich in unterschiedlichen
+ Namensr�umen. Das hat zum Beispiel zur Folge, dass &true; und
+ <varname>$TRUE</varname> grunds�tzlich unterschiedlich sind.
+ </simpara>
+ </note>
+
+ <simpara>
+ Falls Sie eine undefinierte Konstante verwenden, nimmt PHP an, dass
+ Sie den Namen der Konstanten selber meinen.
+ Wenn das passiert wird eine <link linkend="features.error-handling">Notice</link>
+ ausgegeben. Benutzen Sie die Funktion <function>defined</function> um
+ herauszufinden, ob eine Konstante definiert ist.
+ </simpara>
+ <para>
+ Das hier sind die Unterschiede zwischen Konstanten und Variablen:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ Konstanten haben kein Dollarzeichen (<literal>$</literal>)
+ vorangestellt;
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Konstanten k�nnen nur �ber die Funktion <function>define</function>
+ definiert werden, nicht durch einfache Zuweisung;
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Konstanten k�nnen �berall definiert werden und auf Ihren Wert
+ k�nnen Sie ohne R�cksicht auf Namensraumregeln von Variablen zugreifen;
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Sobald Konstanten definiert sind, k�nnen sie nicht neu definiert
+ oder gel�scht werden; und
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Konstanten k�nnen nur skalare Werte haben.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ <example>
+ <title>Definiton von Konstanten</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+define("CONSTANT", "Hallo Welt.");
+echo CONSTANT; // Ausgabe: "Hallo Welt."
+echo Constant; // Ausgabe: "Constant" und eine Notice.
+?>
+]]>
+ </programlisting>
+ </example>
+
+ </para>
+ </sect1>
+
+ <sect1 id="language.constants.predefined">
+ <title>Vordefinierte Konstanten</title>
<simpara>
- PHP definiert eine Reihe von Konstanten und stellt einen Mechanismus
- zur Verf�gung, mit dem man zus�tzliche Konstanten zur Laufzeit definieren
- kann. Konstanten sind Variablen sehr �hnlich, bis auf die Tatsache, dass
- sie mit der <function>define</function>-Funktion definiert werden
- m�ssen und sp�ter nicht mehr mit einem anderen Wert versehen werden
- k�nnen.</simpara>
-
- <para>
- Folgende vordefinierten Variablen sind immer verf�gbar:
-
- <variablelist>
-
- <varlistentry>
- <term>__FILE__</term>
- <listitem>
- <simpara>
- Der Name der Skript-Datei, die gerade geparsed wird. Wird
- diese Konstante in einer Datei verwendet, die per
- <function>include</function> oder <function>require</function>
- eingebunden wurde, liefert sie den Namen der eingebundenen
- Datei, nicht den der aufrufenden Datei.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>__LINE__</term>
- <listitem>
- <simpara>
- Die Nummer der Zeile im laufenden Skript, die gerade geparst
- wird. Wird diese Konstante in einer Datei benutzt, die per
- <function>include</function> oder <function>require</function>
- eingebunden wurde, liefert sie die Zeilennummer innerhalb der
- eingebundenen Datei.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>PHP_VERSION</term>
- <listitem>
- <simpara>
- Ein String, der die Versionsnummer des PHP-Parsers
- enth�lt, der gerade verwendet wird; z. B.�3.0.8-dev�.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>PHP_OS</term>
- <listitem>
- <simpara>
- Der Name des Betriebsystems, auf dem der PHP-Parser
- ausgef�hrt wird; z. B. �Linux�.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>&true;</term>
- <listitem>
- <simpara>
- Der Wert �wahr�.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>&false;</term>
- <listitem>
- <simpara>
- Der Wert �falsch�.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>E_ERROR</term>
- <listitem>
- <simpara>
- Bedeutet einen Fehler, der sich von einem
- �parsing error� unterscheidet. Die Ausf�hrung des Skriptes
+ PHP stellt jedem Skript eine Reihe von vordefinierten Konstanten zur Verf�gung.
+ Viele dieser Konstanten werden jedoch von verschiedenen Erweiterungen definiert,
+ die nur zur Verf�gung stehen, wenn diese Erweiterungen selbst zur Verf�gung
+stehen,
+ entweder �ber dynamisches Laden zur Laufzeit oder sie sind einkompiliert.
+ </simpara>
+
+ <simpara>
+ Eine Liste vordefinierter Konstanten finden Sie im Abschnitt
+ <link linkend="reserved.constants">Vordefinierte Konstanten</link>.
+ </simpara>
+ </sect1>
+ </chapter>
+
+<!-- Alter Inhalt
+ <para>
+ Folgende vordefinierten Variablen sind immer verf�gbar:
+
+ <variablelist>
+
+ <varlistentry>
+ <term>__FILE__</term>
+ <listitem>
+ <simpara>
+ Der Name der Skript-Datei, die gerade geparsed wird. Wird
+ diese Konstante in einer Datei verwendet, die per
+ <function>include</function> oder <function>require</function>
+ eingebunden wurde, liefert sie den Namen der eingebundenen
+ Datei, nicht den der aufrufenden Datei.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>__LINE__</term>
+ <listitem>
+ <simpara>
+ Die Nummer der Zeile im laufenden Skript, die gerade geparst
+ wird. Wird diese Konstante in einer Datei benutzt, die per
+ <function>include</function> oder <function>require</function>
+ eingebunden wurde, liefert sie die Zeilennummer innerhalb der
+ eingebundenen Datei.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>PHP_VERSION</term>
+ <listitem>
+ <simpara>
+ Ein String, der die Versionsnummer des PHP-Parsers
+ enth�lt, der gerade verwendet wird; z. B.�3.0.8-dev�.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>PHP_OS</term>
+ <listitem>
+ <simpara>
+ Der Name des Betriebsystems, auf dem der PHP-Parser
+ ausgef�hrt wird; z. B. �Linux�.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>&true;</term>
+ <listitem>
+ <simpara>
+ Der Wert �wahr�.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>&false;</term>
+ <listitem>
+ <simpara>
+ Der Wert �falsch�.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>E_ERROR</term>
+ <listitem>
+ <simpara>
+ Bedeutet einen Fehler, der sich von einem
+ �parsing error� unterscheidet. Die Ausf�hrung des Skriptes
wird beendet.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>E_WARNING</term>
- <listitem>
- <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>E_WARNING</term>
+ <listitem>
+ <simpara>
Gibt einen Zustand zur�ck,durch den PHP wei�, dass etwas
nicht in Ordnung ist, das aktuelle Skript aber trotzdem
weiter ausf�hrt; dies kann vom Skript selbst aufgefangen
werden.
Ein Beispiel w�re ein ung�ltiger regul�rer Ausdruck (regexp)
in der Funktion <function>ereg</function>.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>E_PARSE</term>
- <listitem>
- <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>E_PARSE</term>
+ <listitem>
+ <simpara>
Der Parser hat Probleme mit ung�ltiger Syntax in
der Skript-Datei. Die Ausf�hrung des Skriptes wird
beendet.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>E_NOTICE</term>
- <listitem>
- <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>E_NOTICE</term>
+ <listitem>
+ <simpara>
Etwas ist aufgetreten, das ein Fehler sein kann oder nicht.
Das aktuelle Skript wird weiter ausgef�hrt. Beispiele hierf�r
sind ein nicht gequoteter string als Hash-Index oder der
Zugriff auf eine Variable, die nicht gesetzt wurde.
- </simpara>
- </listitem>
- </varlistentry>
- </variablelist></para>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist></para>
<para>
Die E_*-Konstanten werden typischerweise mit der
@@ -136,7 +264,7 @@
<para>
Zus�tzliche Konstanten k�nnen mithilfe der
<function>define</function>-Funktion definiert werden.</para>
-
+
<para>
Zu beachten ist, dass dies Konstanten sind, und keine Makros, wie man
sie von C her kennt; nur g�ltige Skalar-Daten k�nnen von einer
@@ -163,23 +291,31 @@
?>
</programlisting>
</example></para>
-
+
</chapter>
-
- <!-- 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
+
+ENDE alter Inhalt
+-->
+
+<!-- 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:
- -->
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+
+
