BufferedReader (Платформа Java SE 7)

java.lang. Объект
- java.io. Читатель
- - java.io. BufferedReader

Все Реализованные Интерфейсы:

Closeable, AutoCloseable, Читаемый

Прямые Известные Подклассы:

LineNumberReader
```
public class BufferedReader
extends Reader
```
Текст чтений от потока ввода символов, буферизуя символы, чтобы предусмотреть эффективное чтение символов, массивов, и строк.
Размер буфера может быть определен, или размер по умолчанию может использоваться. Значение по умолчанию является достаточно большим в большинстве целей.
Вообще, каждая просьба чтения, сделанная из Читателя, заставляет соответствующий запрос чтения быть обращенным к базовому символьному или потоку байтов. Поэтому желательно обернуть BufferedReader вокруг любого Читателя, чей считанный () операции могут быть дорогостоящими, такими как FileReaders и InputStreamReaders. Например,
```
 BufferedReader in
   = new BufferedReader(new FileReader("foo.in"));
 
```
буферизует ввод от указанного файла. Без буферизации каждый вызов чтения () или readLine () мог заставить байты быть считанными из файла, преобразовал в символы, и затем возвратился, который может быть очень неэффективным.
Программы, которые используют DataInputStreams для текстового ввода, могут быть локализованы, заменяя каждый DataInputStream с соответствующим BufferedReader.
С тех пор:

JDK1.1

См. Также:
FileReader, InputStreamReader, Files.newBufferedReader(java.nio.file.Path, java.nio.charset.Charset)

Полевая Сводка
- Поля java.io унаследованный от класса. Читатель
  блокировка

Сводка конструктора

Конструкторы
Конструктор и Описание
`BufferedReader(Reader in)` Создает поток ввода символов буферизации, который использует входной буфер размера по умолчанию.
`BufferedReader(Reader in, int sz)` Создает поток ввода символов буферизации, который использует входной буфер указанного размера.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`void`	`close()` Закрывает поток и выпускает любые системные ресурсы, связанные с этим.
`void`	`mark(int readAheadLimit)` Отмечает нынешнее положение в потоке.
`boolean`	`markSupported()` Говорит, поддерживает ли этот поток метку () работа, которую это делает.
`int`	`read()` Читает единственный символ.
`int`	`read(char[] cbuf, int off, int len)` Символы чтений в часть массива.
`Строка`	`readLine()` Читает строку текста.
`boolean`	`ready()` Говорит, готов ли этот поток быть считанным.
`void`	`reset()` Сбрасывает поток к новой метке.
`long`	`skip(long n)` Символы пропусков.

Методы java.io унаследованный от класса. Читатель
read, read

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - BufferedReader
```
public BufferedReader(Reader in,
              int sz)
```
    Создает поток ввода символов буферизации, который использует входной буфер указанного размера.
    
    Параметры:
    in - Читатель
    sz - Входной размер буфера
    
    Броски:
    
    IllegalArgumentException - Если sz <= 0
  - BufferedReader
```
public BufferedReader(Reader in)
```
    Создает поток ввода символов буферизации, который использует входной буфер размера по умолчанию.
    
    Параметры:
    in - Читатель
- Деталь метода
  - читать
```
public int read()
         throws IOException
```
    Читает единственный символ.
    
    Переопределения:
    
    read в классе Reader
    
    Возвраты:
    Символьное чтение, как целое число в диапазоне от 0 до 65535 (0x00-0xffff), или-1, если конец потока был достигнут
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит
  - читать
```
public int read(char[] cbuf,
       int off,
       int len)
         throws IOException
```
    Символы чтений в часть массива.
    Этот метод реализует общий контракт соответствия read метод Reader класс. Как дополнительное удобство, это пытается считать так много символов насколько возможно, неоднократно вызывая read метод базового потока. Это выполнило итерации read продолжается, пока одно из следующих условий не становится истиной:
    - Конкретное количество символов было считано,
    - read метод базовых потоковых возвратов -1, указание на конец файла, или
    - ready метод базовых потоковых возвратов false, указание, что далее входные запросы блокировали бы.
    Если первое read по базовым потоковым возвратам -1 указать на конец файла тогда этот метод возвраты -1. Иначе этот метод возвращает число символов фактически чтение.
    Подклассы этого класса поощряются, но не требуются, чтобы попытаться считать так много символов насколько возможно тем же самым способом.
    Обычно этот метод берет символы от символьного буфера этого потока, заполняя это от базового потока по мере необходимости. Если, однако, буфер пуст, метка не допустима, и требуемая длина является, по крайней мере, столь же большой как буфер, то этот метод считает символы непосредственно из базового потока в данный массив. Таким образом избыточный BufferedReaders не будет копировать данные излишне.
    Определенный:
    
    read в классе Reader
    
    Параметры:
    cbuf - Целевой буфер
    off - Смещение, при котором можно начать хранить символы
    len - Максимальное количество символов, чтобы читать
    
    Возвраты:
    Число символов читало, или-1, если конец потока был достигнут
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит
  - readLine
```
public String readLine()
                throws IOException
```
    Читает строку текста. Строка, как полагают, завершается любым из перевода строки ('\n'), возврат каретки ('\r'), или возврат каретки, сопровождаемый сразу переводом строки.
    
    Возвраты:
    Строка, содержащая содержание строки, не включая любые символы завершения строки, или нуль, если конец потока был достигнут
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит
    См. Также:
    Files.readAllLines(java.nio.file.Path, java.nio.charset.Charset)
  - пропустить
```
public long skip(long n)
          throws IOException
```
    Символы пропусков.
    
    Переопределения:
    
    skip в классе Reader
    
    Параметры:
    n - Число символов, чтобы пропустить
    
    Возвраты:
    Число символов фактически пропускается
    
    Броски:
    
    IllegalArgumentException - Если n отрицательно.
    
    IOException - Если ошибка ввода-вывода происходит
  - готовый
```
public boolean ready()
              throws IOException
```
    Говорит, готов ли этот поток быть считанным. Буферизованный символьный поток готов, если буфер не пуст, или если базовый символьный поток готов.
    
    Переопределения:
    
    ready в классе Reader
    
    Возвраты:
    Истина, если следующее чтение (), как гарантируют, не блокирует для ввода, ложь иначе. Отметьте, что возвращение false не гарантирует, что следующее чтение блокирует.
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит
  - markSupported
```
public boolean markSupported()
```
    Говорит, поддерживает ли этот поток метку () работа, которую это делает.
    
    Переопределения:
    
    markSupported в классе Reader
    
    Возвраты:
    истина, если и только если этот поток поддерживает работу метки.
  - метка
```
public void mark(int readAheadLimit)
          throws IOException
```
    Отмечает нынешнее положение в потоке. Последующие вызовы, чтобы сбросить () будут делать попытку к репозиции потока к этой точке.
    
    Переопределения:
    
    mark в классе Reader
    
    Параметры:
    readAheadLimit - Предел на числе символов, которые могут быть считаны, все еще сохраняя метку. Попытка сбросить поток после того, чтобы читать символы до этого предела или вне может перестать работать. Предельное значение, больше чем размер входного буфера, заставит новый буфер быть выделенным, чей размер не меньше чем предел. Поэтому большие значения должны использоваться с заботой.
    
    Броски:
    
    IllegalArgumentException - Если readAheadLimit < 0
    
    IOException - Если ошибка ввода-вывода происходит
  - сброс
```
public void reset()
           throws IOException
```
    Сбрасывает поток к новой метке.
    
    Переопределения:
    
    reset в классе Reader
    
    Броски:
    
    IOException - Если поток никогда не отмечался, или если метка была лишена законной силы
  - близко
```
public void close()
           throws IOException
```
    Описание скопировало с класса: Reader
    
    Закрывает поток и выпускает любые системные ресурсы, связанные с этим. Как только поток был закрыт, далее считайте (), готовый (), метка (), сбросьте (), или пропуск (), вызовы бросят IOException. Закрытие ранее закрытого потока не имеет никакого эффекта.
    
    Определенный:
    
    close в интерфейсе Closeable
    
    Определенный:
    
    close в интерфейсе AutoCloseable
    
    Определенный:
    
    close в классе Reader
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс BufferedReader

Полевая Сводка

Поля java.io унаследованный от класса. Читатель

Сводка конструктора

Сводка метода

Методы java.io унаследованный от класса. Читатель

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

BufferedReader

BufferedReader

Деталь метода

читать

читать

readLine

пропустить

готовый

markSupported

метка

сброс

близко