|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.io.InputStream java.io.FileInputStream
public class FileInputStream
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
の場合もある) をスキップします。n
が負の場合は、InputStream
スーパークラスの skip
メソッドが何も行わない場合でも、IOException
がスローされます。実際にスキップされたバイト数が返されます。
このメソッドによってスキップされるバイト数が、バッキングファイルに残ったバイト数より多い場合があります。この場合、例外は生成されず、バッキングファイルの EOF より後ろへスキップする結果になります。この状態でストリームから読み取ろうとすると、ファイルの終わりを示す -1 が返されます。
InputStream
内の skip
n
- スキップするバイト数
IOException
- n が負の場合、または入出力エラーが発生した場合public int available() throws IOException
InputStream
内の available
IOException
- 入出力エラーが発生した場合public void close() throws IOException
このストリームにチャネルが関連付けられている場合は、そのチャネルも閉じます。
Closeable
内の close
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 Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。