writeAsString method

  1. @override
Future<File> writeAsString(
  1. String contents,
  2. {FileMode mode = FileMode.write,
  3. Encoding encoding = utf8,
  4. bool flush = false}
)
override

Writes a string to a file.

Opens the file, writes the string in the given encoding, and closes the file. Returns a Future<File> that completes with this File object once the entire operation has completed.

By default writeAsString creates the file for writing and truncates the file if it already exists. In order to append the bytes to an existing file, pass FileMode.append as the optional mode parameter.

If the argument flush is set to true, the data written will be flushed to the file system before the returned future completes.

This method does not transform newline characters ("\n") to the platform conventional line ending (e.g. "\r\n" on Windows). Use Platform.lineTerminator to separate lines in contents if platform contentional line endings are needed.

Implementation

@override
Future<File> writeAsString(
  String contents, {
  FileMode mode = FileMode.write,
  Encoding encoding = utf8,
  bool flush = false,
}) async =>
    wrap(await delegate.writeAsString(
      contents,
      mode: mode,
      encoding: encoding,
      flush: flush,
    ));