Freigeben über


InputStream Klasse

Dateiähnliches Objekt, das ein Eingabeblob darstellt.

Vererbung
InputStream
InputStream

Konstruktor

InputStream()

Methoden

close

Leeren und schließen Sie das E/A-Objekt.

Diese Methode hat keine Auswirkung, wenn die Datei bereits geschlossen ist.

detach

Trennen Sie diesen Puffer vom zugrunde liegenden Rohdatenstrom, und geben Sie ihn zurück.

Nachdem der Rohdatenstrom getrennt wurde, befindet sich der Puffer in einem unbrauchbaren Zustand.

fileno

Gibt den zugrunde liegenden Dateideskriptor zurück, sofern vorhanden.

OSError wird ausgelöst, wenn das E/A-Objekt keinen Dateideskriptor verwendet.

flush

Leeren Sie die Schreibpuffer, falls zutreffend.

Dies ist für schreibgeschützte und nicht blockierende Streams nicht implementiert.

isatty

Gibt zurück, ob es sich um einen "interaktiven" Stream handelt.

Gibt False zurück, wenn es nicht bestimmt werden kann.

read

Zurückgeben und Lesen von bis zu einer Größe von Bytes.

read1

Lesen und Zurückgeben von bis zu n Bytes, wobei höchstens ein read()-Aufruf des zugrunde liegenden Rohdatenstroms vorhanden ist. Ein kurzes Ergebnis bedeutet nicht, dass EOF unmittelbar bevorsteht.

Gibt ein leeres Bytes-Objekt in EOF zurück.

readable

Gibt zurück, ob das Objekt zum Lesen geöffnet wurde.

Bei False löst read() OSError aus.

readinto
readinto1
readline

Liest eine Zeile aus dem Stream und gibt sie zurück.

Wenn größe angegeben ist, werden höchstens Größenbytes gelesen.

Das Zeilenabschlusszeichen ist für Binärdateien immer b'n'; bei Textdateien kann das zu öffnende Newlines-Argument verwendet werden, um die erkannten Zeilenabschlusszeichen auszuwählen.

readlines

Gibt eine Liste von Zeilen aus dem Stream zurück.

Hinweis kann angegeben werden, um die Anzahl der gelesenen Zeilen zu steuern: Es werden keine weiteren Zeilen gelesen, wenn die Gesamtgröße (in Bytes/Zeichen) aller Bisherigen Zeilen den Hinweis überschreitet.

seek

Ändern der Streamposition.

Ändern Sie die Streamposition in den angegebenen Byteoffset. Der Offset wird relativ zur position interpretiert, die durch whence angegeben wird. Werte für whence sind:

  • 0 – Start des Datenstroms (Standard); Offset sollte null oder positiv sein

  • 1 – aktuelle Streamposition; Offset kann negativ sein

  • 2 – Ende des Datenstroms; Offset ist in der Regel negativ

Gibt die neue absolute Position zurück.

seekable

Gibt zurück, ob das Objekt den zufälligen Zugriff unterstützt.

Bei False lösen seek(), tell() und truncate() OSError aus. Diese Methode muss möglicherweise einen Test seek() durchführen.

tell

Gibt die aktuelle Streamposition zurück.

truncate

Kürzen Sie die Datei auf die Größe von Bytes.

Der Dateizeiger bleibt unverändert. Die Größe wird standardmäßig auf die aktuelle E/A-Position festgelegt, die von tell() gemeldet wird. Gibt die neue Größe zurück.

writable

Gibt zurück, ob das Objekt zum Schreiben geöffnet wurde.

Bei False löst write() OSError aus.

write

Schreiben Sie den angegebenen Puffer in den E/A-Stream.

Gibt die Anzahl der geschriebenen Bytes zurück, die immer die Länge von b in Bytes ist.

Löst BlockingIOError aus, wenn der Puffer voll ist und der zugrunde liegende Rohdatenstrom derzeit keine weiteren Daten akzeptieren kann.

writelines

Schreiben sie eine Liste von Zeilen, die gestreamt werden sollen.

Linientrennzeichen werden nicht hinzugefügt, daher ist es üblich, dass jede der bereitgestellten Zeilen ein Zeilentrennzeichen am Ende hat.

close

Leeren und schließen Sie das E/A-Objekt.

Diese Methode hat keine Auswirkung, wenn die Datei bereits geschlossen ist.

close()

detach

Trennen Sie diesen Puffer vom zugrunde liegenden Rohdatenstrom, und geben Sie ihn zurück.

Nachdem der Rohdatenstrom getrennt wurde, befindet sich der Puffer in einem unbrauchbaren Zustand.

detach()

fileno

Gibt den zugrunde liegenden Dateideskriptor zurück, sofern vorhanden.

OSError wird ausgelöst, wenn das E/A-Objekt keinen Dateideskriptor verwendet.

fileno()

flush

Leeren Sie die Schreibpuffer, falls zutreffend.

Dies ist für schreibgeschützte und nicht blockierende Streams nicht implementiert.

flush()

isatty

Gibt zurück, ob es sich um einen "interaktiven" Stream handelt.

Gibt False zurück, wenn es nicht bestimmt werden kann.

isatty()

read

Zurückgeben und Lesen von bis zu einer Größe von Bytes.

abstract read(size=-1) -> bytes

Parameter

size
int
Standardwert: -1

Die Anzahl der zu lesenden Bytes. Wenn das Argument ausgelassen wird, Noneoder negativ, werden Daten gelesen und zurückgegeben, bis EOF erreicht ist.

Gibt zurück

Aus dem Eingabedatenstrom gelesene Bytes.

read1

Lesen und Zurückgeben von bis zu n Bytes, wobei höchstens ein read()-Aufruf des zugrunde liegenden Rohdatenstroms vorhanden ist. Ein kurzes Ergebnis bedeutet nicht, dass EOF unmittelbar bevorsteht.

Gibt ein leeres Bytes-Objekt in EOF zurück.

read1()

readable

Gibt zurück, ob das Objekt zum Lesen geöffnet wurde.

Bei False löst read() OSError aus.

readable()

readinto

readinto(buffer, /)

Parameter

buffer
Erforderlich

readinto1

readinto1(buffer, /)

Parameter

buffer
Erforderlich

readline

Liest eine Zeile aus dem Stream und gibt sie zurück.

Wenn größe angegeben ist, werden höchstens Größenbytes gelesen.

Das Zeilenabschlusszeichen ist für Binärdateien immer b'n'; bei Textdateien kann das zu öffnende Newlines-Argument verwendet werden, um die erkannten Zeilenabschlusszeichen auszuwählen.

readline(size=-1, /)

Parameter

size
Standardwert: -1

readlines

Gibt eine Liste von Zeilen aus dem Stream zurück.

Hinweis kann angegeben werden, um die Anzahl der gelesenen Zeilen zu steuern: Es werden keine weiteren Zeilen gelesen, wenn die Gesamtgröße (in Bytes/Zeichen) aller Bisherigen Zeilen den Hinweis überschreitet.

readlines(hint=-1, /)

Parameter

hint
Standardwert: -1

seek

Ändern der Streamposition.

Ändern Sie die Streamposition in den angegebenen Byteoffset. Der Offset wird relativ zur position interpretiert, die durch whence angegeben wird. Werte für whence sind:

  • 0 – Start des Datenstroms (Standard); Offset sollte null oder positiv sein

  • 1 – aktuelle Streamposition; Offset kann negativ sein

  • 2 – Ende des Datenstroms; Offset ist in der Regel negativ

Gibt die neue absolute Position zurück.

seek()

seekable

Gibt zurück, ob das Objekt den zufälligen Zugriff unterstützt.

Bei False lösen seek(), tell() und truncate() OSError aus. Diese Methode muss möglicherweise einen Test seek() durchführen.

seekable()

tell

Gibt die aktuelle Streamposition zurück.

tell()

truncate

Kürzen Sie die Datei auf die Größe von Bytes.

Der Dateizeiger bleibt unverändert. Die Größe wird standardmäßig auf die aktuelle E/A-Position festgelegt, die von tell() gemeldet wird. Gibt die neue Größe zurück.

truncate()

writable

Gibt zurück, ob das Objekt zum Schreiben geöffnet wurde.

Bei False löst write() OSError aus.

writable()

write

Schreiben Sie den angegebenen Puffer in den E/A-Stream.

Gibt die Anzahl der geschriebenen Bytes zurück, die immer die Länge von b in Bytes ist.

Löst BlockingIOError aus, wenn der Puffer voll ist und der zugrunde liegende Rohdatenstrom derzeit keine weiteren Daten akzeptieren kann.

write()

writelines

Schreiben sie eine Liste von Zeilen, die gestreamt werden sollen.

Linientrennzeichen werden nicht hinzugefügt, daher ist es üblich, dass jede der bereitgestellten Zeilen ein Zeilentrennzeichen am Ende hat.

writelines(lines, /)

Parameter

lines
Erforderlich

Attribute

closed

length

name

uri