|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object jcontrol.io.FileInputStream
public class FileInputStream
A FileInputStream
obtains input bytes
from a file in a file system. What files
are available depends on the host environment.
FileInputStream
is meant for reading streams of raw bytes
such as image data.
Constructor Summary | |
---|---|
FileInputStream(File file)
Creates a FileInputStream by
opening a connection to an actual file,
the file named by the File
object file in the file system. |
|
FileInputStream(String name)
Creates a FileInputStream by
opening a connection to an actual file,
the file named by the path name name
in the file system. |
Method Summary | |
---|---|
int |
available()
Returns the number of bytes that can be read from this file input stream without blocking. |
void |
close()
Closes this file input stream and releases any system resources associated with the stream. |
protected void |
finalize()
Free internal data structures used by this file object. |
void |
mark(int readlimit)
NOTE: not supported! |
boolean |
markSupported()
NOTE: not supported! |
int |
read()
Reads a byte of data from this input stream. |
int |
read(byte[] b)
Reads up to b.length bytes of data from this input
stream into an array of bytes. |
int |
read(byte[] b,
int off,
int len)
Reads up to len bytes of data from this input stream
into an array of bytes. |
void |
reset()
NOTE: not supported! |
int |
skip(int n)
Skips over and discards n bytes of data from the
input stream. |
Methods inherited from class java.lang.Object |
---|
clone, equals, getClass, notifyAll, toString, wait |
Constructor Detail |
---|
public FileInputStream(String name) throws FileNotFoundException, IOException
FileInputStream
by
opening a connection to an actual file,
the file named by the path name name
in the file system. A new FileDescriptor
object is created to represent this file
connection.
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 then a
FileNotFoundException
is thrown.
name
- the system-dependent file name.
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.
IOException
public FileInputStream(File file) throws FileNotFoundException, IOException
FileInputStream
by
opening a connection to an actual file,
the file named by the File
object file
in the file system.
A new FileDescriptor
object
is created to represent this file connection.
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 then a
FileNotFoundException
is thrown.
file
- the file to be opened for reading.
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.
IOException
File.getPath()
Method Detail |
---|
public int read() throws IOException
read
in interface BasicInputStream
IOException
- if an I/O error occurs.public int read(byte[] b) throws IOException
b.length
bytes of data from this input
stream into an array of bytes. This method blocks until some input
is available.
read
in interface BasicInputStream
b
- the buffer into which the data is read.
-1
if there is no more data because the end of
the file has been reached.
IOException
- if an I/O error occurs.InputStream.read(byte[], int, int)
public int read(byte[] b, int off, int len) throws IOException
len
bytes of data from this input stream
into an array of bytes. This method blocks until some input is
available.
read
in interface BasicInputStream
b
- the buffer into which the data is read.off
- the start offset of the data.len
- the maximum number of bytes read.
-1
if there is no more data because the end of
the file has been reached.
IOException
- if an I/O error occurs.InputStream.read()
public int skip(int n) throws IOException
n
bytes of data from the
input stream. The skip
method may, for a variety of
reasons, end up skipping over some smaller number of bytes,
possibly 0
. The actual number of bytes skipped is returned.
skip
in interface BasicInputStream
n
- the number of bytes to be skipped.
IOException
- if an I/O error occurs.public int available() throws IOException
available
in interface BasicInputStream
IOException
- if an I/O error occurs.public void close() throws IOException
If this stream has an associated channel then the channel is closed as well.
close
in interface BasicInputStream
IOException
- if an I/O error occurs.protected void finalize()
public void mark(int readlimit)
mark
in interface BasicInputStream
readlimit
- the maximum limit of bytes that can be read before
the mark position becomes invalid.public boolean markSupported()
markSupported
in interface BasicInputStream
true
if this stream instance supports the mark
and reset methods; false
otherwise.public void reset() throws IOException
reset
in interface BasicInputStream
IOException
- if this stream has not been makred or if the
mark has been invalidated.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |