svn: /phpdoc/de/trunk/reference/ dbx/functions/dbx-query.xml dio/functions/dio-seek.xml exec/functions/escapeshellarg.xml exif/functions/exif-read-data.xml exif/functions/exif-tagname.xml expect/setup.xml filter/functions/filter-var-array.xml funchand/functions/func-get-args.xml funchand/functions/func-num-args.xml ibase/functions/ibase-fetch-object.xml
[email protected] (Christoph Michael Becker)
| Newsgroups | php.doc.de |
|---|---|
| Message-ID | <[email protected]> |
cmb Sun, 08 Apr 2018 12:36:51 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=344634
Log:
Sync with EN
Changed paths:
U phpdoc/de/trunk/reference/dbx/functions/dbx-query.xml
U phpdoc/de/trunk/reference/dio/functions/dio-seek.xml
U phpdoc/de/trunk/reference/exec/functions/escapeshellarg.xml
U phpdoc/de/trunk/reference/exif/functions/exif-read-data.xml
U phpdoc/de/trunk/reference/exif/functions/exif-tagname.xml
U phpdoc/de/trunk/reference/expect/setup.xml
U phpdoc/de/trunk/reference/filter/functions/filter-var-array.xml
U phpdoc/de/trunk/reference/funchand/functions/func-get-args.xml
U phpdoc/de/trunk/reference/funchand/functions/func-num-args.xml
U phpdoc/de/trunk/reference/ibase/functions/ibase-fetch-object.xml
svn-diffs-344634.txt
(text/x-diff, 65.1 KB)
Modified: phpdoc/de/trunk/reference/dbx/functions/dbx-query.xml
===================================================================
--- phpdoc/de/trunk/reference/dbx/functions/dbx-query.xml 2018-04-08 09:52:02 UTC (rev 344633)
+++ phpdoc/de/trunk/reference/dbx/functions/dbx-query.xml 2018-04-08 12:36:51 UTC (rev 344634)
@@ -1,295 +1,431 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: sammywg Status: working -->
- <refentry xml:id="function.dbx-query" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>dbx_query</refname>
- <refpurpose>
- Sendet eine Abfrage und holt alle Ergebnisse (falls vorhanden)
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <methodsynopsis>
- <type>object</type><methodname>dbx_query</methodname>
- <methodparam><type>object</type><parameter>link_identifier</parameter></methodparam>
- <methodparam><type>string</type><parameter>sql_statement</parameter></methodparam>
- <methodparam choice="opt"><type>long</type><parameter>flags</parameter></methodparam>
- </methodsynopsis>
- <simpara>
- <function>dbx_query</function> gibt bei Erfolg ein Objekt oder
- <literal>1</literal> zurück, oder <literal>0</literal> im
- Fehlerfall. Das Objekt wird nur zurückgegeben, wenn die in
- <parameter>sql_statement</parameter> angegebene Abfrage eine
- Ergebnisliste liefert.
- </simpara>
- <example>
- <title>Wie mit dem gelieferten Wert umgegangen wird</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-$link = dbx_connect(DBX_ODBC, "", "db", "username", "password")
- or die("Fehler beim Verbinden");
+<!-- EN-Revision: 297028 Maintainer: nobody Status: ready -->
-$result = dbx_query($link, 'SELECT id, parentid, description FROM table');
+<refentry xml:id="function.dbx-query" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>dbx_query</refname>
+ <refpurpose>
+ Sendet eine Abfrage und holt alle Ergebnisse (falls vorhanden)
+ </refpurpose>
+ </refnamediv>
-if ( is_object($result) ) {
- // ... tue hier irgendetwas, detaillierte Beispiele siehe unten ...
- // erst die Ausgabe der Feldnamen und Typen
- // dann die Ausgabe einer Tabelle mit den gelieferten Werten
-}
-else if ( $result == 1 ) {
- echo("Abfrage wurde erfolgreich ausgeführt, jedoch keine Ergebnisse");
-}
-else {
- exit("Fehler bei Abfrage");
-}
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>mixed</type><methodname>dbx_query</methodname>
+ <methodparam><type>object</type><parameter>link_identifier</parameter></methodparam>
+ <methodparam><type>string</type><parameter>sql_statement</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Sendet eine Abfrage und holt alle Ergebnisse.
+ </para>
+ </refsect1>
-dbx_close($link);
-?>
-]]>
- </programlisting>
- </example>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>link_identifier</parameter></term>
+ <listitem>
+ <para>
+ The DBX link object returned by <function>dbx_connect</function>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>sql_statement</parameter></term>
+ <listitem>
+ <para>
+ SQL statement.
+ </para>
+ <para>
+ Data inside the query should be <link
+ linkend="function.dbx-escape-string">properly escaped</link>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>flags</parameter></term>
+ <listitem>
+ <para>
+ Der Parameter <parameter>flags</parameter> wird verwendet, um die Menge
+ der zu liefernden Informationen zu steuern. Die folgenden Konstanten
+ können mit dem Bit-Operator (|) beliebig kombiniert werden. Die Flags
+ DBX_COLNAMES_* heben die Einstellungen dbx.colnames_case in der
+ &php.ini; auf.
+ <variablelist>
+ <varlistentry>
+ <term>
+ <constant>DBX_RESULT_INDEX</constant>
+ </term>
+ <listitem>
+ <simpara>
+ Dieses Flag ist <emphasis>immer</emphasis> gesetzt, d.h. das
+ zurückgegebene Objekt hat eine Eigenschaft <property>data</property>,
+ welche aus einem zweidimensionalen, numerisch indizierten Array
+ besteht. Zum Beispiel steht in <literal>data[2][3]</literal> die
+ <literal>2</literal> für die Reihen- (bzw. Datensatz-) Nummer, und
+ <literal>3</literal> steht für die Spalten- (bzw. Feld- Nummer).
+ Die erste Reihe und Spalte haben den Index 0.
+ </simpara>
+ <simpara>
+ Ist <constant>DBX_RESULT_ASSOC</constant> ebenfalls angegeben,
+ so enthält das zurückgegebene Objekt auch Informationen im
+ Zusammenhang mit <constant>DBX_RESULT_INFO</constant>, selbst
+ wenn es nicht angegeben wurde.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>DBX_RESULT_INFO</constant>
+ </term>
+ <listitem>
+ <simpara>
+ It provides info about columns, such as field names and field types.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>DBX_RESULT_ASSOC</constant>
+ </term>
+ <listitem>
+ <simpara>
+ Dies bewirkt, dass in der <property>data</property> Eigenschaft
+ des zurückgegebenen Objektes auf die Werte eines Feldes mit den
+ entsprechenden Spaltennamen als Schlüssel zugegriffen werden kann.
+ </simpara>
+ <simpara>
+ Assoziierte Ergebnisse sind eigentlich Referenzen zu den numerisch
+ indizierten Daten, weshalb eine Änderung von
+ <literal>data[0][0]</literal> auch den Inhalt von
+ <literal>data[0]['feldname_für_erste_spalte']</literal> betrifft.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>DBX_RESULT_UNBUFFERED</constant>
+ </term>
+ <listitem>
+ <simpara>
+ Dieses Flag unterbindet die Erstellung der <property>data</property>
+ Eigenschaft, und die <property>rows</property> Eigenschaft wird zunächst 0
+ sein. Das ist für große Datenmengen zu verwenden, wobei mit
+ <function>dbx_fetch_row</function> die Ergebnisse zeilenweise
+ abgerufen werden.
+ </simpara>
+ <simpara>
+ Die <function>dbx_fetch_row</function> Funktion gibt Zeilen zurück,
+ die mit den mit dieser Abfrage gesetzten Flags konform sind. Übrigens
+ wird auch die <property>rows</property> Eigenschaft bei jedem Aufruf
+ aktualisiert.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>DBX_COLNAMES_UNCHANGED</constant>
+ </term>
+ <listitem>
+ <simpara>
+ Die Groß-/Kleinschreibung der zurückgegebenen Spaltennamen bleibt unangetastet.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>DBX_COLNAMES_UPPERCASE</constant>
+ </term>
+ <listitem>
+ <simpara>
+ Die zurückgegebenen Spaltennamen werden in Großbuchstaben gewandelt.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>DBX_COLNAMES_LOWERCASE</constant>
+ </term>
+ <listitem>
+ <simpara>
+ Die zurückgegebenen Spaltennamen werden in Kleinbuchstaben gewandelt.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ Beachten Sie, dass <constant>DBX_RESULT_INDEX</constant> unabhängig von
+ dem aktuell verwendeten Wert des Parameters <parameter>flags</parameter>
+ immer verwendet wird. Das heißt, dass es effektiv nur die folgenden
+ Kombinationen gibt:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <constant>DBX_RESULT_INDEX</constant>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <constant>DBX_RESULT_INDEX</constant> |
+ <constant>DBX_RESULT_INFO</constant>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <constant>DBX_RESULT_INDEX</constant> |
+ <constant>DBX_RESULT_INFO</constant> |
+ <constant>DBX_RESULT_ASSOC</constant> - dies ist Standard, wenn
+ <parameter>flags</parameter> nicht angegeben ist.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
- <para>
- Der Parameter <parameter>flags</parameter> wird verwendet, um die Menge
- der zu liefernden Informationen zu steuern. Die folgenden Konstanten
- können mit dem Bit-Operator (|) beliebig kombiniert werden. Die Flags
- DBX_COLNAMES_* heben die Einstellungen dbx.colnames_case in der
- &php.ini; auf.
- <variablelist>
- <varlistentry>
- <term>
- <constant>DBX_RESULT_INDEX</constant>
- </term>
- <listitem>
- <simpara>
- Dieser Flag ist <emphasis>immer</emphasis> gesetzt, d.h. dass
- zurückgegebene Objekt hat eine Eigenschaft <property>data</property>,
- welche aus einem zweidimensionalen, numerisch indizierten Array
- besteht. Zum Beispiel steht in <literal>data[2][3]</literal> die
- <literal>2</literal> für die Reihen- (bzw. Datensatz-) Nummer, und
- <literal>3</literal> steht für die Spalten- (bzw. Feld- Nummer).
- Die erste Reihe und Spalte haben den Index 0.
- </simpara>
- <simpara>
- Ist <constant>DBX_RESULT_ASSOC</constant> ebenfalls angegeben,
- so enthält das zurückgegebene Objekt auch Informationen im
- Zusammenhang mit <constant>DBX_RESULT_INFO</constant>, selbst
- wenn es nicht angegeben wurde.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>DBX_RESULT_INFO</constant>
- </term>
- <listitem>
- <simpara>
- Liefert Informationen über Spalten, wie Feldnamen und Feldtypen.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>DBX_RESULT_ASSOC</constant>
- </term>
- <listitem>
- <simpara>
- Dies bewirkt, dass in der <property>data</property> Eigenschaft
- des zurückgegebenen Objektes auf die Werte eines Feldes mit den
- entsprechenden Spaltennamen als Schlüssel zugegriffen werden kann.
- </simpara>
- <simpara>
- Assoziierte Ergebnisse sind eigentlich Referenzen zu den numerisch
- indizierten Daten, weshalb eine Änderung von
- <literal>data[0][0]</literal> auch den Inhalt von
- <literal>data[0]['feldname_für_erste_spalte']</literal> betrifft.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>DBX_COLNAMES_UNCHANGED</constant> (available from PHP 4.3.0)
- </term>
- <listitem>
- <simpara>
- The case of the returned column names will not be changed.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>DBX_COLNAMES_UPPERCASE</constant> (available from PHP 4.3.0)
- </term>
- <listitem>
- <simpara>
- The case of the returned column names will be changed to
- uppercase.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>DBX_COLNAMES_LOWERCASE</constant> (available from PHP 4.3.0)
- </term>
- <listitem>
- <simpara>
- The case of the returned column names will be changed to
- lowercase.
- </simpara>
- </listitem>
- </varlistentry>
- </variablelist>
- Beachten Sie, dass <constant>DBX_RESULT_INDEX</constant> unabhängig von
- dem aktuell verwendeten Wert des Parameters <parameter>flags</parameter>
- immer verwendet wird. Das heißt, dass es effektiv nur die folgenden
- Kombinationen gibt:
- <itemizedlist>
- <listitem>
- <simpara>
- <constant>DBX_RESULT_INDEX</constant>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_RESULT_INDEX</constant> |
- <constant>DBX_RESULT_INFO</constant>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_RESULT_INDEX</constant> |
- <constant>DBX_RESULT_INFO</constant> |
- <constant>DBX_RESULT_ASSOC</constant> - dies ist Standard, wenn
- <parameter>flags</parameter> nicht angegeben ist.
- </simpara>
- </listitem>
- </itemizedlist>
- </para>
- <para>
- Das zurückgegebene Objekt hat abhängig von <parameter>flags</parameter>
- vier oder fünf Eigenschaften:
- <variablelist>
- <varlistentry>
- <term>
- <property>handle</property>
- </term>
- <listitem>
- <para>
- Das ein gültiges Handle für die verbundene Datenbank, und als solche
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ <function>dbx_query</function> gibt bei Erfolg ein Objekt oder
+ <literal>1</literal> zurück, und <literal>0</literal> im
+ Fehlerfall. Das Objekt wird nur zurückgegeben, wenn die in
+ <parameter>sql_statement</parameter> angegebene Abfrage eine
+ Ergebnisliste liefert (d.h. eine SELECT-Abfrage, selbst wenn die
+ Ergebnismenge leer ist).
+ </para>
+ <para>
+ Das zurückgegebene Objekt hat abhängig von <parameter>flags</parameter>
+ vier oder fünf Eigenschaften:
+ <variablelist>
+ <varlistentry>
+ <term>
+ <property>handle</property>
+ </term>
+ <listitem>
+ <para>
+ Das ein gültiges Handle für die verbundene Datenbank, und als solches
kann es (wenn nötig) auch in modulspezifischen Funktionen verwendet
werden.
- <informalexample role="php">
- <programlisting>
+ <informalexample>
+ <programlisting role="php">
<![CDATA[
-$result = dbx_query ($link, "SELECT id FROM table");
-mysql_field_len ($result->handle, 0);
+<?php
+$result = dbx_query($link, "SELECT id FROM table");
+mysql_field_len($result->handle, 0);
+?>
]]>
- </programlisting>
- </informalexample>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <property>cols</property> und <property>rows</property>
- </term>
- <listitem>
- <para>
- Diese enthalten die Anzahl der Spalten (oder Felder) bzw. Reihen
- (oder Datensätze).
- <informalexample>
- <programlisting role="php">
+ </programlisting>
+ </informalexample>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <property>cols</property> und <property>rows</property>
+ </term>
+ <listitem>
+ <para>
+ Diese enthalten die Anzahl der Spalten (oder Felder) bzw. Reihen
+ (oder Datensätze).
+ <informalexample>
+ <programlisting role="php">
<![CDATA[
-$result = dbx_query ($link, 'SELECT id FROM table');
-echo $result->rows; // Anzahl der Datensätze
-echo $result->cols; // Anzahl der Felder
+<?php
+$result = dbx_query($link, 'SELECT id FROM table');
+echo $result->rows; // number of records
+echo $result->cols; // number of fields
+?>
]]>
- </programlisting>
- </informalexample>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <property>info</property> (optional)
- </term>
- <listitem>
- <simpara>
- Dies wird nur zurückgegeben, wenn im Parameter
- <parameter>flags</parameter> entweder
- <constant>DBX_RESULT_INFO</constant> oder
- <constant>DBX_RESULT_ASSOC</constant> spezifiziert sind.
- Es ist ein zweidimensionales Array mit zwei Reihen
- (<literal>name</literal> und <literal>type</literal>),
- welches die Spalteninformationen enthält.
- </simpara>
- <example>
- <title>Auflistung von Name und Typ jedes Feldes</title>
- <programlisting role="php">
+ </programlisting>
+ </informalexample>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <property>info</property> (optional)
+ </term>
+ <listitem>
+ <simpara>
+ Dies wird nur zurückgegeben, wenn im Parameter
+ <parameter>flags</parameter> entweder
+ <constant>DBX_RESULT_INFO</constant> oder
+ <constant>DBX_RESULT_ASSOC</constant> spezifiziert sind. Es ist ein
+ zweidimensionales Array mit zwei Reihen (<literal>name</literal> und
+ <literal>type</literal>), welches die Spalteninformationen enthält.
+ </simpara>
+ <example>
+ <title>Auflistung von Name und Typ jedes Feldes</title>
+ <programlisting role="php">
<![CDATA[
-$result = dbx_query ($link, 'SELECT id FROM table',
+<?php
+$result = dbx_query($link, 'SELECT id FROM table',
DBX_RESULT_INDEX | DBX_RESULT_INFO);
for ($i = 0; $i < $result->cols; $i++ ) {
echo $result->info['name'][$i] . "\n";
- echo $result->info['type'][$i] . "\n";
+ echo $result->info['type'][$i] . "\n";
}
+?>
]]>
- </programlisting>
- </example>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <property>data</property>
- </term>
- <listitem>
- <simpara>
- Diese Eigenschaft enthält die aktuellen Ergebnisdaten, möglicherweise
- auch mit den Spaltennamen assoziiert, was jedoch vom Parameter
- <parameter>flags</parameter> abhängig ist. Wenn
- <constant>DBX_RESULT_ASSOC</constant> gesetzt ist, können Sie
- <literal>$result->data[2]["feldname"]</literal> verwenden.
- </simpara>
- <example>
- <title>Ausgabe des Inhaltes der data Eigenschaft in eine HTML Tabelle</title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <property>data</property>
+ </term>
+ <listitem>
+ <simpara>
+ Diese Eigenschaft enthält die aktuellen Ergebnisdaten, möglicherweise
+ auch mit den Spaltennamen assoziiert, was jedoch vom Parameter
+ <parameter>flags</parameter> abhängig ist. Wenn
+ <constant>DBX_RESULT_ASSOC</constant> gesetzt ist, kann
+ <literal>$result->data[2]["feldname"]</literal> verwendet werden.
+ </simpara>
+ <example>
+ <title>Ausgabe des Inhaltes der data Eigenschaft in eine HTML Tabelle</title>
+ <programlisting role="php">
<![CDATA[
-$result = dbx_query ($link, 'SELECT id, parentid, description FROM table');
+<?php
+$result = dbx_query($link, 'SELECT id, parentid, description FROM table');
echo "<table>\n";
-foreach ( $result->data as $row ) {
+foreach ($result->data as $row) {
echo "<tr>\n";
- foreach ( $row as $field ) {
+ foreach ($row as $field) {
echo "<td>$field</td>";
}
echo "</tr>\n";
}
echo "</table>\n";
+?>
]]>
- </programlisting>
- </example>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- <note>
- <para>
- Konsultieren Sie bitte auch die modulspezifische Dokumentation.
- </para>
- <para>
- Spaltennamen für Abfragen an einer Oracle Datenbank werden in
- Kleinbuchstaben zurückgegeben.
- </para>
- </note>
- <para>
- Siehe auch <function>dbx_escape_string</function> und <function>dbx_connect</function>.
- </para>
- </refsect1>
- </refentry>
+ </programlisting>
+ </example>
+ <example>
+ <title>Umgang mit UNGEPUFFERTEN Abfragen</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$result = dbx_query ($link, 'SELECT id, parentid, description FROM table', DBX_RESULT_UNBUFFERED);
+
+echo "<table>\n";
+while ($row = dbx_fetch_row($result)) {
+ echo "<tr>\n";
+ foreach ($row as $field) {
+ echo "<td>$field</td>";
+ }
+ echo "</tr>\n";
+}
+echo "</table>\n";
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.0.0</entry>
+ <entry>
+ <constant>DBX_RESULT_UNBUFFERED</constant> wurde eingeführt.
+ </entry>
+ </row>
+ <row>
+ <entry>4.3.0</entry>
+ <entry>
+ <constant>DBX_COLNAMES_UNCHANGED</constant>,
+ <constant>DBX_COLNAMES_UPPERCASE</constant>, und
+ <constant>DBX_COLNAMES_LOWERCASE</constant> wurden eingeführt.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>Wie mit dem gelieferten Wert umgegangen wird</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$link = dbx_connect(DBX_ODBC, "", "db", "username", "password")
+ or die("Fehler beim Verbinden");
+
+$result = dbx_query($link, 'SELECT id, parentid, description FROM table');
+
+if (is_object($result)) {
+ // ... tue hier irgendetwas, detaillierte Beispiele siehe unten ...
+ // erst die Ausgabe der Feldnamen und Typen
+ // dann die Ausgabe einer Tabelle mit den gelieferten Werten
+} else {
+ exit("Abfrage ist fehlgeschlagen");
+}
+
+dbx_close($link);
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <para>
+ Die Modul spezifische Dokumentation sollte ebenfalls konsultiert werden.
+ </para>
+ <para>
+ Spaltennamen für Anfragen an eine Oracle Datenbank werden in Kleinbuchstaben
+ zurückgegeben.
+ </para>
+ </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>dbx_escape_string</function></member>
+ <member><function>dbx_fetch_row</function></member>
+ <member><function>dbx_connect</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/de/trunk/reference/dio/functions/dio-seek.xml
===================================================================
--- phpdoc/de/trunk/reference/dio/functions/dio-seek.xml 2018-04-08 09:52:02 UTC (rev 344633)
+++ phpdoc/de/trunk/reference/dio/functions/dio-seek.xml 2018-04-08 12:36:51 UTC (rev 344634)
@@ -1,24 +1,26 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: hholzgra Status: ready -->
+<!-- EN-Revision: 297028 Maintainer: nobody Status: ready -->
+
<refentry xml:id="function.dio-seek" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dio_seek</refname>
<refpurpose>Setzt den Dateizeiger</refpurpose>
</refnamediv>
+
<refsect1 role="description">
- <title>Beschreibung</title>
<methodsynopsis>
<type>int</type><methodname>dio_seek</methodname>
<methodparam><type>resource</type><parameter>fd</parameter></methodparam>
<methodparam><type>int</type><parameter>pos</parameter></methodparam>
- <methodparam><type>int</type><parameter>whence</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>whence</parameter><initializer>SEEK_SET</initializer></methodparam>
</methodsynopsis>
<para>
Die Funktion <function>dio_seek</function> setzt den Dateizeiger
- der Datei <parameter>fd</parameter>.
+ des angegebenen Dateideskriptors.
</para>
</refsect1>
+
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -48,7 +50,7 @@
<itemizedlist>
<listitem>
<para>
- <constant>SEEK_SET</constant> - gibt an, dass
+ <constant>SEEK_SET</constant> (Standardwert) - gibt an, dass
<parameter>pos</parameter> die Position vom Anfang der Datei ist
</para>
</listitem>
@@ -56,7 +58,8 @@
<para>
<constant>SEEK_CUR</constant> - gibt an, dass
<parameter>pos</parameter> die Position relativ von der
- momentanen Dateizeigerposition ist.
+ momentanen Dateizeigerposition ist. Die Position kann positiv oder
+ negativ sein.
</para>
</listitem>
<listitem>
@@ -66,7 +69,8 @@
Position relativ zum Dateiende ist. Eine negative Zahl setzt
den Dateizeiger innerhalb der Datei, ein positiver Wert
bewirkt, dass die Datei vom Ende bis zur neuen Position mit
- Nullen aufgefüllt wird.
+ Nullen aufgefüllt wird, sobald tatsächlich weitere Daten geschrieben
+ werden.
</para>
</listitem>
</itemizedlist>
@@ -76,11 +80,13 @@
</variablelist>
</para>
</refsect1>
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -113,6 +119,7 @@
</example>
</para>
</refsect1>
+
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/de/trunk/reference/exec/functions/escapeshellarg.xml
===================================================================
--- phpdoc/de/trunk/reference/exec/functions/escapeshellarg.xml 2018-04-08 09:52:02 UTC (rev 344633)
+++ phpdoc/de/trunk/reference/exec/functions/escapeshellarg.xml 2018-04-08 12:36:51 UTC (rev 344634)
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: sammywg Status: working -->
+<!-- EN-Revision: 344401 Maintainer: nobody Status: ready -->
+
<refentry xml:id="function.escapeshellarg" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>escapeshellarg</refname>
@@ -18,7 +19,7 @@
um eine Zeichenkette herum ein und maskiert alle existierenden einfachen
Anführungszeichen innerhalb der Zeichenkette und ermöglicht es so die
Zeichenkette direkt als Argument einer Shell-Funktion zu verwenden
- so das es als ein einziges Argument interpretiert wird. Die Funktion
+ so dass es als ein einziges Argument interpretiert wird. Die Funktion
sollte benutzt werden um aus Benutzereingaben stammende Argumente
an Shell-Funktionen weiterzugeben. Zu den Shell-Funktionen zählen
unter anderem <function>exec</function>, <function>system</function>
@@ -25,6 +26,12 @@
und der
<link linkend="language.operators.execution">Backtick Operator</link>.
</para>
+ <para>
+ Unter Windows ersetzt <function>escapeshellarg</function> statt dessen
+ Prozentzeichen, Ausrufezeichen (verzögerte Variablenersetzung) und doppelte
+ Anführungszeichen mit Leerzeichen, und schließt die Zeichenkette in doppelte
+ Anführungszeichen ein.
+ </para>
</refsect1>
<refsect1 role="parameters">
@@ -35,7 +42,7 @@
<term><parameter>arg</parameter></term>
<listitem>
<para>
- Die zu maskierende Zeichenkette
+ Die zu maskierende Zeichenkette.
</para>
</listitem>
</varlistentry>
@@ -46,7 +53,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Die maskierte Zeichenkette
+ Die maskierte Zeichenkette.
</para>
</refsect1>
@@ -66,6 +73,30 @@
</para>
</refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.4.43, 5.5.27, 5.6.11</entry>
+ <entry>
+ Ausrufezeichen werden nun durch Leerzeichen ersetzt.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
Modified: phpdoc/de/trunk/reference/exif/functions/exif-read-data.xml
===================================================================
--- phpdoc/de/trunk/reference/exif/functions/exif-read-data.xml 2018-04-08 09:52:02 UTC (rev 344633)
+++ phpdoc/de/trunk/reference/exif/functions/exif-read-data.xml 2018-04-08 12:36:51 UTC (rev 344634)
@@ -1,32 +1,32 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<!-- splitted from ./en/functions/image.xml, last change in rev 1.78 -->
+<!-- EN-Revision: 343899 Maintainer: nobody Status: ready -->
+
<refentry xml:id="function.exif-read-data" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>exif_read_data</refname>
- <refpurpose>Liest die <acronym>EXIF</acronym>-Header von <acronym>JPEG</acronym> oder <acronym>TIFF</acronym> aus</refpurpose>
+ <refpurpose>Liest die <acronym>EXIF</acronym>-Header einer Bilddatei aus</refpurpose>
</refnamediv>
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>exif_read_data</methodname>
- <methodparam><type>string</type><parameter>filename</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>sections</parameter></methodparam>
- <methodparam choice="opt"><type>bool</type><parameter>arrays</parameter></methodparam>
- <methodparam choice="opt"><type>bool</type><parameter>thumbnail</parameter></methodparam>
+ <methodparam><type>mixed</type><parameter>stream</parameter></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>sections</parameter><initializer>&null;</initializer></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>arrays</parameter><initializer>&false;</initializer></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>thumbnail</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<function>exif_read_data</function> liest die
- <acronym>EXIF</acronym>-Header aus einer <acronym>JPEG</acronym>- oder
- <acronym>TIFF</acronym>-Bilddatei aus. Auf diese Weise kann man die
- Metadaten auslesen, die mit Digitalkameras erzeugt wurden.
+ <acronym>EXIF</acronym>-Header aus einer Bilddatei aus. Auf diese Weise können die
+ Metadaten ausgelesen werden, die mit Digitalkameras erzeugt wurden.
</para>
<para>
- Exif-Header kommen normalerweise bei JPEG/TIFF-Bildern vor, die von
+ <acronym>EXIF</acronym>-Header kommen normalerweise bei JPEG/TIFF-Bildern vor, die von
Digitalkameras gemacht wurden. Leider hat jeder Kamerahersteller eine
- andere Vorstellung davon, wie man die Bilder beschreibt. Man kann sich
- also nicht darauf verlassen, das ein bestimmter Exif-Header vorhanden ist.
+ andere Vorstellung davon, wie man die Bilder beschreibt, so dass man sich
+ also nicht darauf verlassen kann, das ein bestimmter Exif-Header vorhanden ist.
</para>
<para>
<literal>Height</literal> und <literal>Width</literal> werden genauso wie
@@ -40,21 +40,21 @@
aus zwei Werten bestehen. Da die Lösung im Exif-2.10 -Standard nicht
konsistent ist, liefert der COMPUTED-Bereich die beiden Einträge
<literal>Copyright.Photographer</literal> und <literal>Copyright.Editor</literal>,
- während der IFD0-Bereich aus einem Byte-Array besteht, der die beiden Werte
- duch ein NULL-Zeichen trennt. Wenn der Datentyp falsch ist, ist nur der
- erste Eintrag vorhanden (normales Verhalten von Exif). COMPUTED beinhaltet
- auch ein <literal>Copyright</literal>-Eintrag. Dieser entspricht entweder
+ während der <literal>IFD</literal>-Bereich aus einem Byte-Array besteht, in dem die beiden Werte
+ duch ein NULL-Zeichen getrennt sind. Wenn der Datentyp falsch ist, ist nur der
+ erste Eintrag vorhanden (normales Verhalten von Exif). <literal>COMPUTED</literal> beinhaltet
+ auch einen <literal>Copyright</literal>-Eintrag. Dieser entspricht entweder
dem originalen Copyright-String oder er besteht aus einer kommaseparierten
Liste von Foto- und Herausgeber-Copyright.
</para>
<para>
- Der Tag UserComment besitzt das gleiche Problem, wie das Copyright-Tag. Er
+ Der Tag <literal>UserComment</literal> hat das gleiche Problem, wie das Copyright-Tag. Er
kann zwei Werte speichern. Als erstes die benutze Kodierung und als zweites
- den Wert selbst. Wenn dem so ist, enthält der IFD-Bereich die Kodierung oder
- ein Byte-Array. Der COMPUTED-Bereich speichert die beiden Einträge
+ den Wert selbst. Wenn dem so ist, enthält der <literal>IFD</literal>-Bereich nur die Kodierung oder
+ ein Byte-Array. Der <literal>COMPUTED</literal>-Bereich speichert die beiden Einträge
<literal>UserCommentEncoding</literal> und <literal>UserComment</literal>.
Der Eintrag <literal>UserComment</literal> ist in beiden Fällen verfügbar.
- Er sollte also dem Eintrag im IFD0-Bereich vorgezogen werden.
+ Er sollte also dem Eintrag im <literal>IFD0</literal>-Bereich vorgezogen werden.
</para>
<para>
<function>exif_read_data</function> validiert auch EXIF-Datentags entsprechend
@@ -64,21 +64,22 @@
<note>
<para>
Windows ME/XP können beide beim Anschließen einer Kamera die Exif-Header
- verwerfen. Mehr Informationen dazu sind unter
- [toten Link] zu finden. <!-- Removed link to fix the build ~sobak 12/06/2016 -->
+ verwerfen.>
</para>
</note>
</refsect1>
+
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
- <term><parameter>filename</parameter></term>
+ <term><parameter>stream</parameter></term>
<listitem>
<para>
- Der Name der zu lesenden Bilddatei. Dieser darf keine
- <acronym>URL</acronym> sein.
+ Der Ort der Bilddatei. Dies kann entweder der Pfad der Datei
+ (Stream-Wrapper werden wie üblich ebenso unterstützt) oder eine
+ Stream-<type>resource</type> sein.
</para>
</listitem>
</varlistentry>
@@ -102,13 +103,13 @@
html, Width, Height, IsColor und andere, wenn vorhanden. Height und
Width werden genauso wie <function>getimagesize</function> berechnet.
Diese Werte dürfen also nicht Teil von irgendwelchen Headern sein,
- die zurückgegeben werden. Ferner ist html ein Höhen/Breiten-Textstring
+ die zurückgegeben werden. Ferner ist <literal>html</literal> ein Höhen/Breiten-Textstring
für den Gebrauch in normalem <acronym>HTML</acronym>.
</entry>
</row>
<row>
<entry>ANY_TAG</entry>
- <entry>Irgendwelche Informationen, die ein Tag besitzen, wie z.B. IFD0, EXIF, ...</entry>
+ <entry>Jegliche Informationen, die ein Tag besitzen, wie z.B. <literal>IFD0</literal>, <literal>EXIF</literal>, ...</entry>
</row>
<row>
<entry>IFD0</entry>
@@ -120,7 +121,7 @@
<entry>THUMBNAIL</entry>
<entry>
Eine Datei sollte ein Miniaturbild enthalten, wenn es einen zweiten
- IFD besitzt. Alle Informationen mit Tags über das eingebettete
+ <literal>IFD</literal> besitzt. Alle Informationen mit Tags über das eingebettete
Miniaturbild werden in diesem Bereich gespeichert.
</entry>
</row>
@@ -131,7 +132,7 @@
<row>
<entry>EXIF</entry>
<entry>
- Der EXIF-Bereich ist ein Unterbereich von IFD0. Er enthält
+ Der EXIF-Bereich ist ein Unterbereich von <literal>IFD0</literal>. Er enthält
detailliertere Information über das Bild. Die meisten dieser
Einträge beziehen sich auf die Digitalkamera.
</entry>
@@ -166,15 +167,17 @@
</variablelist>
</para>
</refsect1>
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Gibt ein assoziatives <type>array</type> zurück, bei dem der Arrayindex den
Headernamen entspricht und der Arraywert die Werte enthält, die mit diesen
- Headern in Verbindung stehen. Wenn keine Daten zurückgeliefert werde können,
+ Headern in Verbindung stehen. Wenn keine Daten zurückgeliefert werden können,
liefert <function>exif_read_data</function> &false;.
</para>
</refsect1>
+
<refsect1 role="changelog">
&reftitle.changelog;
<para>
@@ -188,6 +191,77 @@
</thead>
<tbody>
<row>
+ <entry>7.2.0</entry>
+ <entry>
+ Der Parameter <parameter>filename</parameter> wurde in
+ <parameter>stream</parameter> umbenannt, und unterstützt nun sowohl
+ lokale Dateien als auch Stream-Ressourcen.
+ </entry>
+ </row>
+ <row>
+ <entry>7.2.0</entry>
+ <entry>
+ Unterstzüng für folgende EXIF-Formate wurde hinzugefügt:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ Samsung
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ DJI
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Panasonic
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Sony
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Pentax
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Minolta
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Sigma/Foveon
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ AGFA
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Kyocera
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Ricoh
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Epson
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </entry>
+ </row>
+ <row>
<entry>4.3.0</entry>
<entry>
Kann alle eingebetteten <acronym>IFD</acronym>-Daten inklusive Arrays
@@ -204,7 +278,7 @@
<entry>
Wenn PHP <link linkend="ref.mbstring">mbstring</link> unterstützt, können
die Benutzerkommentare automatisch umkodiert werden. Benutzerkommentare
- in Unicode oder JIS werden automatisch in den entsprechenden exif-Initwert
+ in <literal>Unicode</literal> oder <literal>JIS</literal> werden automatisch in den entsprechenden exif-Initwert
der &php.ini; umkodiert.
</entry>
</row>
@@ -211,10 +285,10 @@
<row>
<entry>4.3.0</entry>
<entry>
- Wenn das Bild irgendeinen IFD0-Wert hat, enthält der Bereich COMPUTED
- einen Eintrag ByteOrderMotorola, welcher auf 0 für little-endian (intel)
- und 1 für big-endian (motorola) Bytefolge gesetzt ist. Bei einem
- falschen Datentyp, enthalten COMPUTED und UserComment auch nicht mehr
+ Wenn das Bild irgendeinen <literal>IFD0</literal>-Wert hat, enthält der Bereich <literal>COMPUTED</literal>
+ einen Eintrag <literal>ByteOrderMotorola</literal>, welcher auf 0 für <literal>little-endian</literal> (intel)
+ und 1 für <literal>big-endian</literal> (motorola) Bytefolge gesetzt ist. Bei einem
+ falschen Datentyp, enthalten <literal>COMPUTED</literal> und <literal>UserComment</literal> auch nicht mehr
nur den ersten Copyrighteintrag.
</entry>
</row>
@@ -223,6 +297,7 @@
</informaltable>
</para>
</refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -283,7 +358,82 @@
</screen>
</example>
</para>
+ <para>
+ <example>
+ <title><function>exif_read_data</function> mit Streams; verfügbar von PHP 7.2.0 an</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// Öffne die Datei im Binärmodus
+$fp = fopen('/path/to/image.jpg', 'rb');
+
+if (!$fp) {
+ echo 'Fehler: Konnte das Bild nicht fürs Lesen öffnen';
+ exit;
+}
+
+// Versuche die Exif-Header zu lesen
+$headers = exif_read_data($fp);
+
+if (!$headers) {
+ echo 'Fehler: Konnte die Exif-Header nicht lesen';
+ exit;
+}
+
+// Gib die 'COMPUTED'-Header aus
+echo 'EXIF Header:' . PHP_EOL;
+
+foreach ($headers['COMPUTED'] as $header => $value) {
+ printf(' %s => %s%s', $header, $value, PHP_EOL);
+}
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <screen role="php">
+<![CDATA[
+EXIF Header:
+ Height => 576
+ Width => 1024
+ IsColor => 1
+ ByteOrderMotorola => 0
+ ApertureFNumber => f/5.6
+ UserComment =>
+ UserCommentEncoding => UNDEFINED
+ Copyright => Denis
+ Thumbnail.FileType => 2
+ Thumbnail.MimeType => image/jpeg
+]]>
+ </screen>
+ </example>
+ </para>
</refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <para>
+ Ist <link linkend="ref.mbstring">mbstring</link> aktiviert, wird exif
+ versuchen den unicode zu verarbeiten, und einen Zeichensatz gemäß <link
+ linkend="ini.exif.decode-unicode-motorola">exif.decode_unicode_motorola</link>
+ und <link
+ linkend="ini.exif.decode-unicode-intel">exif.decode_unicode_intel</link> zu
+ wählen. Die exif Erweiterung versucht nicht, die Kodierung selbst zu
+ ermitteln, so dass es die Aufgabe des Benutzers ist, die gewünschte
+ Kodierung durch Setzen einer der beiden ini Direktiven anzugeben, bevor
+ <function>exif_read_data</function> aufgerufen wird.
+ </para>
+ </note>
+ <note>
+ <para>
+ Wird der Parameter <parameter>stream</parameter> verwendet, um einen Stream
+ an diese Funktion zu übergeben, dann muss der Stream suchbar sein. Es ist zu
+ beachten, dass die Position des Dateizeigers nach dem Aufruf dieser Funktion
+ unverändert ist.
+ </para>
+ </note>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -290,9 +440,11 @@
<simplelist>
<member><function>exif_thumbnail</function></member>
<member><function>getimagesize</function></member>
+ <member><xref linkend="wrappers"/></member>
</simplelist>
</para>
</refsect1>
+
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/de/trunk/reference/exif/functions/exif-tagname.xml
===================================================================
--- phpdoc/de/trunk/reference/exif/functions/exif-tagname.xml 2018-04-08 09:52:02 UTC (rev 344633)
+++ phpdoc/de/trunk/reference/exif/functions/exif-tagname.xml 2018-04-08 12:36:51 UTC (rev 344634)
@@ -1,21 +1,21 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<refentry xml:id="function.exif-tagname" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: 305637 Maintainer: nobody Status: ready -->
+
+<refentry xml:id="function.exif-tagname" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>exif_tagname</refname>
<refpurpose>Gibt den Header-Namen für einen Index zurück</refpurpose>
</refnamediv>
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>exif_tagname</methodname>
- <methodparam><type>string</type><parameter>index</parameter></methodparam>
+ <methodparam><type>int</type><parameter>index</parameter></methodparam>
</methodsynopsis>
+ </refsect1>
- &warn.undocumented.func;
-
- </refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -24,7 +24,7 @@
<term><parameter>index</parameter></term>
<listitem>
<para>
- Der Bildindex
+ Die Tag-ID für welche ein Tag-Name nachgeschlagen wird.
</para>
</listitem>
</varlistentry>
@@ -31,21 +31,50 @@
</variablelist>
</para>
</refsect1>
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Gibt den Header-Namen oder &false; zurück, wenn der <parameter>index</parameter>
- nicht definiert ist.
+ keine definierte EXIF-Tag-ID ist.
</para>
</refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>exif_tagname</function> Beispiel</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+echo "256: ".exif_tagname(256).PHP_EOL;
+echo "257: ".exif_tagname(257).PHP_EOL;
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+256: ImageWidth
+257: ImageLength
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>exif_imagetype</function></member>
+ <member><link xlink:href="&url.exifspec;">EXIF Spezifikation</link></member>
+ <member><link xlink:href="&url.exiftags;">EXIF Tags</link></member>
</simplelist>
</para>
</refsect1>
+
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/de/trunk/reference/expect/setup.xml
===================================================================
--- phpdoc/de/trunk/reference/expect/setup.xml 2018-04-08 09:52:02 UTC (rev 344633)
+++ phpdoc/de/trunk/reference/expect/setup.xml 2018-04-08 12:36:51 UTC (rev 344634)
@@ -1,5 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
+<!-- EN-Revision: 288721 Maintainer: nobody Status: ready -->
<chapter xml:id="expect.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
@@ -27,8 +28,8 @@
<section xml:id="expect.resources">
&reftitle.resources;
<para>
- <function>expect_popen</function> Gibt einen offenen PTY Stream unter Verwendung von
- <function>expect_expectl</function>.
+ <function>expect_popen</function> gibt einen offenen PTY Stream zurück, der von
+ <function>expect_expectl</function> verwendet wird.
</para>
</section>
<!-- }}} -->
Modified: phpdoc/de/trunk/reference/filter/functions/filter-var-array.xml
===================================================================
--- phpdoc/de/trunk/reference/filter/functions/filter-var-array.xml 2018-04-08 09:52:02 UTC (rev 344633)
+++ phpdoc/de/trunk/reference/filter/functions/filter-var-array.xml 2018-04-08 12:36:51 UTC (rev 344634)
@@ -1,11 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 343899 Maintainer: nobody Status: ready -->
+
<refentry xml:id="function.filter-var-array" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>filter_var_array</refname>
<refpurpose>Nimmt mehrere Variablen entgegen und filtert sie optional</refpurpose>
</refnamediv>
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -12,12 +14,14 @@
<type>mixed</type><methodname>filter_var_array</methodname>
<methodparam><type>array</type><parameter>data</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>definition</parameter></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>add_empty</parameter><initializer>&true;</initializer></methodparam>
</methodsynopsis>
<para>
- Diese Funktion ist sinnvoll um mehrere Werte abzufragen ohne wiederholend
+ Diese Funktion ist nützlich um mehrere Werte abzufragen ohne wiederholt
<function>filter_var</function> aufrufen zu müssen.
</para>
</refsect1>
+
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -35,15 +39,15 @@
<term><parameter>definition</parameter></term>
<listitem>
<para>
- Array dass die Argumente enthält. Ein gültiger Key ist ein
- <type>string</type> der einen Variablennamen enthält und ein gültiger
- Wert ist entweder ein Filter oder ein <type>array</type> welches den
+ Ein Array dass die Argumente enthält. Ein gültiger Key ist ein
+ <type>String</type>, der einen Variablennamen enthält, und ein gültiger
+ Wert ist entweder ein <link linkend="filter.filters">Filtertyp</link> oder ein <type>array</type>, das den
Filter, seine Flags und Optionen spezifiziert. Wenn der Wert
- ein Array ist, sind gültige Keys <literal>filter</literal> der den
- Filtertyp definiert, <literal>flags</literal> welches jegliche Flags
- die den Filter spezifizieren enthält und <literal>options</literal>
- welches die Optionen enthält to den Filter beschreiben. Für ein
- besseres Verständnis sehen Sie sich das Beispiel an.
+ ein Array ist, sind gültige Keys <literal>filter</literal>, das den
+ <link linkend="filter.filters">Filtertyp</link> angibt, <literal>flags</literal>, das jegliche Flags,
+ die den Filter spezifizieren, enthält, und <literal>options</literal>
+ welches die Optionen enthält, die den Filter beschreiben. Für ein
+ besseres Verständnis ist das Beispiel weiter unten zu konsultieren.
</para>
<para>
Der Parameter kann auch ein Integer sein der eine <link
@@ -52,14 +56,23 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><parameter>add_empty</parameter></term>
+ <listitem>
+ <para>
+ Nicht vorhandene Schlüssel werden als &null; zum Rückgabewert hinzugefügt.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
</refsect1>
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Bei Erfolg wird ein Array zurückgegeben, welches alle Werte der angefragten
- Variablen enthält oder &false; im Fehlerfall. Ein einzelner Array-Wert ist
+ Bei Erfolg wird ein Array zurückgegeben, das alle Werte der angefragten
+ Variablen enthält, oder &false; im Fehlerfall. Ein einzelner Array-Wert ist
&false;, wenn das Filtern fehlgeschlagen ist oder &null;, wenn die Variable
nicht gesetzt ist.
</para>
@@ -113,10 +126,7 @@
<![CDATA[
array(6) {
["product_id"]=>
- array(1) {
- [0]=>
- string(17) "libgd%3Cscript%3E"
- }
+ string(17) "libgd%3Cscript%3E"
["component"]=>
array(1) {
[0]=>
@@ -123,10 +133,7 @@
int(10)
}
["versions"]=>
- array(1) {
- [0]=>
- string(6) "2.0.33"
- }
+ string(6) "2.0.33"
["doesnotexist"]=>
NULL
["testscalar"]=>
@@ -143,6 +150,30 @@
</para>
</refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.4.0</entry>
+ <entry>
+ Der Parameter <parameter>add_empty</parameter> wurde hinzugefügt.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -150,6 +181,7 @@
<member><function>filter_input_array</function></member>
<member><function>filter_var</function></member>
<member><function>filter_input</function></member>
+ <member><xref linkend="filter.filters" /></member>
</simplelist>
</para>
</refsect1>
Modified: phpdoc/de/trunk/reference/funchand/functions/func-get-args.xml
===================================================================
--- phpdoc/de/trunk/reference/funchand/functions/func-get-args.xml 2018-04-08 09:52:02 UTC (rev 344633)
+++ phpdoc/de/trunk/reference/funchand/functions/func-get-args.xml 2018-04-08 12:36:51 UTC (rev 344634)
@@ -1,12 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: hholzgra Status: ready -->
+<!-- EN-Revision: 338280 Maintainer: nobody Status: ready -->
+
<refentry xml:id="function.func-get-args" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>func_get_args</refname>
<refpurpose>Liefert Funktionsargumente als Array</refpurpose>
</refnamediv>
-
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -18,7 +19,7 @@
</para>
<para>
Die Funktion kann zusammen mit <function>func_get_arg</function>
- und <function>func_get_args</function> genutzt werden um Funktionen
+ und <function>func_num_args</function> genutzt werden um Funktionen
mit einer variablen Anzahl von Argumenten zu implementieren.
</para>
</refsect1>
@@ -49,6 +50,15 @@
Diese Funktion kann nun auch in Parameterlisten genutzt werden.
</entry>
</row>
+ <row>
+ <entry>5.3.0</entry>
+ <entry>
+ Wird diese Funktion aus dem äußeren Geltungsbereich einer Datei
+ aufgerufen, die durch den Aufruf von <function>include</function>
+ oder <function>require</function> aus einer Funktion heraus inkludiert
+ wurde, wird nun eine Warnung erzeugt, und &false; zurückgegeben.
+ </entry>
+ </row>
</tbody>
</tgroup>
</informaltable>
@@ -58,7 +68,7 @@
<refsect1 role="errors">
&reftitle.errors;
<para>
- Die Funktion generiert eine Warnung wenn sie außerhalb einer
+ Die Funktion generiert eine Warnung, wenn sie außerhalb einer
benutzerdefinierten Funktion aufgerufen wird.
</para>
</refsect1>
@@ -74,13 +84,13 @@
function foo()
{
$numargs = func_num_args();
- echo "Anzahl der Argumente: $numargs<br />\n";
+ echo "Anzahl der Argumente: $numargs \n";
if ($numargs >= 2) {
- echo "Das zweite Argument ist: " . func_get_arg(1) . "<br />\n";
+ echo "Das zweite Argument ist: " . func_get_arg(1) . "\n";
}
$arg_list = func_get_args();
for ($i = 0; $i < $numargs; $i++) {
- echo "Argument $i ist: " . $arg_list[$i] . "<br />\n";
+ echo "Argument $i ist: " . $arg_list[$i] . "\n";
}
}
@@ -88,8 +98,120 @@
?>
]]>
</programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+Anzahl der Argumente: 3
+Das zweite Argument ist: 2
+Argument 0 ist: 1
+Argument 1 ist: 2
+Argument 2 ist: 3
+]]>
+ </screen>
</example>
</para>
+ <para>
+ <example>
+ <title><function>func_get_args</function> Beispiel vor und nach PHP 5.3</title>
+ <programlisting role="php">
+<![CDATA[
+test.php
+<?php
+function foo() {
+ include './fga.inc';
+}
+
+foo('Erstes Argument', 'Zweites Argument');
+?>
+
+fga.inc
+<?php
+
+$args = func_get_args();
+var_export($args);
+
+?>
+]]>
+ </programlisting>
+ <para>
+ Ausgabe vor PHP 5.3:
+ </para>
+ <screen>
+<![CDATA[
+array (
+ 0 => 'Erstes Argument',
+ 1 => 'Zweites Argument',
+)
+]]>
+ </screen>
+ <para>
+ Ausgabe in PHP 5.3 und später:
+ </para>
+ <screen>
+<![CDATA[
+Warning: func_get_args(): Called from the global scope - no function
+context in /home/torben/Desktop/code/ml/fga.inc on line 3
+false
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title><function>func_get_args</function> Beispiel mit Referenz- und Wert-Argumenten</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function byVal($arg) {
+ echo 'Wie übergeben : ', var_export(func_get_args()), PHP_EOL;
+ $arg = 'baz';
+ echo 'Nach Änderung : ', var_export(func_get_args()), PHP_EOL;
+}
+
+function byRef(&$arg) {
+ echo 'Wie übergeben : ', var_export(func_get_args()), PHP_EOL;
+ $arg = 'baz';
+ echo 'Nach Änderung : ', var_export(func_get_args()), PHP_EOL;
+}
+
+$arg = 'bar';
+byVal($arg);
+byRef($arg);
+?>
+]]>
+ </programlisting>
+ &example.outputs.7;
+ <screen>
+Wie übergeben : array (
+ 0 => 'bar',
+)
+Nach Änderung : array (
+ 0 => 'baz',
+)
+Wie übergeben : array (
+ 0 => 'bar',
+)
+Nach Änderung : array (
+ 0 => 'baz',
+)
+ </screen>
+ &example.outputs.5;
+ <screen>
+Wie übergeben : array (
+ 0 => 'bar',
+)
+Nach Änderung : array (
+ 0 => 'bar',
+)
+Wie übergeben : array (
+ 0 => 'bar',
+)
+Nach Änderung : array (
+ 0 => 'baz',
+)
+ </screen>
+ </example>
+ </para>
</refsect1>
<refsect1 role="notes">
@@ -97,8 +219,8 @@
¬e.funcnoparam;
<note>
<simpara>
- This function returns a copy of the passed arguments only, and does not
- account for default (non-passed) arguments.
+ Diese Funktion gibt nur eine Kopie der übergebenen Argumente zurück, und
+ berücksichtigt keine Default-Argumente (falls nicht übergeben).
</simpara>
</note>
</refsect1>
@@ -107,8 +229,10 @@
&reftitle.seealso;
<para>
<simplelist>
+ <member><link linkend="functions.variable-arg-list.new"><literal>...</literal> Syntax in PHP 5.6+</link></member>
<member><function>func_get_arg</function></member>
<member><function>func_num_args</function></member>
+ <member><methodname>ReflectionFunctionAbstract::getParameters</methodname></member>
</simplelist>
</para>
</refsect1>
Modified: phpdoc/de/trunk/reference/funchand/functions/func-num-args.xml
===================================================================
--- phpdoc/de/trunk/reference/funchand/functions/func-num-args.xml 2018-04-08 09:52:02 UTC (rev 344633)
+++ phpdoc/de/trunk/reference/funchand/functions/func-num-args.xml 2018-04-08 12:36:51 UTC (rev 344634)
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: hholzgra Status: ready -->
+<!-- EN-Revision: 334626 Maintainer: nobody Status: ready -->
+
<refentry xml:id="function.func-num-args" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>func_num_args</refname>
@@ -14,12 +15,11 @@
<void/>
</methodsynopsis>
<para>
- Liefert die Anzahl der Argumente die an die aufrufende Funktion
- übergeben wurden.
+ Ermittelt die Anzahl der an eine Funktion übergebenen Argumente.
</para>
<para>
Diese Funktion kann zusammen mit <function>func_get_arg</function>
- und <function>func_get_args</function> genutzt werden um Funktionen
+ und <function>func_get_args</function> genutzt werden, um Funktionen
mit einer variablen Anzahl von Argumenten zu implementieren.
</para>
</refsect1>
@@ -27,7 +27,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Liefert die Anzahl der Argumente die beim Aufruf an die aufrufenden
+ Liefert die Anzahl der Argumente, die an die aufgerufene
Funktion übergeben wurden.
</para>
</refsect1>
@@ -50,6 +50,15 @@
Diese Funktion kann nun auch in Parameterlisten genutzt werden.
</entry>
</row>
+ <row>
+ <entry>5.3.0</entry>
+ <entry>
+ Wird diese Funktion aus dem äußeren Geltungsbereich einer Datei
+ aufgerufen, die durch den Aufruf von <function>include</function>
+ oder <function>require</function> aus einer Funktion heraus inkludiert
+ wurde, wird nun eine Warnung erzeugt, und -1 zurückgegeben.
+ </entry>
+ </row>
</tbody>
</tgroup>
</informaltable>
@@ -59,7 +68,7 @@
<refsect1 role="errors">
&reftitle.errors;
<para>
- Die Funktion generiert eine Warnung wenn sie von außerhalb einer
+ Die Funktion generiert eine Warnung, wenn sie von außerhalb einer
benutzerdefinierten Funktion aufgerufen wird.
</para>
</refsect1>
@@ -78,12 +87,61 @@
echo "Anzahl der Argumente: $numargs\n";
}
-foo(1, 2, 3); // Ergebnis: 'Anzahl der Argumente: 3'
+foo(1, 2, 3);
?>
]]>
</programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+Anzahl der Argumente: 3
+]]>
+ </screen>
</example>
</para>
+ <para>
+ <example>
+ <title><function>func_num_args</function> Beispiel vor und nach PHP 5.3</title>
+ <programlisting role="php">
+<![CDATA[
+test.php
+<?php
+function foo() {
+ include './fna.php';
+}
+
+foo('Erstes Argument', 'Zweites Argument');
+?>
+
+fna.php
+<?php
+
+$num_args = func_num_args();
+var_export($num_args);
+
+?>
+]]>
+ </programlisting>
+ <para>
+ Ausgabe vor PHP 5.3:
+ </para>
+ <screen>
+<![CDATA[
+2
+]]>
+ </screen>
+ <para>
+ Die Ausgabe in PHP 5.3 und später ist ähnlich wie:
+ </para>
+ <screen>
+<![CDATA[
+Warning: func_num_args(): Called from the global scope - no function
+context in /home/torben/Desktop/code/ml/fna.php on line 3
+-1
+]]>
+ </screen>
+ </example>
+ </para>
</refsect1>
<refsect1 role="notes">
@@ -95,8 +153,10 @@
&reftitle.seealso;
<para>
<simplelist>
+ <member><link linkend="functions.variable-arg-list.new"><literal>...</literal> Syntax in PHP 5.6+</link></member>
<member><function>func_get_arg</function></member>
<member><function>func_get_args</function></member>
+ <member><methodname>ReflectionFunctionAbstract::getNumberOfParameters</methodname></member>
</simplelist>
</para>
</refsect1>
Modified: phpdoc/de/trunk/reference/ibase/functions/ibase-fetch-object.xml
===================================================================
--- phpdoc/de/trunk/reference/ibase/functions/ibase-fetch-object.xml 2018-04-08 09:52:02 UTC (rev 344633)
+++ phpdoc/de/trunk/reference/ibase/functions/ibase-fetch-object.xml 2018-04-08 12:36:51 UTC (rev 344634)
@@ -1,43 +1,105 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
- <refentry xml:id="function.ibase-fetch-object" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>ibase_fetch_object</refname>
- <refpurpose>
- Liest einen Datensatz einer InterBase-Datenbank als Objekt ein
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung:</title>
- <methodsynopsis>
- <type>object</type><methodname>ibase_fetch_object</methodname>
- <methodparam><type>int</type><parameter>result_id</parameter></methodparam>
- </methodsynopsis>
- <para>
- Liest die Daten der per <function>ibase_query</function> oder
- <function>ibase_execute</function> gewonnenen
- <parameter>result_id</parameter> in ein Pseudo-Objekt ein.
- <informalexample>
- <programlisting role="php">
-<php
- $dbh = ibase_connect ($host, $username, $password);
- $stmt = 'SELECT * FROM tblname';
- $sth = ibase_query ($dbh, $stmt);
- while ($row = ibase_fetch_object ($sth)) {
- print $row->email . "\n";
- }
- ibase_close ($dbh);
+<!-- EN-Revision: 297028 Maintainer: nobody Status: ready -->
+
+<refentry xml:id="function.ibase-fetch-object" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>ibase_fetch_object</refname>
+ <refpurpose>
+ Liest einen Datensatz einer InterBase-Datenbank als Objekt ein
+ </refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>object</type><methodname>ibase_fetch_object</methodname>
+ <methodparam><type>resource</type><parameter>result_id</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>fetch_flag</parameter><initializer>0</initializer></methodparam>
+ </methodsynopsis>
+ <para>
+ Holt eine Zeile als Pseudo-Objekt von einer gegebenen Ergebniskennung.
+ </para>
+ <para>
+ Aufeinanderfolgende Aufrufe von <function>ibase_fetch_object</function>
+ liefern die nächste Zeile der Ergebnismenge.
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>result_id</parameter></term>
+ <listitem>
+ <para>
+ Eine InterBase Ergebniskennung, die durch
+ <function>ibase_query</function> oder <function>ibase_execute</function>
+ erhalten wurde.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>fetch_flag</parameter></term>
+ <listitem>
+ <para>
+ <parameter>fetch_flag</parameter> ist eine Disjunktion der Konstanten
+ <constant>IBASE_TEXT</constant> und <constant>IBASE_UNIXTIME</constant>.
+ Die Angabe von <constant>IBASE_TEXT</constant> führt dazu, dass diese
+ Funktion BLOB-Inhalte statt BLOB-IDs zurückliefert. Die Angabe von
+ <constant>IBASE_UNIXTIME</constant> führt dazu, dass diese Funktion
+ Date/Time-Werte als Unit-Zeitstempel anstelle von formatierten
+ Zeichenketten zurückliefert.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Gibt ein Objekt mit der Information der nächsten Zeile, oder &false;, wenn es
+ keine weiteren Zeilen gibt, zurück.
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>ibase_fetch_object</function> example</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$dbh = ibase_connect($host, $username, $password);
+$stmt = 'SELECT * FROM tblname';
+$sth = ibase_query($dbh, $stmt);
+while ($row = ibase_fetch_object($sth)) {
+ echo $row->email . "\n";
+}
+ibase_close($dbh);
?>
- </programlisting>
- </informalexample>
- </para>
- <para>
- Siehe auch <function>ibase_fetch_row</function>.
- </para>
- </refsect1>
- </refentry>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>ibase_fetch_row</function></member>
+ <member><function>ibase_fetch_assoc</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml