git.infodrom.org Git - infodrom/manpages-de/blob - man3/fopen.3

   1 .\" Copyright (c) 1990, 1991 The Regents of the University of California.
   2 .\" All rights reserved.
   3 .\"
   4 .\" This code is derived from software contributed to Berkeley by
   5 .\" Chris Torek and the American National Standards Committee X3,
   6 .\" on Information Processing Systems.
   7 .\"
   8 .\" Redistribution and use in source and binary forms, with or without
   9 .\" modification, are permitted provided that the following conditions
  10 .\" are met:
  11 .\" 1. Redistributions of source code must retain the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer.
  13 .\" 2. Redistributions in binary form must reproduce the above copyright
  14 .\"    notice, this list of conditions and the following disclaimer in the
  15 .\"    documentation and/or other materials provided with the distribution.
  16 .\" 3. All advertising materials mentioning features or use of this software
  17 .\"    must display the following acknowledgement:
  18 .\"     This product includes software developed by the University of
  19 .\"     California, Berkeley and its contributors.
  20 .\" 4. Neither the name of the University nor the names of its contributors
  21 .\"    may be used to endorse or promote products derived from this software
  22 .\"    without specific prior written permission.
  23 .\"
  24 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  25 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  27 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  28 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  30 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  31 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  32 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  33 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  34 .\" SUCH DAMAGE.
  35 .\"
  36 .\"     @(#)fopen.3     6.8 (Berkeley) 6/29/91
  37 .\"
  38 .\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu
  39 .\" Translated to German Mon Jul 29 18:00:00 1996 by Patrick Rother <krd@gulu.net>
  40 .\"
  41 .TH FOPEN 3  "29. Juli 1996" "BSD" "Bibliotheksfunktionen"
  42 .SH BEZEICHNUNG
  43 fopen, fdopen, freopen \- Funktionen zum Öffnen von Streams
  44 .SH ÜBERSICHT
  45 .B #include <stdio.h>
  46 .sp
  47 .BI "FILE *fopen( char *" path ", char *" mode );
  48 .br
  49 .BI "FILE *fdopen( int " fildes ", char *" mode );
  50 .br
  51 .BI "FILE *freopen( char *" path ", char *" mode ", FILE *" stream );
  52 .SH BESCHREIBUNG
  53 Die Funktion
  54 .B fopen
  55 öffnet die Datei, dessen Name der String ist, auf den
  56 .I path
  57 zeigt, und verbindet einen Stream damit.
  58 .PP
  59 Das Argument
  60 .I mode
  61 zeigt auf einen String, der mit einer der folgenden Sequenzen beginnt
  62 (Zusätzliche Zeichen dürfen diesen Sequenzen folgen.):
  63 .TP
  64 .B r
  65 Öffne die Textdatei zum Lesen.  Der Stream wird auf den Dateianfang positioniert.
  66 .TP
  67 .B r+
  68 Öffne die Textdatei zum Lesen und Schreiben.  Der Stream wird auf den Dateianfang
  69 positioniert.
  70 .TP
  71 .B w
  72 Verkürze die Datei auf die Länge Null oder erzeuge eine Textdatei zum
  73 Schreiben.  Der Stream wird auf den Dateianfang positioniert.
  74 .TP
  75 .B w+
  76 Öffne die Datei zum Lesen und Schreiben.  Die Datei wird erzeugt, wenn sie nicht
  77 existiert, ansonsten abgeschnitten.  Der Stream wird auf den Dateianfang
  78 positioniert.
  79 .TP
  80 .B a
  81 Öffne die Datei zum Schreiben.  Die Datei wird erzeugt, wenn sie nicht existiert.
  82 Der Stream wird auf das Dateiende positioniert.
  83 .TP
  84 .B a+
  85 Öffne zum Lesen und Schreiben.  Die Datei wird erzeugt, wenn sie nicht
  86 existiert.  Der Stream wird auf das Dateiende positioniert.
  87 .PP
  88 Der String
  89 .I mode
  90 kann auch das Zeichen ``b'' enthalten, entweder als ein drittes Zeichen
  91 oder als ein Zeichen in einem der oben beschriebenen Zwei-Zeichen-Strings.
  92 Dies ist ausschließlich Aus Kompatibilitätsgründen zu ANSI
  93 C3.159-1989 (``ANSI C'') und hat keinen Effekt; das ``b'' wird
  94 ignoriert.  Linux verhält sich evtl. nicht so.
  95 .PP
  96 Jede erzeugte Datei hat den Modus
  97 .BR S_IRUSR \&| S_IWUSR \&|  S_IRGRP \&|  S_IWGRP \&| S_IROTH \&| S_IWOTH
  98 (0666), modifiziert durch den umask-Werk des Prozesses (siehe
  99 .BR umask (2).
 100 .PP
 101 Lese- und Schreibzugriffe dürfen in Schreib-/lese - Streams in jeder
 102 Reihenfolge gemischt verwendet werden und benötigen kein zwischenzeitliches
 103 seek wie in früheren Versionen von
 104 .IR stdio .
 105 Dieses Verhalten ist nicht portabel mit anderen Systemen, und muss
 106 unter Linux nicht funktionieren (irgendjemand sollte das testen und diese Manpage berichtigen);
 107 ANSI C verlangt, dass eine Dateizeiger-Positionierfunktion zwischen Aus-
 108 und Eingabe aufgerufen wird, solange nicht eine Eingabeoperation ein
 109 Dateiende vorfindet.
 110 .PP
 111 Die Funktion
 112 .B fdopen
 113 verbindet einen Stream mit einem existierenden Dateideskriptor
 114 .IR fildes .
 115 Der
 116 .I mode
 117 des Stream muss kompatibel zu dem Modus des Dateideskriptors sein.
 118 Der Dateideskriptor wird nicht ge-dup't.
 119 .PP
 120 Die Funktion
 121 .B freopen
 122 öffnet eine Datei, deren Name der String ist, auf den
 123 .I path
 124 zeigt, und verbindet den Stream, auf den
 125 .I stream
 126 zeigt, damit.  Der originale Stream (wenn er existiert) wird
 127 geschlossen.  Das Argument
 128 .I mode
 129 wird genauso wie in der Funktion
 130 .B fopen
 131 benutzt.  Der primäre Nutzen der Funktion
 132 .B freopen
 133 ist es, die Datei zu ändern, die mit einem standard Text-Stream
 134 .IR "" ( stderr ", " stdin ", oder " stdout )
 135 verbunden ist.
 136 .SH "RÜCKGABEWERT"
 137 Bei erfolgreicher Beendigung geben
 138 .BR fopen ,
 139 .B fdopen
 140 und
 141 .B freopen
 142 einen Dateideszeiger
 143 .B FILE
 144 zurück.  Anderenfalls wird
 145 .B NULL
 146 zurückgegeben und die globale Variable
 147 .I errno
 148 gesetzt um den Fehler anzuzeigen.
 149 .SH FEHLER
 150 .TP
 151 .B EINVAL
 152 Der
 153 .I mode
 154 für
 155 .BR fopen ,
 156 .BR fdopen ,
 157 oder
 158 .B freopen
 159 war ungültig.
 160 .PP
 161 Die Funktionen
 162 .BR fopen ,
 163 .B fdopen
 164 und
 165 .B freopen
 166 können auch fehlschlagen und
 167 .I errno
 168 setzen für Fehler, die für die Routine
 169 .BR malloc (3)
 170 spezifiziert sind.
 171 .PP
 172 Die Funktion
 173 .B fopen
 174 kann auch fehlschlagen und
 175 .I errno
 176 für Fehler, die für die Routine
 177 .BR open (2)
 178 spezifiziert sind, setzen.
 179 .PP
 180 Die Funktion
 181 .B fdopen
 182 kann auch fehlschlagen und
 183 .I errno
 184 für Fehler, die für die Routine
 185 .BR fcntl (2)
 186 spezifiziert sind, setzen.
 187 .PP
 188 Die Funktion
 189 .B freopen
 190 kann auch fehlschlagen und
 191 .I errno
 192 für Fehler, die für die Routinen
 193 .BR open (2),
 194 .BR fclose (3)
 195 und
 196 .BR fflush (3)
 197 spezifiziert sind, setzen.
 198 .SH "SIEHE AUCH"
 199 .BR open (2),
 200 .BR fclose (3).
 201 .SH STANDARDS
 202 Die Funktionen
 203 .B fopen
 204 und
 205 .B freopen
 206 sind konform zu ANSI C3.159-1989 (``ANSI C'').  Die Funktion
 207 .B fdopen
 208 ist konform zu IEEE Std1003.1-1988 (``POSIX'').