Added in API level 1

FileWriter

open class FileWriter : OutputStreamWriter
kotlin.Any
   ↳ java.io.Writer
   ↳ java.io.OutputStreamWriter
   ↳ java.io.FileWriter

Writes text to character files using a default buffer size. Encoding from characters to bytes uses either a specified charset or the platform's default charset.

Whether or not a file is available or may be created depends upon the underlying platform. Some platforms, in particular, allow a file to be opened for writing by only one FileWriter (or other file-writing object) at a time. In such situations the constructors in this class will fail if the file involved is already open.

The FileWriter is meant for writing streams of characters. For writing streams of raw bytes, consider using a FileOutputStream.

Summary

Public constructors
FileWriter(fileName: String!)

Constructs a FileWriter given a file name, using the platform's default charset

FileWriter(fileName: String!, append: Boolean)

Constructs a FileWriter given a file name and a boolean indicating whether to append the data written, using the platform's default charset.

FileWriter(file: File!)

Constructs a FileWriter given the File to write, using the platform's default charset

FileWriter(file: File!, append: Boolean)

Constructs a FileWriter given the File to write and a boolean indicating whether to append the data written, using the platform's default charset.

Constructs a FileWriter given a file descriptor, using the platform's default charset.

FileWriter(fileName: String!, charset: Charset!)

Constructs a FileWriter given a file name and charset.

FileWriter(fileName: String!, charset: Charset!, append: Boolean)

Constructs a FileWriter given a file name, charset and a boolean indicating whether to append the data written.

FileWriter(file: File!, charset: Charset!)

Constructs a FileWriter given the File to write and charset.

FileWriter(file: File!, charset: Charset!, append: Boolean)

Constructs a FileWriter given the File to write, charset and a boolean indicating whether to append the data written.

Inherited functions
Inherited properties

Public constructors

FileWriter

Added in API level 1
FileWriter(fileName: String!)

Constructs a FileWriter given a file name, using the platform's default charset

Parameters
fileName String!: String The system-dependent filename.
Exceptions
java.io.IOException if the named file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason

FileWriter

Added in API level 1
FileWriter(
    fileName: String!,
    append: Boolean)

Constructs a FileWriter given a file name and a boolean indicating whether to append the data written, using the platform's default charset.

Parameters
fileName String!: String The system-dependent filename.
append Boolean: boolean if true, then data will be written to the end of the file rather than the beginning.
Exceptions
java.io.IOException if the named file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason

FileWriter

Added in API level 1
FileWriter(file: File!)

Constructs a FileWriter given the File to write, using the platform's default charset

Parameters
file File!: the File to write.
Exceptions
java.io.IOException if the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason

FileWriter

Added in API level 1
FileWriter(
    file: File!,
    append: Boolean)

Constructs a FileWriter given the File to write and a boolean indicating whether to append the data written, using the platform's default charset.

Parameters
file File!: the File to write
append Boolean: if true, then bytes will be written to the end of the file rather than the beginning
Exceptions
java.io.IOException if the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason

FileWriter

Added in API level 1
FileWriter(fd: FileDescriptor!)

Constructs a FileWriter given a file descriptor, using the platform's default charset.

Parameters
fd FileDescriptor!: the FileDescriptor to write.

FileWriter

Added in API level 33
FileWriter(
    fileName: String!,
    charset: Charset!)

Constructs a FileWriter given a file name and charset.

Parameters
fileName String!: the name of the file to write
charset Charset!: the charset
Exceptions
java.io.IOException if the named file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason

FileWriter

Added in API level 33
FileWriter(
    fileName: String!,
    charset: Charset!,
    append: Boolean)

Constructs a FileWriter given a file name, charset and a boolean indicating whether to append the data written.

Parameters
fileName String!: the name of the file to write
charset Charset!: the charset
append Boolean: a boolean. If true, the writer will write the data to the end of the file rather than the beginning.
Exceptions
java.io.IOException if the named file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason

FileWriter

Added in API level 33
FileWriter(
    file: File!,
    charset: Charset!)

Constructs a FileWriter given the File to write and charset.

Parameters
file File!: the File to write
charset Charset!: the charset
Exceptions
java.io.IOException if the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason

FileWriter

Added in API level 33
FileWriter(
    file: File!,
    charset: Charset!,
    append: Boolean)

Constructs a FileWriter given the File to write, charset and a boolean indicating whether to append the data written.

Parameters
file File!: the File to write
charset Charset!: the charset
append Boolean: a boolean. If true, the writer will write the data to the end of the file rather than the beginning.
Exceptions
java.io.IOException if the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason