InputStream.Read Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| Read(Byte[], Int32, Int32) |
Lê até |
| Read() |
Lê o próximo byte de dados do fluxo de entrada. |
| Read(Byte[]) |
Lê alguns números de bytes do fluxo de entrada e os armazena na matriz |
Read(Byte[], Int32, Int32)
Lê até len bytes de dados do fluxo de entrada em uma matriz de bytes.
[Android.Runtime.Register("read", "([BII)I", "GetRead_arrayBIIHandler")]
public virtual int Read(byte[]? b, int off, int len);
[<Android.Runtime.Register("read", "([BII)I", "GetRead_arrayBIIHandler")>]
abstract member Read : byte[] * int * int -> int
override this.Read : byte[] * int * int -> int
Parâmetros
- b
- Byte[]
o buffer no qual os dados são lidos.
- off
- Int32
o deslocamento inicial na matriz b na qual os dados são gravados.
- len
- Int32
o número máximo de bytes a serem lidos.
Retornos
o número total de bytes lidos no buffer ou -1 se não houver mais dados porque o final do fluxo foi atingido.
- Atributos
Exceções
if byteOffset buffer.length.
se o fluxo estiver fechado ou outro IOException ocorrer.
Comentários
Lê até len bytes de dados do fluxo de entrada em uma matriz de bytes. É feita uma tentativa de ler até bytes len , mas um número menor pode ser lido. O número de bytes realmente lidos é retornado como um inteiro.
Esse método bloqueia até que os dados de entrada sejam disponibilizados, o fim do arquivo seja detectado ou uma exceção seja gerada.
Se len for zero, nenhum bytes será lido e 0 retornado; caso contrário, haverá uma tentativa de ler pelo menos um byte. Se nenhum byte estiver disponível porque o fluxo está no final do arquivo, o valor -1 será retornado; caso contrário, pelo menos um byte será lido e armazenado em b.
A primeira leitura de byte é armazenada no elemento b[off], a próxima no b[off+1]e assim por diante. O número de bytes lidos é, no máximo, igual a len. Let k be the number of bytes actually read; esses bytes serão armazenados em elementos b[off] por b[off+-1], deixando os elementos b[off+k] por meio b[off+len-1] de não afetados.
Em todos os casos, os elementos b[0] por meio b[off-1] e por meio b[off+len] de elementos b[b.length-1] não são afetados.
O read(b, off, len) método para classe InputStream simplesmente chama o método read() repetidamente. Se a primeira chamada desse tipo resultar em uma IOException, essa exceção será retornada da chamada para o read(b,off,len) método. Se qualquer chamada subsequente resultar read() em um IOException, a exceção será capturada e tratada como se fosse o fim do arquivo; os bytes lidos até esse ponto são armazenados b e o número de bytes lidos antes da exceção ocorrer é retornado. A implementação padrão desse método bloqueia até que a quantidade solicitada de dados len de entrada seja lida, o fim do arquivo seja detectado ou uma exceção seja gerada. As subclasses são incentivadas a fornecer uma implementação mais eficiente desse método.
Documentação Java para java.io.InputStream.read(byte[], int, int).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.
Aplica-se a
Read()
Lê o próximo byte de dados do fluxo de entrada.
[Android.Runtime.Register("read", "()I", "GetReadHandler")]
public abstract int Read();
[<Android.Runtime.Register("read", "()I", "GetReadHandler")>]
abstract member Read : unit -> int
Retornos
o próximo byte de dados ou -1 se o final do fluxo for atingido.
- Atributos
Exceções
se o fluxo estiver fechado ou outro IOException ocorrer.
Comentários
Lê o próximo byte de dados do fluxo de entrada. O byte de valor é retornado como um int no intervalo 0 para 255. Se nenhum byte estiver disponível porque o final do fluxo foi atingido, o valor -1 será retornado. Esse método bloqueia até que os dados de entrada sejam disponibilizados, o final do fluxo seja detectado ou uma exceção seja gerada.
Uma subclasse deve fornecer uma implementação desse método.
Documentação Java para java.io.InputStream.read().
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.
Aplica-se a
Read(Byte[])
Lê alguns números de bytes do fluxo de entrada e os armazena na matriz bde buffer.
[Android.Runtime.Register("read", "([B)I", "GetRead_arrayBHandler")]
public virtual int Read(byte[]? b);
[<Android.Runtime.Register("read", "([B)I", "GetRead_arrayBHandler")>]
abstract member Read : byte[] -> int
override this.Read : byte[] -> int
Parâmetros
- b
- Byte[]
o buffer no qual os dados são lidos.
Retornos
o número total de bytes lidos no buffer ou -1 se não houver mais dados porque o final do fluxo foi atingido.
- Atributos
Exceções
Comentários
Lê alguns números de bytes do fluxo de entrada e os armazena na matriz bde buffer. O número de bytes realmente lidos é retornado como um inteiro. Esse método bloqueia até que os dados de entrada sejam disponibilizados, o fim do arquivo seja detectado ou uma exceção seja gerada.
Se o comprimento for b zero, nenhum bytes será lido e 0 retornado; caso contrário, haverá uma tentativa de ler pelo menos um byte. Se nenhum byte estiver disponível porque o fluxo está no final do arquivo, o valor -1 será retornado; caso contrário, pelo menos um byte será lido e armazenado em b.
A primeira leitura de byte é armazenada no elemento b[0], a próxima no b[1]e assim por diante. O número de bytes lidos é, no máximo, igual ao comprimento de b. Let k be the number of bytes actually read; esses bytes serão armazenados em elementos b[0] por b[-1], deixando os elementos b[k] por meio b[b.length-1] de não afetados.
O read(b) método para classe InputStream tem o mesmo efeito que:
{@code read(b, 0, b.length) }
Documentação Java para java.io.InputStream.read(byte[]).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.