Инструмент доступа к текстовому файлу. Позволяет производить как чтение, так и запись информации в файл.
Объект работает в одном из следующих режимов:
Чтобы создать объект Текстовый файл
Этот объект выполняет чтение из файла построчно. Номер текущей строки можно получить с помощью метода getLineNumber(). По умолчанию нумерация строк начинается с 0. Этот номер увеличивается по мере чтения данных после каждого символа разделителя строк.
Линия считается завершенной при достижении символа перевода строки ('\n'), возврата каретки ('\r'), либо символа возврата каретки, за которым сразу следует символ перевода строки.
В режиме чтения при каждом вызове метода чтения (например, readDouble()), объект перемещает свою текущую позицию к следующему значению, которое можно прочитать. Т.e. он считывает требуемые данные и пропускает все последующие символы разделителей, которые были заданы в свойствах объекта.
Изначально объект находится в "закрытом" состоянии: любой последующий вызов метода доступа (например, print(double)) откроет файл, т.е. следующее чтение (если объект находится в режиме чтения READ) начнет чтение с начала, в то время, как новая операция записи (если объект находится в режиме записи) начнет перезапись или запись в конец файла (в зависимости от режима записи).
У объекта есть методы skipChars(long) и skipTokens(int), выполняющие пропуск (заранее известного) количества символов (с учетом символов разделителей или без) из файлаvoid println() - Завершает текущую строку путем записи разделителя строк. Разделитель строк задается свойством системы line.separator, и необязательно является символом новой строки ('\n').
void print(
void printf(java.util.Locale l, String format, Object... args)
- Метод для записи форматированной строки в текстовый файл с использованием заданного формата строки и аргументов. Число аргументов может меняться (и может быть равно нулю).
l
- данные о местоположении пользователя (locale), используемые при форматировании. Если аргумент
l
равен
null, то локализация не производится.
format
- формат строки, описанный в спецификации класса
Formatter.
args
- аргументы, передающие значения конструктору заданного формата строки.
void printf(String format, Object... args)
- Метод для записи форматированной строки в текстовый файл с использованием заданного формата строки и аргументов. Число аргументов может меняться (и может быть равно нулю).
format
- формат строки, описанный в спецификации класса
Formatter.
args
- аргументы, передающие значения конструктору заданного формата строки.
void printf(String, Object...) и printf(Locale, String, Object...) - метод для записи форматированной строки в текстовый файл с использованием заданного формата строки и аргументов.
Оба метода (print() и println()) могут принимать значения всех следующих типов: boolean, char, char[], double, float, int, long, Object, String.
boolean canReadMore() - Возвращает true, если в файле еще содержится текст (начиная от текущей позиции). Если файл не был открыт, то этот метод открывает файл для чтения.
int getLineNumber() - Возвращает номер текущей строки (нумерация начинается с 1).
String readLine()
- Считывает строку текста.
При достижении символов конца строки номер текущей строки увеличивается. Если текущая позиция находится в середине строки (например, текущая строка - "33;Car" и метод
readInt()
был вызван один раз), то будет возвращена оставшаяся часть строки (в данном примере это - "Car", если разделитель ';', и ";Car", если нет).
Метод возвращает строку
String, содержащую содержимое строки (начиная от текущей позиции), не включая символов конца строк, или null, если был достигнут конец потока.
String readString() - Считывает и возвращает строку String, содержащую текст от текущей позиции (находящейся после ранее считанного разделителя) до следующего разделителя (не включая его).
boolean readBoolean() - Считывает значение типа boolean: "true" или "false" (в кавычках или без).
byte readByte() - Считывает и возвращает значение типа byte.
short readShort() - Считывает и возвращает значение типа short.
char readChar() - Считывает и возвращает один символ. Выбрасывает исключение, если в текущей позиции находится разделитель, или текст до следующего разделителя представляет собой не один символ.
int readInt() - Считывает и возвращает значение типа int.
double readDouble() - Считывает и возвращает значение типа double (число с плавающей точкой и двойной точностью).
long readLong() - Считывает и возвращает значение типа long.
float readFloat() - Считывает и возвращает значение типа float (число с плавающей точкой).