Condividi tramite


InputStream Classe

Oggetto simile a un file che rappresenta un BLOB di input.

Ereditarietà
InputStream
InputStream

Costruttore

InputStream()

Metodi

close

Svuotare e chiudere l'oggetto I/O.

Questo metodo non ha alcun effetto se il file è già chiuso.

detach

Disconnettere questo buffer dal flusso non elaborato sottostante e restituirlo.

Dopo che il flusso non elaborato è stato scollegato, il buffer è in uno stato inutilizzabile.

fileno

Restituisce il descrittore di file sottostante, se presente.

OSError viene generato se l'oggetto I/O non usa un descrittore di file.

flush

Scarica buffer di scrittura, se applicabile.

Questa operazione non viene implementata per i flussi di sola lettura e non di blocco.

isatty

Restituisce un valore che indica se si tratta di un flusso "interattivo".

Restituisce False se non può essere determinato.

read

Restituisce e legge fino alle dimensioni dei byte.

read1

Leggere e restituire fino a n byte, con al massimo una chiamata read() al flusso non elaborato sottostante. Un breve risultato non implica che EOF sia imminente.

Restituisce un oggetto byte vuoto in EOF.

readable

Restituisce un valore che indica se l'oggetto è stato aperto per la lettura.

Se False, read() genererà OSError.

readinto
readinto1
readline

Leggere e restituire una riga dal flusso.

Se viene specificata la dimensione, verranno letti al massimo i byte delle dimensioni.

Il terminatore di riga è sempre b'n' per i file binari; per i file di testo, l'argomento newlines da aprire può essere usato per selezionare i caratteri di terminazione riga riconosciuti.

readlines

Restituisce un elenco di righe dal flusso.

È possibile specificare hint per controllare il numero di righe lette: non verranno lette altre righe se le dimensioni totali (in byte/caratteri) di tutte le righe finora superano l'hint.

seek

Modificare la posizione del flusso.

Modificare la posizione del flusso impostando l'offset di byte specificato. L'offset viene interpretato rispetto alla posizione indicata da whence. I valori di whence sono:

  • 0 : inizio del flusso (impostazione predefinita); offset deve essere zero o positivo

  • 1 – posizione corrente del flusso; offset può essere negativo

  • 2 – fine del flusso; offset è in genere negativo

Restituisce la nuova posizione assoluta.

seekable

Restituisce un valore che indica se l'oggetto supporta l'accesso casuale.

Se False, seek(), tell() e truncate() genererà OSError. Questo metodo potrebbe dover eseguire una ricerca di test().

tell

Restituisce la posizione corrente del flusso.

truncate

Tronca il file in byte di dimensioni.

Il puntatore al file rimane invariato. Le dimensioni predefinite sono la posizione di I/O corrente segnalata da tell(). Restituisce le nuove dimensioni.

writable

Restituisce un valore che indica se l'oggetto è stato aperto per la scrittura.

Se False, write() genererà OSError.

write

Scrivere il buffer specificato nel flusso di I/O.

Restituisce il numero di byte scritti, ovvero sempre la lunghezza di b in byte.

Genera BlockingIOError se il buffer è pieno e il flusso non elaborato sottostante non può accettare più dati al momento.

writelines

Scrivere un elenco di righe da trasmettere.

I separatori di riga non vengono aggiunti, pertanto è normale che ogni riga fornita abbia un separatore di riga alla fine.

close

Svuotare e chiudere l'oggetto I/O.

Questo metodo non ha alcun effetto se il file è già chiuso.

close()

detach

Disconnettere questo buffer dal flusso non elaborato sottostante e restituirlo.

Dopo che il flusso non elaborato è stato scollegato, il buffer è in uno stato inutilizzabile.

detach()

fileno

Restituisce il descrittore di file sottostante, se presente.

OSError viene generato se l'oggetto I/O non usa un descrittore di file.

fileno()

flush

Scarica buffer di scrittura, se applicabile.

Questa operazione non viene implementata per i flussi di sola lettura e non di blocco.

flush()

isatty

Restituisce un valore che indica se si tratta di un flusso "interattivo".

Restituisce False se non può essere determinato.

isatty()

read

Restituisce e legge fino alle dimensioni dei byte.

abstract read(size=-1) -> bytes

Parametri

size
int
valore predefinito: -1

Numero di byte da leggere. Se l'argomento viene omesso, Noneo negativo, i dati vengono letti e restituiti fino al raggiungimento di EOF.

Restituisce

Byte letti dal flusso di input.

read1

Leggere e restituire fino a n byte, con al massimo una chiamata read() al flusso non elaborato sottostante. Un breve risultato non implica che EOF sia imminente.

Restituisce un oggetto byte vuoto in EOF.

read1()

readable

Restituisce un valore che indica se l'oggetto è stato aperto per la lettura.

Se False, read() genererà OSError.

readable()

readinto

readinto(buffer, /)

Parametri

buffer
Necessario

readinto1

readinto1(buffer, /)

Parametri

buffer
Necessario

readline

Leggere e restituire una riga dal flusso.

Se viene specificata la dimensione, verranno letti al massimo i byte delle dimensioni.

Il terminatore di riga è sempre b'n' per i file binari; per i file di testo, l'argomento newlines da aprire può essere usato per selezionare i caratteri di terminazione riga riconosciuti.

readline(size=-1, /)

Parametri

size
valore predefinito: -1

readlines

Restituisce un elenco di righe dal flusso.

È possibile specificare hint per controllare il numero di righe lette: non verranno lette altre righe se le dimensioni totali (in byte/caratteri) di tutte le righe finora superano l'hint.

readlines(hint=-1, /)

Parametri

hint
valore predefinito: -1

seek

Modificare la posizione del flusso.

Modificare la posizione del flusso impostando l'offset di byte specificato. L'offset viene interpretato rispetto alla posizione indicata da whence. I valori di whence sono:

  • 0 : inizio del flusso (impostazione predefinita); offset deve essere zero o positivo

  • 1 – posizione corrente del flusso; offset può essere negativo

  • 2 – fine del flusso; offset è in genere negativo

Restituisce la nuova posizione assoluta.

seek()

seekable

Restituisce un valore che indica se l'oggetto supporta l'accesso casuale.

Se False, seek(), tell() e truncate() genererà OSError. Questo metodo potrebbe dover eseguire una ricerca di test().

seekable()

tell

Restituisce la posizione corrente del flusso.

tell()

truncate

Tronca il file in byte di dimensioni.

Il puntatore al file rimane invariato. Le dimensioni predefinite sono la posizione di I/O corrente segnalata da tell(). Restituisce le nuove dimensioni.

truncate()

writable

Restituisce un valore che indica se l'oggetto è stato aperto per la scrittura.

Se False, write() genererà OSError.

writable()

write

Scrivere il buffer specificato nel flusso di I/O.

Restituisce il numero di byte scritti, ovvero sempre la lunghezza di b in byte.

Genera BlockingIOError se il buffer è pieno e il flusso non elaborato sottostante non può accettare più dati al momento.

write()

writelines

Scrivere un elenco di righe da trasmettere.

I separatori di riga non vengono aggiunti, pertanto è normale che ogni riga fornita abbia un separatore di riga alla fine.

writelines(lines, /)

Parametri

lines
Necessario

Attributi

closed

length

name

uri