|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.io.InputStream | +--java.io.FileInputStream
ファイルシステムのファイルから入力バイトを取得します。どのファイルが有効かはホスト環境に依存します。
FileInputStream
は、生のバイト (イメージデータなど) のストリームを読み込むときに使用します。文字のストリームを読み込むときは、FileReader
を使用してください。
File
,
FileDescriptor
,
FileOutputStream
コンストラクタの概要 | |
FileInputStream(File file)
ファイルシステムの実際のファイル ( File オブジェクト file により指定) に接続することにより、FileInputStream を作成します。 |
|
FileInputStream(FileDescriptor fdObj)
ファイルシステムの実際のファイルへの既存の接続を表すファイル記述子 fdObj を使用して、FileInputStream を作成します。
|
|
FileInputStream(String name)
ファイルシステムの実際のファイル (パス名 name により指定) に接続することにより、FileInputStream を作成します。 |
メソッドの概要 | |
int |
available()
ブロックせずにファイル入力ストリームから読み込むことができるバイト数を返します。 |
void |
close()
ファイル入力ストリームを閉じ、このストリームに関連するシステムリソースを解放します。 |
protected void |
finalize()
ファイル入力ストリームへの参照が存在しなくなったときに、このストリームの close メソッドが確実に呼び出されるようにします。 |
FileChannel |
getChannel()
このファイル入力ストリームに関連付けられた、一意の FileChannel オブジェクトを返します。
|
FileDescriptor |
getFD()
この FileInputStream に使用されているファイルシステムの実際のファイルへの接続を表す FileDescriptor オブジェクトを返します。 |
int |
read()
入力ストリームから 1 バイトを読み込みます。 |
int |
read(byte[] b)
入力ストリームから最大 b.length バイトをバイト配列に読み込みます。 |
int |
read(byte[] b,
int off,
int len)
入力ストリームからバイト配列へ最大 len バイトのデータを読み込みます。 |
long |
skip(long n)
入力ストリームからのデータを n バイトだけスキップして破棄します。 |
クラス java.io.InputStream から継承したメソッド |
mark, markSupported, reset |
クラス java.lang.Object から継承したメソッド |
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
public FileInputStream(String name) throws FileNotFoundException
name
により指定) に接続することにより、FileInputStream
を作成します。このファイルの接続を表すために、新しい FileDescriptor
オブジェクトが生成されます。
まず、セキュリティマネージャが存在する場合、checkRead
メソッドが name
引数を引数として呼び出されます。
指定されたファイルが存在しないか、普通のファイルではなくディレクトリであるか、またはなんらかの理由で開くことができない場合は、FileNotFoundException
がスローされます。
name
- システム依存のファイル名
FileNotFoundException
- ファイルが存在しないか、普通のファイルではなくディレクトリであるか、またはなんらかの理由で開くことができない場合
SecurityException
- セキュリティマネージャが存在し、checkRead
メソッドがファイルへの読み込みアクセスを拒否する場合SecurityManager.checkRead(java.lang.String)
public FileInputStream(File file) throws FileNotFoundException
File
オブジェクト file
により指定) に接続することにより、FileInputStream
を作成します。このファイルの接続を表すために、新しい FileDescriptor
オブジェクトが生成されます。
まず、セキュリティマネージャが存在する場合、checkRead
メソッドが、file
引数によって表されるパスを引数として呼び出されます。
指定されたファイルが存在しないか、普通のファイルではなくディレクトリであるか、またはなんらかの理由で開くことができない場合は、FileNotFoundException
がスローされます。
file
- 読み込みのために開かれるファイル
FileNotFoundException
- ファイルが存在しないか、普通のファイルではなくディレクトリであるか、またはなんらかの理由で開くことができない場合
SecurityException
- セキュリティマネージャが存在し、checkRead
メソッドがファイルへの読み込みアクセスを拒否する場合File.getPath()
,
SecurityManager.checkRead(java.lang.String)
public FileInputStream(FileDescriptor fdObj)
fdObj
を使用して、FileInputStream
を作成します。
セキュリティマネージャが存在する場合、checkRead
メソッドがファイル記述子 fdObj
を引数として呼び出されます。これは、ファイル記述子を読み込めるかどうかを確認するためです。ファイル記述子への読み込みアクセスが拒否された場合、SecurityException
がスローされます。
fdObj
が null の場合は、NullPointerException
がスローされます。
fdObj
- 読み込みのために開かれるファイル記述子
SecurityException
- セキュリティマネージャが存在し、checkRead
メソッドがファイル記述子への読み込みアクセスを拒否する場合SecurityManager.checkRead(java.io.FileDescriptor)
メソッドの詳細 |
public int read() throws IOException
InputStream
内の read
-1
IOException
- 入出力エラーが発生した場合public int read(byte[] b) throws IOException
b.length
バイトをバイト配列に読み込みます。このメソッドはなんらかの入力が可能になるまでブロックします。
InputStream
内の read
b
- データの読み込み先のバッファ
-1
IOException
- 入出力エラーが発生した場合InputStream.read(byte[], int, int)
public int read(byte[] b, int off, int len) throws IOException
len
バイトのデータを読み込みます。このメソッドは、入力が可能になるまでブロックします。
InputStream
内の read
b
- データの読み込み先のバッファoff
- データの開始オフセットlen
- 読み込まれる最大バイト数
-1
IOException
- 入出力エラーが発生した場合InputStream.read()
public long skip(long n) throws IOException
n
バイトだけスキップして破棄します。さまざまな理由から、skip
メソッドは、指定されたよりも少ないバイト数 (0
の場合もある) しかスキップしないことがあります。実際にスキップしたバイト数を返します。
InputStream
内の skip
n
- スキップするバイト数
IOException
- 入出力エラーが発生した場合public int available() throws IOException
InputStream
内の available
IOException
- 入出力エラーが発生した場合public void close() throws IOException
このストリームにチャネルが関連付けられている場合は、そのチャネルも閉じます。
InputStream
内の close
IOException
- 入出力エラーが発生した場合public final FileDescriptor getFD() throws IOException
FileInputStream
に使用されているファイルシステムの実際のファイルへの接続を表す FileDescriptor
オブジェクトを返します。
IOException
- 入出力エラーが発生した場合FileDescriptor
public FileChannel getChannel()
FileChannel
オブジェクトを返します。
返されたチャネルの
の初期値は、それまでにファイルから読み込まれたバイト数に設定されます。このストリームからバイトを読み込むたびに、チャネルの位置が増分されます。チャネルの位置を明示的に変更した場合またはバイトの読み込みによって変更された場合は、このストリームのファイル位置も変更されます。
position
protected void finalize() throws IOException
close
メソッドが確実に呼び出されるようにします。
Object
内の finalize
IOException
- 入出力エラーが発生した場合close()
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.