FileReader

public class FileReader
extends InputStreamReader

java.lang.Object
   ↳ java.io.Reader
     ↳ java.io.InputStreamReader
       ↳ java.io.FileReader


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

The FileReader is meant for reading streams of characters. For reading streams of raw bytes, consider using a FileInputStream.

Summary

Inherited fields

protected Object lock

The object used to synchronize operations on this stream.

Public constructors

FileReader(File file)

Creates a new FileReader, given the File to read, using the platform's default charset.

FileReader(File file, Charset charset)

Creates a new FileReader, given the File to read and the charset.

FileReader(FileDescriptor fd)

Creates a new FileReader, given the FileDescriptor to read, using the platform's default charset.

FileReader(String fileName)

Creates a new FileReader, given the name of the file to read, using the platform's default charset.

FileReader(String fileName, Charset charset)

Creates a new FileReader, given the name of the file to read and the charset.

Inherited methods

void close()

Closes the stream and releases any system resources associated with it.

String getEncoding()

Returns the name of the character encoding being used by this stream.

int read()

Reads a single character.

int read(char[] cbuf, int off, int len)

Reads characters into a portion of an array.

int read(CharBuffer target)

Attempts to read characters into the specified character buffer.

boolean ready()

Tells whether this stream is ready to be read.

abstract void close()

Closes the stream and releases any system resources associated with it.

void mark(int readAheadLimit)

Marks the present position in the stream.

boolean markSupported()

Tells whether this stream supports the mark() operation.

static Reader nullReader()

Returns a new Reader that reads no characters.

int read()

Reads a single character.

abstract int read(char[] cbuf, int off, int len)

Reads characters into a portion of an array.

int read(char[] cbuf)

Reads characters into an array.

int read(CharBuffer target)

Attempts to read characters into the specified character buffer.

boolean ready()

Tells whether this stream is ready to be read.

void reset()

Resets the stream.

long skip(long n)

Skips characters.

long transferTo(Writer out)

Reads all characters from this reader and writes the characters to the given writer in the order that they are read.

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

abstract void close()

Closes this stream and releases any system resources associated with it.

abstract int read(CharBuffer cb)

Attempts to read characters into the specified character buffer.

abstract void close()

Closes this resource, relinquishing any underlying resources.

Public constructors

FileReader

Added in API level 1
public FileReader (File file)

Creates a new FileReader, given the File to read, using the platform's default charset.

Parameters
file File: the File to read

Throws
FileNotFoundException if the file does not exist, is a directory rather than a regular file, or for some other reason cannot be opened for reading.

FileReader

Added in API level 33
public FileReader (File file, 
                Charset charset)

Creates a new FileReader, given the File to read and the charset.

Parameters
file File: the File to read

charset Charset: the charset

Throws
IOException if the file does not exist, is a directory rather than a regular file, or for some other reason cannot be opened for reading.

FileReader

Added in API level 1
public FileReader (FileDescriptor fd)

Creates a new FileReader, given the FileDescriptor to read, using the platform's default charset.

Parameters
fd FileDescriptor: the FileDescriptor to read

FileReader

Added in API level 1
public FileReader (String fileName)

Creates a new FileReader, given the name of the file to read, using the platform's default charset.

Parameters
fileName String: the name of the file to read

Throws
FileNotFoundException if the named file does not exist, is a directory rather than a regular file, or for some other reason cannot be opened for reading.

FileReader

Added in API level 33
public FileReader (String fileName, 
                Charset charset)

Creates a new FileReader, given the name of the file to read and the charset.

Parameters
fileName String: the name of the file to read

charset Charset: the charset

Throws
IOException if the named file does not exist, is a directory rather than a regular file, or for some other reason cannot be opened for reading.