|
CDC 1.1.2 | |||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.io.InputStream java.io.FileInputStream
public class FileInputStream
FileInputStream
は、ファイルシステムから入力バイトを取得します。どのファイルが有効であるかはホスト環境に依存します。
FileInputStream
は、イメージデータなどの raw バイトのストリームを読み込むときに使用します。文字のストリームを読み込むときは、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 メソッドが確実に呼び出されるようにします。 |
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
を作成します。
セキュリティーマネージャーが存在する場合は、ファイル記述子を読み込んでもよいかどうかを確認するために、ファイル記述子 fdObj
を引数として checkRead
メソッドが呼び出されます。ファイル記述子への読み込みアクセスが拒否されると、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
protected void finalize() throws IOException
close
メソッドが確実に呼び出されるようにします。
Object
内の finalize
IOException
- 入出力エラーが発生した場合close()
|
CDC 1.1.2 | |||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |