Module java.base
Package java.io

Class FileWriter

  • All Implemented Interfaces:
    Closeable,Flushable,Appendable,AutoCloseable
    public classFileWriterextendsOutputStreamWriter
    Writes text to character files using a default buffer size. Encoding from characters to bytes uses either a specifiedcharset or the platform'sdefault 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 oneFileWriter (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.

    TheFileWriter is meant for writing streams of characters. For writing streams of raw bytes, consider using aFileOutputStream.

    Since:
    1.1
    See Also:
    OutputStreamWriter,FileOutputStream

    • Constructor Detail

      • FileWriter

        public FileWriter​(String fileName)           throwsIOException
        Constructs aFileWriter given a file name, using the platform'sdefault 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)           throwsIOException
        Constructs aFileWriter given a file name and a boolean indicating whether to append the data written, using the platform'sdefault 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

        public FileWriter​(File file)           throwsIOException
        Constructs aFileWriter given theFile to write, using the platform'sdefault charset
        Parameters:
        file - theFile to 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)           throwsIOException
        Constructs aFileWriter given theFile to write and a boolean indicating whether to append the data written, using the platform'sdefault charset.
        Parameters:
        file - theFile to write
        append - 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

        public FileWriter​(FileDescriptor fd)
        Constructs aFileWriter given a file descriptor, using the platform'sdefault charset.
        Parameters:
        fd - theFileDescriptor to write.

      • FileWriter

        public FileWriter​(String fileName,Charset charset)           throwsIOException
        Constructs aFileWriter given a file name andcharset.
        Parameters:
        fileName - the name of the file to write
        charset - thecharset
        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

        public FileWriter​(String fileName,Charset charset,                  boolean append)           throwsIOException
        Constructs aFileWriter given a file name,charset and a boolean indicating whether to append the data written.
        Parameters:
        fileName - the name of the file to write
        charset - thecharset
        append - 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

        public FileWriter​(File file,Charset charset)           throwsIOException
        Constructs aFileWriter given theFile to write andcharset.
        Parameters:
        file - theFile to write
        charset - thecharset
        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

        public FileWriter​(File file,Charset charset,                  boolean append)           throwsIOException
        Constructs aFileWriter given theFile to write,charset and a boolean indicating whether to append the data written.
        Parameters:
        file - theFile to write
        charset - thecharset
        append - 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