Files.readString()
Читает весь текстовый файл в одну строку.
Доступно с: Java 11
Синтаксис
static String readString(Path path) throws IOExceptionПараметры
| Параметр | Тип | Описание |
|---|---|---|
| path | Path | Путь к файлу. Кодировка по умолчанию — UTF-8; другую можно передать вторым аргументом. |
Возвращаемое значение
StringСодержимое файла.
Примеры
Записать файл и прочитать его целиком:
void main() throws IOException {
Path file = Path.of("note.txt");
Files.writeString(file, "Buy milk\nCall Anna\n");
String text = Files.readString(file);
IO.print(text);
IO.println(text.length());
Files.delete(file);
}Результат:
Buy milk
Call Anna
19Файла нет — NoSuchFileException:
void main() {
try {
Files.readString(Path.of("missing.txt"));
} catch (IOException e) {
IO.println(e.getClass().getSimpleName() + ": " + e.getMessage());
}
}Результат:
NoSuchFileException: missing.txtПримечания
Метод бросает проверяемое IOException, поэтому его надо поймать или объявить throws IOException. Подходит для небольших файлов: всё содержимое оказывается в памяти. Большие файлы читайте построчно через Files.lines() или BufferedReader.
См. также
- Files.writeString() — Записывает строку в файл: создаёт его или перезаписывает.
- Files.readAllLines() — Читает текстовый файл в список строк.
- Files.lines() — Читает файл лениво — как поток строк, не загружая его в память целиком.
- Path.of() — Создаёт объект Path — путь к файлу или папке.
- IOException — Проверяемое исключение для ошибок ввода-вывода: файлов, сети, потоков данных.
Вопросы и ответы по теме
В учебнике
- Чтение и запись файлов — Чтение и запись текстовых файлов в Java — Files.writeString, readString, readAllLines, write, дозапись в конец, Files.lines и буферизованные потоки.