BufferedReader.Read(Char[], Int32, Int32) 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.
Lê caracteres em uma parte de uma matriz.
[Android.Runtime.Register("read", "([CII)I", "GetRead_arrayCIIHandler")]
public override int Read(char[]? cbuf, int off, int len);[<Android.Runtime.Register("read", "([CII)I", "GetRead_arrayCIIHandler")>]
override this.Read : char[] * int * int -> intParâmetros
- cbuf
- Char[]
Buffer de destino
- off
- Int32
Deslocamento no qual iniciar o armazenamento de caracteres
- len
- Int32
Número máximo de caracteres a serem lidos
Retornos
O número de caracteres lidos ou -1 se o final do fluxo tiver sido atingido
- Atributos
Exceções
if offset buffer.length.
se este leitor estiver fechado ou ocorrer algum outro erro de E/S.
Comentários
Lê caracteres em uma parte de uma matriz.
Esse método implementa o contrato geral do método correspondente {@link Reader#read(char[], int, int) read} da {@link Reader} classe. Como uma conveniência adicional, ele tenta ler o máximo de caracteres possível invocando repetidamente o read método do fluxo subjacente. Essa iteração read continua até que uma das seguintes condições se torne verdadeira: <ul>
<li> O número especificado de caracteres foi lido,
<li> O read método do fluxo subjacente retorna -1, indicando o fim do arquivo ou
<li> O ready método do fluxo subjacente retorna false, indicando que novas solicitações de entrada seriam bloqueadas.
</ul> Se o primeiro read no fluxo subjacente retornar -1 para indicar o fim do arquivo, esse método retornará -1. Caso contrário, esse método retornará o número de caracteres realmente lidos.
Subclasses dessa classe são incentivadas, mas não necessárias, a tentar ler o máximo de caracteres possível da mesma forma.
Normalmente, esse método usa caracteres do buffer de caracteres desse fluxo, preenchendo-o do fluxo subjacente, conforme necessário. Se, no entanto, o buffer estiver vazio, a marca não for válida e o comprimento solicitado for pelo menos tão grande quanto o buffer, esse método lerá caracteres diretamente do fluxo subjacente para a matriz determinada. Portanto, s redundantes BufferedReadernão copiarão dados desnecessariamente.
Java documentação para java.io.BufferedReader.read(char[], int, int).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.