cvs: phpdoc-de /reference/filesystem/functions fclose.xml fgetcsv.xml fgets.xml file-exists.xml file.xml readfile.xml set-file-buffer.xml touch.xml
umask.xml
| From: | Thomas Schoefbeck | Date: | Wed, 23 Oct 2002 19:31:14 +0000 |
| Subject: | cvs: phpdoc-de /reference/filesystem/functions fclose.xml fgetcsv.xml fgets.xml file-exists.xml file.xml readfile.xml set-file-buffer.xml touch.xml umask.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-320@lists.php.net to get a copy of this message | ||
tom Wed Oct 23 15:31:14 2002 EDT
Modified files:
/phpdoc-de/reference/filesystem/functions fclose.xml fgetcsv.xml
fgets.xml file-exists.xml
file.xml readfile.xml
set-file-buffer.xml
touch.xml umask.xml
Log:
sync to en
Index: phpdoc-de/reference/filesystem/functions/fclose.xml diff -u phpdoc-de/reference/filesystem/functions/fclose.xml:1.3 phpdoc-de/reference/filesystem/functions/fclose.xml:1.4 --- phpdoc-de/reference/filesystem/functions/fclose.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/fclose.xml Wed Oct 23 15:31:14 2002 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'fclose' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <refentry id="function.fclose"> <refnamediv> <refname>fclose</refname> @@ -26,6 +23,22 @@ Der Datei-Zeiger muss gültig sein, d.h. die Datei, auf die gezeigt wird muss zuvor mit <function>fopen</function> oder <function>fsockopen</function> geöffnet worden sein. + </para> + <para> + <example> + <title>Ein einfaches Beispiel für <function>fclose</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + + $fp = fopen('somefile.txt', 'r'); + + fclose($fp); + +?> +]]> + </programlisting> + </example> </para> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/fgetcsv.xml diff -u phpdoc-de/reference/filesystem/functions/fgetcsv.xml:1.5 phpdoc-de/reference/filesystem/functions/fgetcsv.xml:1.6 --- phpdoc-de/reference/filesystem/functions/fgetcsv.xml:1.5 Sat Oct 12 10:11:33 2002 +++ phpdoc-de/reference/filesystem/functions/fgetcsv.xml Wed Oct 23 15:31:14 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.fgetcsv"> <refnamediv> <refname>fgetcsv</refname> @@ -19,18 +19,24 @@ <methodparam choice="opt"><type>string</type><parameter>enclosure</parameter></methodparam> </methodsynopsis> <simpara> - Die Funktion <function>fgetcsv</function> handelt ähnlich der - Funktion <function>fgets</function>, bis auf den Umstand, das - <function>fgetcsv</function> die eingelesene Zeile auf - Kommaseparierte Felder hin überprüft. Das Ergebnis wird als Array - zurückgegeben. Als Trennzeichen (Delimiter) wird - wenn kein - anderes Trennzeichen im dritten optionalen Parameter angegeben - wird - das Komma benutzt. Ist das enclosure Zeichen nicht spezifiert, - wird das doppelte Anführungszeichen verwendet. - <parameter>Delimiter</parameter> und <parameter>enclosure</parameter> - können nicht Null sein, und wenn sie spezifiziert sind, wird nur das - erste Zeichen verwendet. + Die Funktion <function>fgetcsv</function> ist ähnlich der Funktion + <function>fgets</function>, nur dass <function>fgetcsv</function> + die eingelesene Zeile auf Felder im <acronym>CSV</acronym> Format + (kommaseparierte Felder) hin überprüft, und ein Array mit den + gelesenen Feldern zurückgibt. Ist der optionale dritte Parameter + <parameter>delimiter</parameter> (Trennzeichen) nicht angegeben, + wird standardmäßig das Komma benutzt. Der optionale Parameter + <parameter>enclosure</parameter> ist auf ein Zeichen limitiert + und darf nicht <type>null</type> sein. Enthält + <parameter>enclosure</parameter> mehr als ein Zeichen, wird nur + das erste verwendet. </simpara> + <note> + <simpara> + Der Parameter <parameter>enclosure</parameter> wurde in PHP 4.3.0 + eingeführt. + </simpara> + </note> <simpara> Der Dateizeiger <parameter>fp</parameter> muss gültig sein, d.h. die Datei, auf die gezeigt wird, muss zuvor mit @@ -52,35 +58,38 @@ den Wert &null; hält zurückgegeben. Sie wird nicht als Fehler behandelt. </simpara> - <simpara> - <parameter>enclosure</parameter> wurde in PHP 4.3.0 eingeführt. - </simpara> </note> - <example> - <title> - <function>fgetcsv</function> Beispiel - Lesen und Ausgabe des - Inhalts einer CSV-Datei - </title> - <programlisting role="php"> + <para> + <example> + <title> + Lesen und Ausgeben des gesamten Inhalts einer CSV-Datei + </title> + <programlisting role="php"> <![CDATA[ +<?php $row = 1; // Anzahl der Arrays -$fp = fopen ("test.csv","r"); // Datei wird zum Lesen - // geöffnet -while ($data = fgetcsv ($fp, 1000, ",")) { // Daten werden aus der Datei - // in einen Array $data gelesen - $num = count ($data); // Felder im Array $data - // werden gezählt - print "<p> $num fields in line $row: <br>"; +$fp = fopen ("test.csv","r"); // Datei wird zum Lesen geöffnet +while ($data = fgetcsv ($fp, 1000, ",")) { // Daten werden aus der Datei in + // ein Array $data gelesen + $num = count ($data); // Felder im Array $data werden + // gezählt + print "<p> $num fields in line $row: <br>\n"; $row++; // Anzahl der Arrays wird // inkrementiert for ($c=0; $c < $num; $c++) { // FOR-Schleife, um Felder - print $data[$c] . "<br>"; // des Arrays auszugeben + print $data[$c] . "<br>\n"; // des Arrays auszugeben } } fclose ($fp); +?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + <para> + Siehe auch <function>explode</function>, <function>file</function> + und <function>pack</function>. + </para> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/fgets.xml diff -u phpdoc-de/reference/filesystem/functions/fgets.xml:1.4 phpdoc-de/reference/filesystem/functions/fgets.xml:1.5 --- phpdoc-de/reference/filesystem/functions/fgets.xml:1.4 Sat Oct 12 10:11:33 2002 +++ phpdoc-de/reference/filesystem/functions/fgets.xml Wed Oct 23 15:31:14 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> <refentry id="function.fgets"> <refnamediv> <refname>fgets</refname> @@ -59,14 +59,26 @@ </para> <note> <simpara> - Der Parameter <parameter>length</parameter> wurde erst ab PHP 4.2.0 optional. + Der Parameter <parameter>length</parameter> wurde in PHP 4.2.0 + optional. Ist er nicht angegeben, wird als Zeilenlänge 1024 + angenommen. Seit PHP 4.3 wird bei einem fehlenden Parameter + <parameter>length</parameter> so lange gelesen, bis das Ende der + Zeile erreicht ist. Ist der Großteil der Zeilen in der Datei + größer als 8 kB, ist es effizienter, wenn Sie die maximale + Zeilenlänge spezifizieren. + </simpara> + </note> + <note> + <simpara> + Diese Funktion ist seit PHP 4.3 "binary safe", was aus frühere + Versionen nicht zutrifft. </simpara> </note> ¬e.line-endings; <para> Siehe auch <function>fread</function>, <function>fopen</function>, <function>popen</function>, <function>fgetc</function>, - <function>fsockopen</function>, und + <function>fsockopen</function> und <function>socket_set_timeout</function>. </para> </refsect1> Index: phpdoc-de/reference/filesystem/functions/file-exists.xml diff -u phpdoc-de/reference/filesystem/functions/file-exists.xml:1.4 phpdoc-de/reference/filesystem/functions/file-exists.xml:1.5 --- phpdoc-de/reference/filesystem/functions/file-exists.xml:1.4 Sat Oct 12 10:11:33 2002 +++ phpdoc-de/reference/filesystem/functions/file-exists.xml Wed Oct 23 15:31:14 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> <refentry id="function.file-exists"> <refnamediv> <refname>file_exists</refname> @@ -17,8 +17,9 @@ spezifizierte Datei existiert, andernfalls &false;. </simpara> <simpara> - <function>file_exists</function> funktioniert nur mit lokalen - Dateien. Die Datei, deren Existenz überprüft werden soll muss + Diese Funktion funktioniert nicht bei <link + linkend="features.remote-files">entfernten Dateien</link>; + Die Datei, deren Existenz überprüft werden soll, muss über das Dateisystem des Servers erreichbar sein. </simpara> <simpara> @@ -26,11 +27,36 @@ Siehe <function>clearstatcache</function> für weitere Einzelheiten. </simpara> - <simpara> - Unter Windows verwenden Sie bitte "//computername/share/filename" - oder "\\\\computername\share\filename", um Dateien im Netzwerk zu - prüfen. - </simpara> + <note> + <title>Verwenden von Windows shares</title> + <para> + Zum Prüfen von Dateien auf Windows shares verwenden Sie bitte + <filename>//computername/share/filename</filename> oder + <filename>\\\\computername\share\filename</filename>. + </para> + </note> + <para> + <example> + <title>Testen, ob eine Datei existiert</title> + <programlisting role="php"> +<![CDATA[ +<?php +$filename = '/path/to/foo.txt'; + +if (file_exists($filename)) { + print "The file $filename exists"; +} else { + print "The file $filename does not exist"; +} +?> +]]> + </programlisting> + </example> + </para> + <para> + Siehe auch <function>is_readable</function>, <function>is_writable</function>, + <function>is_file</function> und <function>file</function>. + </para> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/file.xml diff -u phpdoc-de/reference/filesystem/functions/file.xml:1.5 phpdoc-de/reference/filesystem/functions/file.xml:1.6 --- phpdoc-de/reference/filesystem/functions/file.xml:1.5 Fri Oct 18 16:51:01 2002 +++ phpdoc-de/reference/filesystem/functions/file.xml Wed Oct 23 15:31:14 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.file"> <refnamediv> <refname>file</refname> @@ -40,14 +40,18 @@ <programlisting role="php"> <![CDATA[ <?php -// liest eine Webseite in einen Array und gibt das Ergebnis aus -$fcontents = file ('http://www.example.com/'); -while (list ($line_num, $line) = each ($fcontents)) { - echo "<b>Line $line_num:</b>; ", htmlspecialchars ($line), "<br>\n"; +// Liest eine Datei in ein Array. Hier gehen wir über HTTP, um die +// HTML Datei einer URL zu bekommen +$lines = file ('http://www.example.com/'); + +// Durchgehen des Arrays und Anzeigen des HTML Source inkl. Zeilennummern +foreach ($lines as $line_num => $line) { + echo "Line #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br>\n"; } -// liefert eine Webseite in einen String -$fcontents = implode ('', file ('http://www.example.com/')); +// Ein anderes Beispiel: Einlesen einer Webseite in einen String. +// Siehe auch file_get_contents(). +$html = implode ('', file ('http://www.example.com/')); ?> ]]> </programlisting> @@ -56,17 +60,18 @@ <note> <para> Ab PHP 4.3.0 können Sie <function>file_get_contents</function> - verwenden, um den Inhalt einer Datei als einen String zu bekommen. + verwenden, um den Inhalt einer Datei als String zurückzugeben. </para> <para> - Mit PHP 4.3.0 ist <function>file</function> Binary Safe. + Mit PHP 4.3.0 ist <function>file</function> "Binary Safe". </para> </note> &tip.fopen-wrapper; <para> Siehe auch <function>readfile</function>, - <function>fopen</function>, <function>fsockopen</function> und - <function>popen</function>. + <function>fopen</function>, <function>fsockopen</function>, + <function>popen</function>, <function>file_get_contents</function> + und <function>include</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/readfile.xml diff -u phpdoc-de/reference/filesystem/functions/readfile.xml:1.4 phpdoc-de/reference/filesystem/functions/readfile.xml:1.5 --- phpdoc-de/reference/filesystem/functions/readfile.xml:1.4 Mon Aug 26 08:41:26 2002 +++ phpdoc-de/reference/filesystem/functions/readfile.xml Wed Oct 23 15:31:14 2002 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'readfile' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.2 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <refentry id="function.readfile"> <refnamediv> <refname>readfile</refname> @@ -17,49 +14,26 @@ <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> </methodsynopsis> <para> - Liest den Inhalt einer Datei und gibt ihn an der Standardausgabe - (Browser) aus. + Liest den Inhalt einer Datei und schreibt ihn in den Ausgabepuffer. </para> <para> - Gibt die Anzahl der Bytes einer Datei zurück. Wenn ein Fehler + Gibt die Anzahl der gelesenen Bytes einer Datei zurück. Wenn ein Fehler auftritt wird &false; zurückgegeben und eine Fehlermeldung wird auf der Standardausgabe ausgegeben. Die Ausgabe einer Fehlermeldung kann durch Voranstellen eines '@' verhindert werden (@readfile). </para> - <para> - Wenn <parameter>filename</parameter> mit "http://" (nicht case - sensitive) beginnt, wird eine HTTP 1.0 Verbindung zu dem - spezifiziertem Server hergestellt und der Text der Antwort wird auf - die Standardausgabe geschrieben. - </para> - <para> - In älteren Versionen als PHP 4.0.5 werden Weiterleitungen (HTTP - Redirects) nicht unterstützt, hier muss die Datei daher vollständig - und mit abschließendem "/" beschrieben werden. - </para> - <para> - Wenn <parameter>filename</parameter> mit "ftp://" (nicht case - sensitive) beginnt, wird eine FTP Verbindung zu dem - spezifiziertem Server hergestellt und die angeforderte Datei wird - auf der Standardausgabe ausgegeben. Wenn der Server keinen - passiven Mode unterstützt, schlägt diese Funktion fehl. - </para> - <para> - Wenn <parameter>filename</parameter> mit keiner dieser - Zeichenketten beginnt, wird die Datei vom lokalen Dateisystem - geöffnet und ihr Inhalt auf der Standardausgabe ausgegeben. - </para> + &tip.fopen-wrapper; <para> Sie können optional den zweiten Parameter benutzen und diesen auf '1' setzen, wenn Sie auch im <link - linkend="ini.include-path"> include_path</link> nach der Datei + linkend="ini.include-path">include_path</link> nach der Datei suchen möchten. </para> <para> Siehe auch <function>fpassthru</function>, <function>file</function>, <function>fopen</function>, - <function>include</function>, <function>require</function> und - <function>virtual</function>. + <function>include</function>, <function>require</function>, + <function>virtual</function> und <xref linkend="wrappers"/>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/set-file-buffer.xml diff -u phpdoc-de/reference/filesystem/functions/set-file-buffer.xml:1.3 phpdoc-de/reference/filesystem/functions/set-file-buffer.xml:1.4 --- phpdoc-de/reference/filesystem/functions/set-file-buffer.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/set-file-buffer.xml Wed Oct 23 15:31:14 2002 @@ -1,60 +1,16 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'set-file-buffer' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <refentry id="function.set-file-buffer"> <refnamediv> <refname>set_file_buffer</refname> - <refpurpose> - Setzt die Dateipufferung für einen gegebenen Dateizeiger - </refpurpose> + <refpurpose>Alias für <function>stream_set_write_buffer</function></refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>set_file_buffer</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - <methodparam><type>int</type><parameter>buffer</parameter></methodparam> - </methodsynopsis> <simpara> - Eine Ausgabe mittels <function>fwrite</function> wird normalerweise - mit 8k gepuffert. Das heißt, dass wenn zwei Prozesse in den gleichen - Output Stream (eine Datei) schreiben wollen, jeder nach 8k Daten - unterbrochen wird, um den anderen schreiben zu lassen. - <function>set_file_buffer</function> setzt die Pufferung für - Schreiboperationen des gegebenen Dateizeigers - <parameter>fp</parameter> auf <parameter>buffer</parameter> - Bytes. Wenn <parameter>buffer</parameter> 0 ist, erfolgen die - Schreiboperationen ungepuffert. Dies stellt sicher, dass alle - Schreiboperationen mit <function>fwrite</function> abgeschlossen - werden, bevor andere Prozesse in diesen Output Stream schreiben können. - </simpara> - <simpara> - Die Funktion gibt bei Erfolg 0, oder EOF wenn die Anfrage nicht - erfolgreich war, zurück. - </simpara> - <para> - Das folgende Beispiel zeigt, wie man mittels - <function>set_file_buffer</function> einen ungepufferten Stream - generiert. - <example> - <title><function>set_file_buffer</function></title> - <programlisting role="php"> -<![CDATA[ -$fp=fopen($file, "w"); -if($fp){ - set_file_buffer($fp, 0); - fputs($fp, $output); - fclose($fp); -} -]]> - </programlisting> - </example> - </para> - <simpara> - Siehe auch <function>fopen</function>, <function>fwrite</function>. + Diese Funktion ist ein Alias für + <function>stream_set_write_buffer</function>. </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/touch.xml diff -u phpdoc-de/reference/filesystem/functions/touch.xml:1.5 phpdoc-de/reference/filesystem/functions/touch.xml:1.6 --- phpdoc-de/reference/filesystem/functions/touch.xml:1.5 Mon Sep 23 11:09:09 2002 +++ phpdoc-de/reference/filesystem/functions/touch.xml Wed Oct 23 15:31:14 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> <refentry id="function.touch"> <refnamediv> <refname>touch</refname> @@ -24,8 +24,9 @@ Zeit benutzt. Dies ist äquivalent zu dem, was utime tut (manchmal wird auch als utimes davon gesprochen). Ist die dritte Option <parameter>atime</parameter> angegeben, so wird die Zugriffszeit - auf <parameter>atime</parameter> gesetzt. Die Zugriffszeit wird - stets modifiziert, unabhängig von der Anzahl der Parameter. + auf <parameter>atime</parameter> gesetzt. Beachten Sie, dass die + Zugriffszeit unabhängig von der Anzahl der Parameter stets modifiziert + wird. </para> <para> Wenn die Datei nicht existiert, wird sie erzeugt. Index: phpdoc-de/reference/filesystem/functions/umask.xml diff -u phpdoc-de/reference/filesystem/functions/umask.xml:1.4 phpdoc-de/reference/filesystem/functions/umask.xml:1.5 --- phpdoc-de/reference/filesystem/functions/umask.xml:1.4 Sat Oct 19 06:05:12 2002 +++ phpdoc-de/reference/filesystem/functions/umask.xml Wed Oct 23 15:31:14 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> <refentry id="function.umask"> <refnamediv> <refname>umask</refname> @@ -12,12 +12,12 @@ <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>umask</methodname> - <methodparam><type>int</type><parameter>mask</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>mask</parameter></methodparam> </methodsynopsis> <para> <function>umask</function> setzt PHP's umask auf <parameter>mask</parameter> & 0777 und gibt die alte umask - zurück. Wenn PHP als Servermodul benutzt wird, wird die umask + zurück. Wird PHP als Servermodul benutzt, wird die umask zurückgespeichert wenn die jeweilige Anfrage beendet ist. </para> <para>
Index: phpdoc-de/reference/filesystem/functions/fclose.xml diff -u phpdoc-de/reference/filesystem/functions/fclose.xml:1.3 phpdoc-de/reference/filesystem/functions/fclose.xml:1.4 --- phpdoc-de/reference/filesystem/functions/fclose.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/fclose.xml Wed Oct 23 15:31:14 2002 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'fclose' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <refentry id="function.fclose"> <refnamediv> <refname>fclose</refname> @@ -26,6 +23,22 @@ Der Datei-Zeiger muss gültig sein, d.h. die Datei, auf die gezeigt wird muss zuvor mit <function>fopen</function> oder <function>fsockopen</function> geöffnet worden sein. + </para> + <para> + <example> + <title>Ein einfaches Beispiel für <function>fclose</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + + $fp = fopen('somefile.txt', 'r'); + + fclose($fp); + +?> +]]> + </programlisting> + </example> </para> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/fgetcsv.xml diff -u phpdoc-de/reference/filesystem/functions/fgetcsv.xml:1.5 phpdoc-de/reference/filesystem/functions/fgetcsv.xml:1.6 --- phpdoc-de/reference/filesystem/functions/fgetcsv.xml:1.5 Sat Oct 12 10:11:33 2002 +++ phpdoc-de/reference/filesystem/functions/fgetcsv.xml Wed Oct 23 15:31:14 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.fgetcsv"> <refnamediv> <refname>fgetcsv</refname> @@ -19,18 +19,24 @@ <methodparam choice="opt"><type>string</type><parameter>enclosure</parameter></methodparam> </methodsynopsis> <simpara> - Die Funktion <function>fgetcsv</function> handelt ähnlich der - Funktion <function>fgets</function>, bis auf den Umstand, das - <function>fgetcsv</function> die eingelesene Zeile auf - Kommaseparierte Felder hin überprüft. Das Ergebnis wird als Array - zurückgegeben. Als Trennzeichen (Delimiter) wird - wenn kein - anderes Trennzeichen im dritten optionalen Parameter angegeben - wird - das Komma benutzt. Ist das enclosure Zeichen nicht spezifiert, - wird das doppelte Anführungszeichen verwendet. - <parameter>Delimiter</parameter> und <parameter>enclosure</parameter> - können nicht Null sein, und wenn sie spezifiziert sind, wird nur das - erste Zeichen verwendet. + Die Funktion <function>fgetcsv</function> ist ähnlich der Funktion + <function>fgets</function>, nur dass <function>fgetcsv</function> + die eingelesene Zeile auf Felder im <acronym>CSV</acronym> Format + (kommaseparierte Felder) hin überprüft, und ein Array mit den + gelesenen Feldern zurückgibt. Ist der optionale dritte Parameter + <parameter>delimiter</parameter> (Trennzeichen) nicht angegeben, + wird standardmäßig das Komma benutzt. Der optionale Parameter + <parameter>enclosure</parameter> ist auf ein Zeichen limitiert + und darf nicht <type>null</type> sein. Enthält + <parameter>enclosure</parameter> mehr als ein Zeichen, wird nur + das erste verwendet. </simpara> + <note> + <simpara> + Der Parameter <parameter>enclosure</parameter> wurde in PHP 4.3.0 + eingeführt. + </simpara> + </note> <simpara> Der Dateizeiger <parameter>fp</parameter> muss gültig sein, d.h. die Datei, auf die gezeigt wird, muss zuvor mit @@ -52,35 +58,38 @@ den Wert &null; hält zurückgegeben. Sie wird nicht als Fehler behandelt. </simpara> - <simpara> - <parameter>enclosure</parameter> wurde in PHP 4.3.0 eingeführt. - </simpara> </note> - <example> - <title> - <function>fgetcsv</function> Beispiel - Lesen und Ausgabe des - Inhalts einer CSV-Datei - </title> - <programlisting role="php"> + <para> + <example> + <title> + Lesen und Ausgeben des gesamten Inhalts einer CSV-Datei + </title> + <programlisting role="php"> <![CDATA[ +<?php $row = 1; // Anzahl der Arrays -$fp = fopen ("test.csv","r"); // Datei wird zum Lesen - // geöffnet -while ($data = fgetcsv ($fp, 1000, ",")) { // Daten werden aus der Datei - // in einen Array $data gelesen - $num = count ($data); // Felder im Array $data - // werden gezählt - print "<p> $num fields in line $row: <br>"; +$fp = fopen ("test.csv","r"); // Datei wird zum Lesen geöffnet +while ($data = fgetcsv ($fp, 1000, ",")) { // Daten werden aus der Datei in + // ein Array $data gelesen + $num = count ($data); // Felder im Array $data werden + // gezählt + print "<p> $num fields in line $row: <br>\n"; $row++; // Anzahl der Arrays wird // inkrementiert for ($c=0; $c < $num; $c++) { // FOR-Schleife, um Felder - print $data[$c] . "<br>"; // des Arrays auszugeben + print $data[$c] . "<br>\n"; // des Arrays auszugeben } } fclose ($fp); +?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + <para> + Siehe auch <function>explode</function>, <function>file</function> + und <function>pack</function>. + </para> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/fgets.xml diff -u phpdoc-de/reference/filesystem/functions/fgets.xml:1.4 phpdoc-de/reference/filesystem/functions/fgets.xml:1.5 --- phpdoc-de/reference/filesystem/functions/fgets.xml:1.4 Sat Oct 12 10:11:33 2002 +++ phpdoc-de/reference/filesystem/functions/fgets.xml Wed Oct 23 15:31:14 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> <refentry id="function.fgets"> <refnamediv> <refname>fgets</refname> @@ -59,14 +59,26 @@ </para> <note> <simpara> - Der Parameter <parameter>length</parameter> wurde erst ab PHP 4.2.0 optional. + Der Parameter <parameter>length</parameter> wurde in PHP 4.2.0 + optional. Ist er nicht angegeben, wird als Zeilenlänge 1024 + angenommen. Seit PHP 4.3 wird bei einem fehlenden Parameter + <parameter>length</parameter> so lange gelesen, bis das Ende der + Zeile erreicht ist. Ist der Großteil der Zeilen in der Datei + größer als 8 kB, ist es effizienter, wenn Sie die maximale + Zeilenlänge spezifizieren. + </simpara> + </note> + <note> + <simpara> + Diese Funktion ist seit PHP 4.3 "binary safe", was aus frühere + Versionen nicht zutrifft. </simpara> </note> ¬e.line-endings; <para> Siehe auch <function>fread</function>, <function>fopen</function>, <function>popen</function>, <function>fgetc</function>, - <function>fsockopen</function>, und + <function>fsockopen</function> und <function>socket_set_timeout</function>. </para> </refsect1> Index: phpdoc-de/reference/filesystem/functions/file-exists.xml diff -u phpdoc-de/reference/filesystem/functions/file-exists.xml:1.4 phpdoc-de/reference/filesystem/functions/file-exists.xml:1.5 --- phpdoc-de/reference/filesystem/functions/file-exists.xml:1.4 Sat Oct 12 10:11:33 2002 +++ phpdoc-de/reference/filesystem/functions/file-exists.xml Wed Oct 23 15:31:14 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> <refentry id="function.file-exists"> <refnamediv> <refname>file_exists</refname> @@ -17,8 +17,9 @@ spezifizierte Datei existiert, andernfalls &false;. </simpara> <simpara> - <function>file_exists</function> funktioniert nur mit lokalen - Dateien. Die Datei, deren Existenz überprüft werden soll muss + Diese Funktion funktioniert nicht bei <link + linkend="features.remote-files">entfernten Dateien</link>; + Die Datei, deren Existenz überprüft werden soll, muss über das Dateisystem des Servers erreichbar sein. </simpara> <simpara> @@ -26,11 +27,36 @@ Siehe <function>clearstatcache</function> für weitere Einzelheiten. </simpara> - <simpara> - Unter Windows verwenden Sie bitte "//computername/share/filename" - oder "\\\\computername\share\filename", um Dateien im Netzwerk zu - prüfen. - </simpara> + <note> + <title>Verwenden von Windows shares</title> + <para> + Zum Prüfen von Dateien auf Windows shares verwenden Sie bitte + <filename>//computername/share/filename</filename> oder + <filename>\\\\computername\share\filename</filename>. + </para> + </note> + <para> + <example> + <title>Testen, ob eine Datei existiert</title> + <programlisting role="php"> +<![CDATA[ +<?php +$filename = '/path/to/foo.txt'; + +if (file_exists($filename)) { + print "The file $filename exists"; +} else { + print "The file $filename does not exist"; +} +?> +]]> + </programlisting> + </example> + </para> + <para> + Siehe auch <function>is_readable</function>, <function>is_writable</function>, + <function>is_file</function> und <function>file</function>. + </para> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/file.xml diff -u phpdoc-de/reference/filesystem/functions/file.xml:1.5 phpdoc-de/reference/filesystem/functions/file.xml:1.6 --- phpdoc-de/reference/filesystem/functions/file.xml:1.5 Fri Oct 18 16:51:01 2002 +++ phpdoc-de/reference/filesystem/functions/file.xml Wed Oct 23 15:31:14 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.file"> <refnamediv> <refname>file</refname> @@ -40,14 +40,18 @@ <programlisting role="php"> <![CDATA[ <?php -// liest eine Webseite in einen Array und gibt das Ergebnis aus -$fcontents = file ('http://www.example.com/'); -while (list ($line_num, $line) = each ($fcontents)) { - echo "<b>Line $line_num:</b>; ", htmlspecialchars ($line), "<br>\n"; +// Liest eine Datei in ein Array. Hier gehen wir über HTTP, um die +// HTML Datei einer URL zu bekommen +$lines = file ('http://www.example.com/'); + +// Durchgehen des Arrays und Anzeigen des HTML Source inkl. Zeilennummern +foreach ($lines as $line_num => $line) { + echo "Line #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br>\n"; } -// liefert eine Webseite in einen String -$fcontents = implode ('', file ('http://www.example.com/')); +// Ein anderes Beispiel: Einlesen einer Webseite in einen String. +// Siehe auch file_get_contents(). +$html = implode ('', file ('http://www.example.com/')); ?> ]]> </programlisting> @@ -56,17 +60,18 @@ <note> <para> Ab PHP 4.3.0 können Sie <function>file_get_contents</function> - verwenden, um den Inhalt einer Datei als einen String zu bekommen. + verwenden, um den Inhalt einer Datei als String zurückzugeben. </para> <para> - Mit PHP 4.3.0 ist <function>file</function> Binary Safe. + Mit PHP 4.3.0 ist <function>file</function> "Binary Safe". </para> </note> &tip.fopen-wrapper; <para> Siehe auch <function>readfile</function>, - <function>fopen</function>, <function>fsockopen</function> und - <function>popen</function>. + <function>fopen</function>, <function>fsockopen</function>, + <function>popen</function>, <function>file_get_contents</function> + und <function>include</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/readfile.xml diff -u phpdoc-de/reference/filesystem/functions/readfile.xml:1.4 phpdoc-de/reference/filesystem/functions/readfile.xml:1.5 --- phpdoc-de/reference/filesystem/functions/readfile.xml:1.4 Mon Aug 26 08:41:26 2002 +++ phpdoc-de/reference/filesystem/functions/readfile.xml Wed Oct 23 15:31:14 2002 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'readfile' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.2 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <refentry id="function.readfile"> <refnamediv> <refname>readfile</refname> @@ -17,49 +14,26 @@ <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> </methodsynopsis> <para> - Liest den Inhalt einer Datei und gibt ihn an der Standardausgabe - (Browser) aus. + Liest den Inhalt einer Datei und schreibt ihn in den Ausgabepuffer. </para> <para> - Gibt die Anzahl der Bytes einer Datei zurück. Wenn ein Fehler + Gibt die Anzahl der gelesenen Bytes einer Datei zurück. Wenn ein Fehler auftritt wird &false; zurückgegeben und eine Fehlermeldung wird auf der Standardausgabe ausgegeben. Die Ausgabe einer Fehlermeldung kann durch Voranstellen eines '@' verhindert werden (@readfile). </para> - <para> - Wenn <parameter>filename</parameter> mit "http://" (nicht case - sensitive) beginnt, wird eine HTTP 1.0 Verbindung zu dem - spezifiziertem Server hergestellt und der Text der Antwort wird auf - die Standardausgabe geschrieben. - </para> - <para> - In älteren Versionen als PHP 4.0.5 werden Weiterleitungen (HTTP - Redirects) nicht unterstützt, hier muss die Datei daher vollständig - und mit abschließendem "/" beschrieben werden. - </para> - <para> - Wenn <parameter>filename</parameter> mit "ftp://" (nicht case - sensitive) beginnt, wird eine FTP Verbindung zu dem - spezifiziertem Server hergestellt und die angeforderte Datei wird - auf der Standardausgabe ausgegeben. Wenn der Server keinen - passiven Mode unterstützt, schlägt diese Funktion fehl. - </para> - <para> - Wenn <parameter>filename</parameter> mit keiner dieser - Zeichenketten beginnt, wird die Datei vom lokalen Dateisystem - geöffnet und ihr Inhalt auf der Standardausgabe ausgegeben. - </para> + &tip.fopen-wrapper; <para> Sie können optional den zweiten Parameter benutzen und diesen auf '1' setzen, wenn Sie auch im <link - linkend="ini.include-path"> include_path</link> nach der Datei + linkend="ini.include-path">include_path</link> nach der Datei suchen möchten. </para> <para> Siehe auch <function>fpassthru</function>, <function>file</function>, <function>fopen</function>, - <function>include</function>, <function>require</function> und - <function>virtual</function>. + <function>include</function>, <function>require</function>, + <function>virtual</function> und <xref linkend="wrappers"/>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/set-file-buffer.xml diff -u phpdoc-de/reference/filesystem/functions/set-file-buffer.xml:1.3 phpdoc-de/reference/filesystem/functions/set-file-buffer.xml:1.4 --- phpdoc-de/reference/filesystem/functions/set-file-buffer.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/set-file-buffer.xml Wed Oct 23 15:31:14 2002 @@ -1,60 +1,16 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'set-file-buffer' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <refentry id="function.set-file-buffer"> <refnamediv> <refname>set_file_buffer</refname> - <refpurpose> - Setzt die Dateipufferung für einen gegebenen Dateizeiger - </refpurpose> + <refpurpose>Alias für <function>stream_set_write_buffer</function></refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>set_file_buffer</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - <methodparam><type>int</type><parameter>buffer</parameter></methodparam> - </methodsynopsis> <simpara> - Eine Ausgabe mittels <function>fwrite</function> wird normalerweise - mit 8k gepuffert. Das heißt, dass wenn zwei Prozesse in den gleichen - Output Stream (eine Datei) schreiben wollen, jeder nach 8k Daten - unterbrochen wird, um den anderen schreiben zu lassen. - <function>set_file_buffer</function> setzt die Pufferung für - Schreiboperationen des gegebenen Dateizeigers - <parameter>fp</parameter> auf <parameter>buffer</parameter> - Bytes. Wenn <parameter>buffer</parameter> 0 ist, erfolgen die - Schreiboperationen ungepuffert. Dies stellt sicher, dass alle - Schreiboperationen mit <function>fwrite</function> abgeschlossen - werden, bevor andere Prozesse in diesen Output Stream schreiben können. - </simpara> - <simpara> - Die Funktion gibt bei Erfolg 0, oder EOF wenn die Anfrage nicht - erfolgreich war, zurück. - </simpara> - <para> - Das folgende Beispiel zeigt, wie man mittels - <function>set_file_buffer</function> einen ungepufferten Stream - generiert. - <example> - <title><function>set_file_buffer</function></title> - <programlisting role="php"> -<![CDATA[ -$fp=fopen($file, "w"); -if($fp){ - set_file_buffer($fp, 0); - fputs($fp, $output); - fclose($fp); -} -]]> - </programlisting> - </example> - </para> - <simpara> - Siehe auch <function>fopen</function>, <function>fwrite</function>. + Diese Funktion ist ein Alias für + <function>stream_set_write_buffer</function>. </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/touch.xml diff -u phpdoc-de/reference/filesystem/functions/touch.xml:1.5 phpdoc-de/reference/filesystem/functions/touch.xml:1.6 --- phpdoc-de/reference/filesystem/functions/touch.xml:1.5 Mon Sep 23 11:09:09 2002 +++ phpdoc-de/reference/filesystem/functions/touch.xml Wed Oct 23 15:31:14 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> <refentry id="function.touch"> <refnamediv> <refname>touch</refname> @@ -24,8 +24,9 @@ Zeit benutzt. Dies ist äquivalent zu dem, was utime tut (manchmal wird auch als utimes davon gesprochen). Ist die dritte Option <parameter>atime</parameter> angegeben, so wird die Zugriffszeit - auf <parameter>atime</parameter> gesetzt. Die Zugriffszeit wird - stets modifiziert, unabhängig von der Anzahl der Parameter. + auf <parameter>atime</parameter> gesetzt. Beachten Sie, dass die + Zugriffszeit unabhängig von der Anzahl der Parameter stets modifiziert + wird. </para> <para> Wenn die Datei nicht existiert, wird sie erzeugt. Index: phpdoc-de/reference/filesystem/functions/umask.xml diff -u phpdoc-de/reference/filesystem/functions/umask.xml:1.4 phpdoc-de/reference/filesystem/functions/umask.xml:1.5 --- phpdoc-de/reference/filesystem/functions/umask.xml:1.4 Sat Oct 19 06:05:12 2002 +++ phpdoc-de/reference/filesystem/functions/umask.xml Wed Oct 23 15:31:14 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> <refentry id="function.umask"> <refnamediv> <refname>umask</refname> @@ -12,12 +12,12 @@ <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>umask</methodname> - <methodparam><type>int</type><parameter>mask</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>mask</parameter></methodparam> </methodsynopsis> <para> <function>umask</function> setzt PHP's umask auf <parameter>mask</parameter> & 0777 und gibt die alte umask - zurück. Wenn PHP als Servermodul benutzt wird, wird die umask + zurück. Wird PHP als Servermodul benutzt, wird die umask zurückgespeichert wenn die jeweilige Anfrage beendet ist. </para> <para>