# FileReader
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Summary:[Inherited Fields](https://developer.android.com/reference/java/io/FileReader#inhfields)\|[Ctors](https://developer.android.com/reference/java/io/FileReader#pubctors)\|[Inherited Methods](https://developer.android.com/reference/java/io/FileReader#inhmethods)
# FileReader
`
public
class
FileReader
`
`
``
``
extends `[InputStreamReader](https://developer.android.com/reference/java/io/InputStreamReader)`
``
`
|---|---|---|--------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||||
| ↳ | [java.io.Reader](https://developer.android.com/reference/java/io/Reader) |||
| | ↳ | [java.io.InputStreamReader](https://developer.android.com/reference/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](https://developer.android.com/reference/java/nio/charset/Charset)or the platform's[default charset](https://developer.android.com/reference/java/nio/charset/Charset#defaultCharset()).
The`FileReader`is meant for reading streams of characters. For reading streams of raw bytes, consider using a`FileInputStream`.
**See also:**
- [InputStreamReader](https://developer.android.com/reference/java/io/InputStreamReader)
- [FileInputStream](https://developer.android.com/reference/java/io/FileInputStream)
## Summary
| ### Inherited fields |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| From class[java.io.Reader](https://developer.android.com/reference/java/io/Reader) |---------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------| | ` protected `[Object](https://developer.android.com/reference/java/lang/Object) | [lock](https://developer.android.com/reference/java/io/Reader#lock) The object used to synchronize operations on this stream. | |
| ### Public constructors ||
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[FileReader](https://developer.android.com/reference/java/io/FileReader#FileReader(java.io.File))`(`[File](https://developer.android.com/reference/java/io/File)` file) ` Creates a new`FileReader`, given the`File`to read, using the platform's[default charset](https://developer.android.com/reference/java/nio/charset/Charset#defaultCharset()). |
| ` `[FileReader](https://developer.android.com/reference/java/io/FileReader#FileReader(java.io.File,%20java.nio.charset.Charset))`(`[File](https://developer.android.com/reference/java/io/File)` file, `[Charset](https://developer.android.com/reference/java/nio/charset/Charset)` charset) ` Creates a new`FileReader`, given the`File`to read and the[charset](https://developer.android.com/reference/java/nio/charset/Charset). |
| ` `[FileReader](https://developer.android.com/reference/java/io/FileReader#FileReader(java.io.FileDescriptor))`(`[FileDescriptor](https://developer.android.com/reference/java/io/FileDescriptor)` fd) ` Creates a new`FileReader`, given the`FileDescriptor`to read, using the platform's[default charset](https://developer.android.com/reference/java/nio/charset/Charset#defaultCharset()). |
| ` `[FileReader](https://developer.android.com/reference/java/io/FileReader#FileReader(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` fileName) ` Creates a new`FileReader`, given the name of the file to read, using the platform's[default charset](https://developer.android.com/reference/java/nio/charset/Charset#defaultCharset()). |
| ` `[FileReader](https://developer.android.com/reference/java/io/FileReader#FileReader(java.lang.String,%20java.nio.charset.Charset))`(`[String](https://developer.android.com/reference/java/lang/String)` fileName, `[Charset](https://developer.android.com/reference/java/nio/charset/Charset)` charset) ` Creates a new`FileReader`, given the name of the file to read and the[charset](https://developer.android.com/reference/java/nio/charset/Charset). |
| ### Inherited methods |
|-----------------------|---|
| From class` `[java.io.InputStreamReader](https://developer.android.com/reference/java/io/InputStreamReader)` ` |-----------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` void` | ` `[close](https://developer.android.com/reference/java/io/InputStreamReader#close())`() ` Closes the stream and releases any system resources associated with it. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[getEncoding](https://developer.android.com/reference/java/io/InputStreamReader#getEncoding())`() ` Returns the name of the character encoding being used by this stream. | | ` int` | ` `[read](https://developer.android.com/reference/java/io/InputStreamReader#read())`() ` Reads a single character. | | ` int` | ` `[read](https://developer.android.com/reference/java/io/InputStreamReader#read(char[],%20int,%20int))`(char[] cbuf, int off, int len) ` Reads characters into a portion of an array. | | ` int` | ` `[read](https://developer.android.com/reference/java/io/InputStreamReader#read(java.nio.CharBuffer))`(`[CharBuffer](https://developer.android.com/reference/java/nio/CharBuffer)` target) ` Attempts to read characters into the specified character buffer. | | ` boolean` | ` `[ready](https://developer.android.com/reference/java/io/InputStreamReader#ready())`() ` Tells whether this stream is ready to be read. | ||
| From class` `[java.io.Reader](https://developer.android.com/reference/java/io/Reader)` ` |----------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract void` | ` `[close](https://developer.android.com/reference/java/io/Reader#close())`() ` Closes the stream and releases any system resources associated with it. | | ` void` | ` `[mark](https://developer.android.com/reference/java/io/Reader#mark(int))`(int readAheadLimit) ` Marks the present position in the stream. | | ` boolean` | ` `[markSupported](https://developer.android.com/reference/java/io/Reader#markSupported())`() ` Tells whether this stream supports the mark() operation. | | ` static `[Reader](https://developer.android.com/reference/java/io/Reader) | ` `[nullReader](https://developer.android.com/reference/java/io/Reader#nullReader())`() ` Returns a new`Reader`that reads no characters. | | ` int` | ` `[read](https://developer.android.com/reference/java/io/Reader#read())`() ` Reads a single character. | | ` abstract int` | ` `[read](https://developer.android.com/reference/java/io/Reader#read(char[],%20int,%20int))`(char[] cbuf, int off, int len) ` Reads characters into a portion of an array. | | ` int` | ` `[read](https://developer.android.com/reference/java/io/Reader#read(char[]))`(char[] cbuf) ` Reads characters into an array. | | ` int` | ` `[read](https://developer.android.com/reference/java/io/Reader#read(java.nio.CharBuffer))`(`[CharBuffer](https://developer.android.com/reference/java/nio/CharBuffer)` target) ` Attempts to read characters into the specified character buffer. | | ` boolean` | ` `[ready](https://developer.android.com/reference/java/io/Reader#ready())`() ` Tells whether this stream is ready to be read. | | ` void` | ` `[reset](https://developer.android.com/reference/java/io/Reader#reset())`() ` Resets the stream. | | ` long` | ` `[skip](https://developer.android.com/reference/java/io/Reader#skip(long))`(long n) ` Skips characters. | | ` long` | ` `[transferTo](https://developer.android.com/reference/java/io/Reader#transferTo(java.io.Writer))`(`[Writer](https://developer.android.com/reference/java/io/Writer)` out) ` Reads all characters from this reader and writes the characters to the given writer in the order that they are read. | ||
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object) | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`. | | ` int` | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(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](https://developer.android.com/reference/java/lang/Object#wait(long))`(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](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*. | ||
| From interface` `[java.io.Closeable](https://developer.android.com/reference/java/io/Closeable)` ` |------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract void` | ` `[close](https://developer.android.com/reference/java/io/Closeable#close())`() ` Closes this stream and releases any system resources associated with it. | ||
| From interface` `[java.lang.Readable](https://developer.android.com/reference/java/lang/Readable)` ` |-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract int` | ` `[read](https://developer.android.com/reference/java/lang/Readable#read(java.nio.CharBuffer))`(`[CharBuffer](https://developer.android.com/reference/java/nio/CharBuffer)` cb) ` Attempts to read characters into the specified character buffer. | ||
| From interface` `[java.lang.AutoCloseable](https://developer.android.com/reference/java/lang/AutoCloseable)` ` |------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract void` | ` `[close](https://developer.android.com/reference/java/lang/AutoCloseable#close())`() ` Closes this resource, relinquishing any underlying resources. | ||
## Public constructors
### FileReader
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public FileReader (File file)
```
Creates a new`FileReader`, given the`File`to read, using the platform's[default charset](https://developer.android.com/reference/java/nio/charset/Charset#defaultCharset()).
| Parameters ||
|--------|---------------------------------|
| `file` | `File`: the`File`to read
|
| Throws ||
|------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------|
| [FileNotFoundException](https://developer.android.com/reference/java/io/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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public FileReader (File file,
Charset charset)
```
Creates a new`FileReader`, given the`File`to read and the[charset](https://developer.android.com/reference/java/nio/charset/Charset).
| Parameters ||
|-----------|--------------------------------------------------------------------------------------------------|
| `file` | `File`: the`File`to read
|
| `charset` | `Charset`: the[charset](https://developer.android.com/reference/java/nio/charset/Charset)
|
| Throws ||
|----------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------|
| [IOException](https://developer.android.com/reference/java/io/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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public FileReader (FileDescriptor fd)
```
Creates a new`FileReader`, given the`FileDescriptor`to read, using the platform's[default charset](https://developer.android.com/reference/java/nio/charset/Charset#defaultCharset()).
| Parameters ||
|------|-----------------------------------------------------|
| `fd` | `FileDescriptor`: the`FileDescriptor`to read
|
### FileReader
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public FileReader (String fileName)
```
Creates a new`FileReader`, given the name of the file to read, using the platform's[default charset](https://developer.android.com/reference/java/nio/charset/Charset#defaultCharset()).
| Parameters ||
|------------|-----------------------------------------------|
| `fileName` | `String`: the name of the file to read
|
| Throws ||
|------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------|
| [FileNotFoundException](https://developer.android.com/reference/java/io/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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public FileReader (String fileName,
Charset charset)
```
Creates a new`FileReader`, given the name of the file to read and the[charset](https://developer.android.com/reference/java/nio/charset/Charset).
| Parameters ||
|------------|--------------------------------------------------------------------------------------------------|
| `fileName` | `String`: the name of the file to read
|
| `charset` | `Charset`: the[charset](https://developer.android.com/reference/java/nio/charset/Charset)
|
| Throws ||
|----------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------|
| [IOException](https://developer.android.com/reference/java/io/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. |