Библиотеки » Ввод-вывод (dart:io) » File » writeAsString

функция File::writeAsString

Асинхронная запись строки в файл

Синтаксис

Future[File]
File.writeAsString
(String contents, Encoding encoding = Encoding.UTF_8, FileMode mode = FileMode.WRITE)

Передаваемые параметры

String contents, Encoding encoding = Encoding.UTF_8, FileMode mode = FileMode.WRITE

Возвращаемое значение

Future[File]

Описание

Метод writeAsString позволяет асинхронно записать строку String contents в файл. В процессе выполнения сначала открывается файл, потом туда записывается строка, потом файл закрывается. Если файл с указанным именем отсутствует, то он перед открытием создается, а если файл уже существует, то он, по умолчанию, сначала очищается. А для того, чтобы дописать что-либо к существующему файл, необходимо установить соответствующий режим открытия файла с помощью необязательного параметра FileMode mode = FileMode.APPEND

Содержимое строки при записи будет интерпретироваться и записываться с учетом указанной в необязательном параметре Encoding encoding кодировке. По умолчанию, используется кодировка Encoding.UTF_8.

После вызова данного метода, управление не блокируется, а сразу же возвращается в основной поток, а в качестве результата отдается объект типа Future, в котором, когда будет доступен, обрбрабатывается результат выполнения функции - успешное получение данных или перехват ошибок.

Смотрите также

File::readAsLines - Асинхронное получение содержимого файла в виде массива строк
File::readAsLinesSync - Получение содержимого файла в виде массива строк
File::readAsString - Асинхронное получение содержимого файла в виде одной строки
File::readAsStringSync - Получение содержимого файла в виде одной строки
File::writeAsStringSync - Запись строки в файл

Официальная документация (английский)