Module java.base
Package java.io

Class FilterWriter

java.lang.Object
java.io.Writer
java.io.FilterWriter
All Implemented Interfaces:
Closeable, Flushable, Appendable, AutoCloseable

public abstract class FilterWriter
extends Writer
Abstract class for writing filtered character streams. The abstract class FilterWriter itself provides default methods that pass all requests to the contained stream. Subclasses of FilterWriter should override some of these methods and may also provide additional methods and fields.
Since:
1.1
  • Field Details

    • out

      protected Writer out
      The underlying character-output stream.
  • Constructor Details

    • FilterWriter

      protected FilterWriter​(Writer out)
      Create a new filtered writer.
      Parameters:
      out - a Writer object to provide the underlying stream.
      Throws:
      NullPointerException - if out is null
  • Method Details

    • write

      public void write​(int c) throws IOException
      Writes a single character.
      Overrides:
      write in class Writer
      Parameters:
      c - int specifying a character to be written
      Throws:
      IOException - If an I/O error occurs
    • write

      public void write​(char[] cbuf, int off, int len) throws IOException
      Writes a portion of an array of characters.
      Specified by:
      write in class Writer
      Parameters:
      cbuf - Buffer of characters to be written
      off - Offset from which to start reading characters
      len - Number of characters to be written
      Throws:
      IndexOutOfBoundsException - If the values of the off and len parameters cause the corresponding method of the underlying Writer to throw an IndexOutOfBoundsException
      IOException - If an I/O error occurs
    • write

      public void write​(String str, int off, int len) throws IOException
      Writes a portion of a string.
      Overrides:
      write in class Writer
      Parameters:
      str - String to be written
      off - Offset from which to start reading characters
      len - Number of characters to be written
      Throws:
      IndexOutOfBoundsException - If the values of the off and len parameters cause the corresponding method of the underlying Writer to throw an IndexOutOfBoundsException
      IOException - If an I/O error occurs
    • flush

      public void flush() throws IOException
      Flushes the stream.
      Specified by:
      flush in interface Flushable
      Specified by:
      flush in class Writer
      Throws:
      IOException - If an I/O error occurs