FileWriter (Java SE 13 & JDK 13 )
- All Implemented Interfaces:
Closeable,Flushable,Appendable,AutoCloseable
public class FileWriter extends OutputStreamWriter
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.
- Since:
- 1.1
- See Also:
OutputStreamWriter,FileOutputStream
-
Field Summary
-
Constructor Summary
Constructors Constructor Description FileWriter(File file)Constructs a
FileWritergiven theFileto write, using the platform's default charsetFileWriter(FileDescriptor fd)Constructs a
FileWritergiven a file descriptor, using the platform's default charset.FileWriter(File file, boolean append)Constructs a
FileWritergiven theFileto write and a boolean indicating whether to append the data written, using the platform's default charset.FileWriter(File file, Charset charset)Constructs a
FileWritergiven theFileto write and charset.FileWriter(File file, Charset charset, boolean append)Constructs a
FileWritergiven theFileto write, charset and a boolean indicating whether to append the data written.FileWriter(String fileName)Constructs a
FileWritergiven a file name, using the platform's default charsetFileWriter(String fileName, boolean append)Constructs a
FileWritergiven a file name and a boolean indicating whether to append the data written, using the platform's default charset.FileWriter(String fileName, Charset charset)Constructs a
FileWritergiven a file name and charset.FileWriter(String fileName, Charset charset, boolean append)Constructs a
FileWritergiven a file name, charset and a boolean indicating whether to append the data written. -
Method Summary
-
Constructor Details
-
FileWriter
Constructs a
FileWritergiven a file name, using the platform's default charset- Parameters:
fileName- String The system-dependent filename.- Throws:
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
public FileWriter(String fileName, boolean append) throws IOException
Constructs a
FileWritergiven a file name and a boolean indicating whether to append the data written, using the platform's default charset.- Parameters:
fileName- String The system-dependent filename.append- boolean iftrue, then data will be written to the end of the file rather than the beginning.- Throws:
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
Constructs a
FileWritergiven theFileto write, using the platform's default charset- Parameters:
file- theFileto write.- Throws:
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
public FileWriter(File file, boolean append) throws IOException
Constructs a
FileWritergiven theFileto write and a boolean indicating whether to append the data written, using the platform's default charset.- Parameters:
file- theFileto writeappend- iftrue, then bytes will be written to the end of the file rather than the beginning- Throws:
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- Since:
- 1.4
-
FileWriter
Constructs a
FileWritergiven a file descriptor, using the platform's default charset.- Parameters:
fd- theFileDescriptorto write.
-
FileWriter
Constructs a
FileWritergiven a file name and charset.- Parameters:
fileName- the name of the file to writecharset- the charset- Throws:
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- Since:
- 11
-
FileWriter
Constructs a
FileWritergiven a file name, charset and a boolean indicating whether to append the data written.- Parameters:
fileName- the name of the file to writecharset- the charsetappend- a boolean. Iftrue, the writer will write the data to the end of the file rather than the beginning.- Throws:
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- Since:
- 11
-
FileWriter
Constructs a
FileWritergiven theFileto write and charset.- Parameters:
file- theFileto writecharset- the charset- Throws:
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- Since:
- 11
-
FileWriter
Constructs a
FileWritergiven theFileto write, charset and a boolean indicating whether to append the data written.- Parameters:
file- theFileto writecharset- the charsetappend- a boolean. Iftrue, the writer will write the data to the end of the file rather than the beginning.- Throws:
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- Since:
- 11
-
Report a bug or suggest an enhancement
For further API reference and developer documentation see the Java SE Documentation, which contains more detailed, developer-targeted descriptions with conceptual overviews, definitions of terms, workarounds, and working code examples.
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 1993, 2019, Oracle and/or its affiliates, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
All rights reserved. Use is subject to license terms and the documentation redistribution policy.