InputStream Klas

  • Referentie

Bestand-achtig object dat een invoer-blob vertegenwoordigt.

Overname
BufferedIOBase
InputStream
ABC
InputStream

Constructor

InputStream()

Methoden

close

Het IO-object leegmaken en sluiten.

Deze methode heeft geen effect als het bestand al is gesloten.
detach

Koppel deze buffer los van de onderliggende onbewerkte stroom en retourneer deze.

Nadat de onbewerkte stroom is losgekoppeld, bevindt de buffer zich in een onbruikbare status.
fileno

Retourneert onderliggende bestandsdescriptor als deze bestaat.

OSError wordt gegenereerd als het IO-object geen bestandsdescriptor gebruikt.
flush

Schrijfbuffers leegmaken, indien van toepassing.

Dit is niet geïmplementeerd voor alleen-lezen en niet-blokkerende stromen.
isatty

Geef als resultaat of dit een 'interactieve' stream is.

Retourneer Onwaar als dit niet kan worden vastgesteld.
read

Retourneren en lezen tot de grootte van bytes.
read1

Lees en retourneer maximaal n bytes, met maximaal één read()-aanroep naar de onderliggende onbewerkte stroom. Een kort resultaat betekent niet dat EOF binnenkort is bereikt.

Retourneert een leeg bytes-object op EOF.
readable

Retourneert of het object is geopend om te worden gelezen.

Indien False, zal read() OSError verhogen.
readinto
readinto1
readline

Een regel uit de stream lezen en retourneren.

Als de grootte is opgegeven, worden maximaal bytes gelezen.

Het regeleindteken is altijd b'n' voor binaire bestanden; voor tekstbestanden kan het argument newlines worden gebruikt om de herkende regeleindtekens te selecteren.
readlines

Retourneert een lijst met regels uit de stroom.

hint kan worden opgegeven om het aantal gelezen regels te bepalen: er worden geen regels meer gelezen als de totale grootte (in bytes/tekens) van alle regels tot nu toe de hint overschrijdt.
seek

De positie van de stroom wijzigen.

Wijzig de positie van de stroom in de opgegeven byte-offset. De verschuiving wordt geïnterpreteerd ten opzichte van de positie die wordt aangegeven door waarce. Waarden voor waar zijn:

  • 0 : start van de stream (de standaardwaarde); offset moet nul of positief zijn

  • 1 – huidige stroompositie; offset kan negatief zijn

  • 2 – einde van de stream; verschuiving is meestal negatief

Retourneer de nieuwe absolute positie.
seekable

Retourneert of het object ondersteuning biedt voor willekeurige toegang.

Indien False, wordt OSError weergegeven door seek(), tell() en truncate(). Deze methode moet mogelijk een test seek() uitvoeren.
tell

Huidige stroompositie retourneren.
truncate

Het bestand afkappen om de grootte van bytes te bepalen.

Bestandsaanwijzer blijft ongewijzigd. Grootte wordt standaard ingesteld op de huidige I/O-positie, zoals gerapporteerd door tell(). Retourneert de nieuwe grootte.
writable

Retourneert of het object is geopend om te schrijven.

Indien false, write() genereert OSError.
write

Schrijf de opgegeven buffer naar de IO-stroom.

Retourneert het aantal geschreven bytes, wat altijd de lengte van b in bytes is.

Genereert BlockingIOError als de buffer vol is en de onderliggende onbewerkte stroom op dit moment niet meer gegevens kan accepteren.
writelines

Schrijf een lijst met regels die moeten worden gestreamd.

Regelscheidingstekens worden niet toegevoegd, dus is het gebruikelijk dat elk van de opgegeven regels een regelscheidingsteken aan het einde heeft.

close

Het IO-object leegmaken en sluiten.

Deze methode heeft geen effect als het bestand al is gesloten.

close()

detach

Koppel deze buffer los van de onderliggende onbewerkte stroom en retourneer deze.

Nadat de onbewerkte stroom is losgekoppeld, bevindt de buffer zich in een onbruikbare status.

detach()

fileno

Retourneert onderliggende bestandsdescriptor als deze bestaat.

OSError wordt gegenereerd als het IO-object geen bestandsdescriptor gebruikt.

fileno()

flush

Schrijfbuffers leegmaken, indien van toepassing.

Dit is niet geïmplementeerd voor alleen-lezen en niet-blokkerende stromen.

flush()

isatty

Geef als resultaat of dit een 'interactieve' stream is.

Retourneer Onwaar als dit niet kan worden vastgesteld.

isatty()

read

Retourneren en lezen tot de grootte van bytes.

abstract read(size=-1) -> bytes

Parameters

size
int
standaardwaarde: -1

Het aantal bytes dat moet worden gelezen. Als het argument wordt weggelaten, Noneof negatief, worden gegevens gelezen en geretourneerd totdat EOF is bereikt.

Retouren

Bytes worden gelezen uit de invoerstroom.

read1

Lees en retourneer maximaal n bytes, met maximaal één read()-aanroep naar de onderliggende onbewerkte stroom. Een kort resultaat betekent niet dat EOF binnenkort is bereikt.

Retourneert een leeg bytes-object op EOF.

read1()

readable

Retourneert of het object is geopend om te worden gelezen.

Indien False, zal read() OSError verhogen.

readable()

readinto 

readinto(buffer, /)

Parameters

buffer
Vereist

readinto1 

readinto1(buffer, /)

Parameters

buffer
Vereist

readline

Een regel uit de stream lezen en retourneren.

Als de grootte is opgegeven, worden maximaal bytes gelezen.

Het regeleindteken is altijd b'n' voor binaire bestanden; voor tekstbestanden kan het argument newlines worden gebruikt om de herkende regeleindtekens te selecteren.

readline(size=-1, /)

Parameters

size
standaardwaarde: -1

readlines

Retourneert een lijst met regels uit de stroom.

hint kan worden opgegeven om het aantal gelezen regels te bepalen: er worden geen regels meer gelezen als de totale grootte (in bytes/tekens) van alle regels tot nu toe de hint overschrijdt.

readlines(hint=-1, /)

Parameters

hint
standaardwaarde: -1

seek

De positie van de stroom wijzigen.

Wijzig de positie van de stroom in de opgegeven byte-offset. De verschuiving wordt geïnterpreteerd ten opzichte van de positie die wordt aangegeven door waarce. Waarden voor waar zijn:

  • 0 : start van de stream (de standaardwaarde); offset moet nul of positief zijn

  • 1 – huidige stroompositie; offset kan negatief zijn

  • 2 – einde van de stream; verschuiving is meestal negatief

Retourneer de nieuwe absolute positie.

seek()

seekable

Retourneert of het object ondersteuning biedt voor willekeurige toegang.

Indien False, wordt OSError weergegeven door seek(), tell() en truncate(). Deze methode moet mogelijk een test seek() uitvoeren.

seekable()

tell

Huidige stroompositie retourneren.

tell()

truncate

Het bestand afkappen om de grootte van bytes te bepalen.

Bestandsaanwijzer blijft ongewijzigd. Grootte wordt standaard ingesteld op de huidige I/O-positie, zoals gerapporteerd door tell(). Retourneert de nieuwe grootte.

truncate()

writable

Retourneert of het object is geopend om te schrijven.

Indien false, write() genereert OSError.

writable()

write

Schrijf de opgegeven buffer naar de IO-stroom.

Retourneert het aantal geschreven bytes, wat altijd de lengte van b in bytes is.

Genereert BlockingIOError als de buffer vol is en de onderliggende onbewerkte stroom op dit moment niet meer gegevens kan accepteren.

write()

writelines

Schrijf een lijst met regels die moeten worden gestreamd.

Regelscheidingstekens worden niet toegevoegd, dus is het gebruikelijk dat elk van de opgegeven regels een regelscheidingsteken aan het einde heeft.

writelines(lines, /)

Parameters

lines
Vereist

Kenmerken

closed

length

name

uri