Partilhar via


InputStream Classe

Objeto semelhante a um ficheiro que representa um blob de entrada.

Herança
InputStream
InputStream

Construtor

InputStream()

Métodos

close

Remova e feche o objeto de E/S.

Este método não tem qualquer efeito se o ficheiro já estiver fechado.

detach

Desligue esta memória intermédia da corrente não processada subjacente e devolva-a.

Depois de desanexar o fluxo não processado, a memória intermédia encontra-se num estado inutilizável.

fileno

Devolve o descritor de ficheiros subjacente, se existir.

O OSError é gerado se o objeto de E/S não utilizar um descritor de ficheiros.

flush

Remova memórias intermédias de escrita, se aplicável.

Isto não é implementado para fluxos só de leitura e sem bloqueio.

isatty

Devolver se se trata de um fluxo "interativo".

Devolva Falso se não for possível determinar.

read

Devolver e ler até bytes de tamanho .

read1

Leia e devolva até n bytes, com, no máximo, uma chamada de leitura() para o fluxo não processado subjacente. Um resultado curto não implica que a EOF esteja iminente.

Devolve um objeto bytes vazio no EOF.

readable

Devolver se o objeto foi aberto para leitura.

Se For Falso, read() irá gerar OSError.

readinto
readinto1
readline

Leia e devolva uma linha a partir do fluxo.

Se o tamanho for especificado, os bytes de tamanho máximo serão lidos.

O exterminador de linhas é sempre b'n' para ficheiros binários; para ficheiros de texto, o argumento newlines a abrir pode ser utilizado para selecionar os terminadores de linha reconhecidos.

readlines

Devolva uma lista de linhas do fluxo.

pode especificar a sugestão para controlar o número de linhas lidas: não serão lidas mais linhas se o tamanho total (em bytes/carateres) de todas as linhas até agora exceder a sugestão.

seek

Alterar a posição do fluxo.

Altere a posição do fluxo para o desvio de bytes especificado. O deslocamento é interpretado em relação à posição indicada pelo whence. Os valores de quandoce são:

  • 0 – início do fluxo (a predefinição); desvio deve ser zero ou positivo

  • 1 – posição atual do fluxo; desvio pode ser negativo

  • 2 – fim do fluxo; desvio é geralmente negativo

Devolver a nova posição absoluta.

seekable

Devolver se o objeto suporta acesso aleatório.

Se False, seek(), tell() e truncate() gerarão OSError. Este método poderá ter de fazer um teste seek().

tell

Devolver a posição atual do fluxo.

truncate

Truncar ficheiro para dimensionar bytes.

O ponteiro do ficheiro permanece inalterado. O tamanho é predefinido para a posição de E/S atual, conforme comunicado por tell(). Devolve o novo tamanho.

writable

Devolver se o objeto foi aberto para escrita.

Se For Falso, write() irá gerar OSError.

write

Escreva a memória intermédia especificada na transmissão em fluxo de E/S.

Devolve o número de bytes escritos, que é sempre o comprimento de b em bytes.

Gera BlockingIOError se a memória intermédia estiver cheia e o fluxo não processado subjacente não conseguir aceitar mais dados neste momento.

writelines

Escreva uma lista de linhas para transmitir em fluxo.

Os separadores de linha não são adicionados, pelo que é habitual que cada uma das linhas fornecidas tenha um separador de linha no final.

close

Remova e feche o objeto de E/S.

Este método não tem qualquer efeito se o ficheiro já estiver fechado.

close()

detach

Desligue esta memória intermédia da corrente não processada subjacente e devolva-a.

Depois de desanexar o fluxo não processado, a memória intermédia encontra-se num estado inutilizável.

detach()

fileno

Devolve o descritor de ficheiros subjacente, se existir.

O OSError é gerado se o objeto de E/S não utilizar um descritor de ficheiros.

fileno()

flush

Remova memórias intermédias de escrita, se aplicável.

Isto não é implementado para fluxos só de leitura e sem bloqueio.

flush()

isatty

Devolver se se trata de um fluxo "interativo".

Devolva Falso se não for possível determinar.

isatty()

read

Devolver e ler até bytes de tamanho .

abstract read(size=-1) -> bytes

Parâmetros

size
int
valor predefinido: -1

O número de bytes a ler. Se o argumento for omitido, Noneou negativo, os dados são lidos e devolvidos até que o EOF seja atingido.

Devoluções

Bytes lidos a partir do fluxo de entrada.

read1

Leia e devolva até n bytes, com, no máximo, uma chamada de leitura() para o fluxo não processado subjacente. Um resultado curto não implica que a EOF esteja iminente.

Devolve um objeto bytes vazio no EOF.

read1()

readable

Devolver se o objeto foi aberto para leitura.

Se For Falso, read() irá gerar OSError.

readable()

readinto

readinto(buffer, /)

Parâmetros

buffer
Necessário

readinto1

readinto1(buffer, /)

Parâmetros

buffer
Necessário

readline

Leia e devolva uma linha a partir do fluxo.

Se o tamanho for especificado, os bytes de tamanho máximo serão lidos.

O exterminador de linhas é sempre b'n' para ficheiros binários; para ficheiros de texto, o argumento newlines a abrir pode ser utilizado para selecionar os terminadores de linha reconhecidos.

readline(size=-1, /)

Parâmetros

size
valor predefinido: -1

readlines

Devolva uma lista de linhas do fluxo.

pode especificar a sugestão para controlar o número de linhas lidas: não serão lidas mais linhas se o tamanho total (em bytes/carateres) de todas as linhas até agora exceder a sugestão.

readlines(hint=-1, /)

Parâmetros

hint
valor predefinido: -1

seek

Alterar a posição do fluxo.

Altere a posição do fluxo para o desvio de bytes especificado. O deslocamento é interpretado em relação à posição indicada pelo whence. Os valores de quandoce são:

  • 0 – início do fluxo (a predefinição); desvio deve ser zero ou positivo

  • 1 – posição atual do fluxo; desvio pode ser negativo

  • 2 – fim do fluxo; desvio é geralmente negativo

Devolver a nova posição absoluta.

seek()

seekable

Devolver se o objeto suporta acesso aleatório.

Se False, seek(), tell() e truncate() gerarão OSError. Este método poderá ter de fazer um teste seek().

seekable()

tell

Devolver a posição atual do fluxo.

tell()

truncate

Truncar ficheiro para dimensionar bytes.

O ponteiro do ficheiro permanece inalterado. O tamanho é predefinido para a posição de E/S atual, conforme comunicado por tell(). Devolve o novo tamanho.

truncate()

writable

Devolver se o objeto foi aberto para escrita.

Se For Falso, write() irá gerar OSError.

writable()

write

Escreva a memória intermédia especificada na transmissão em fluxo de E/S.

Devolve o número de bytes escritos, que é sempre o comprimento de b em bytes.

Gera BlockingIOError se a memória intermédia estiver cheia e o fluxo não processado subjacente não conseguir aceitar mais dados neste momento.

write()

writelines

Escreva uma lista de linhas para transmitir em fluxo.

Os separadores de linha não são adicionados, pelo que é habitual que cada uma das linhas fornecidas tenha um separador de linha no final.

writelines(lines, /)

Parâmetros

lines
Necessário

Atributos

closed

length

name

uri