public class FileImageInputStream extends ImageInputStreamImpl
File
またはRandomAccessFile
から入力を取得するImageInputStream
の実装です。 ファイルの内容は、オブジェクトの有効期間中は安定していると見なされます。 bitOffset, byteOrder, flushedPos, streamPos
コンストラクタ | 説明 |
---|---|
FileImageInputStream(File f) |
指定された
File から読み込むFileImageInputStream を構築します。 |
FileImageInputStream(RandomAccessFile raf) |
指定された
RandomAccessFile から読み込むFileImageInputStream を構築します。 |
修飾子と型 | メソッド | 説明 |
---|---|---|
void |
close() |
ストリームを閉じます。
|
protected void |
finalize() |
ガベージ・コレクションの前にこのオブジェクトをファイナライズします。
|
long |
length() |
基本となるファイルの長さ、またはそれが不明な場合は
-1 を返します。 |
int |
read() |
ストリームから1バイトを読み込み、それを0から255までの
int として返します。 |
int |
read(byte[] b, int off, int len) |
ストリームから最大
len バイトを読み込み、b にインデックスoff から格納します。 |
void |
seek(long pos) |
現在のストリーム位置を目的の位置に設定します。
|
checkClosed, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, mark, read, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedShort, readUTF, reset, setBitOffset, setByteOrder, skipBytes, skipBytes
public FileImageInputStream(File f) throws FileNotFoundException, IOException
File
から読み込むFileImageInputStream
を構築します。
このオブジェクトの構築時から読込みメソッドを最後に呼び出すまでの間、ファイルの内容を変更してはいけません。
f
- 読込み元のFile
。IllegalArgumentException
- f
がnull
の場合。SecurityException
- セキュリティ・マネージャが存在し、ファイルへの読込みアクセスが許可されない場合。FileNotFoundException
- f
がディレクトリであるか、ほかの何らかの理由で読込み用に開くことができない場合。IOException
- 入出力エラーが発生した場合。public FileImageInputStream(RandomAccessFile raf)
RandomAccessFile
から読み込むFileImageInputStream
を構築します。
このオブジェクトの構築時から読込みメソッドを最後に呼び出すまでの間、ファイルの内容を変更してはいけません。
raf
- 読込み元のRandomAccessFile
。IllegalArgumentException
- raf
がnull
の場合。public int read() throws IOException
ImageInputStreamImpl
int
として返します。 EOFに達すると-1
を返します。
サブクラスでこのメソッドを実装する必要があります。 サブクラス実装で終了する前にストリーム位置を更新します。
ストリーム内のビット・オフセットは、読込みを行う前に0にリセットする必要があります。
read
、インタフェースImageInputStream
read
、クラスImageInputStreamImpl
-1
。IOException
- ストリームが閉じられている場合。public int read(byte[] b, int off, int len) throws IOException
ImageInputStreamImpl
len
バイトを読み込み、b
にインデックスoff
から格納します。 ストリームの終わりに達したためにバイトを読み込めない場合は、-1
を返します。
ストリーム内のビット・オフセットは、読込みを行う前に0にリセットする必要があります。
サブクラスでこのメソッドを実装する必要があります。 サブクラス実装で終了する前にストリーム位置を更新します。
read
、インタフェースImageInputStream
read
、クラスImageInputStreamImpl
b
- 書き込まれるバイト配列。off
- 書込み先のb
内の開始位置。len
- 読み込む最大バイト数。-1
。IOException
- 入出力エラーが発生した場合。public long length()
-1
を返します。length
、インタフェースImageInputStream
length
、クラスImageInputStreamImpl
long
)、または-1
。public void seek(long pos) throws IOException
ImageInputStream
pos
がgetflushedPosition
から返されるフラッシュ位置よりも小さい場合は、IndexOutOfBoundsException
がスローされます。
シークでファイルの終わりを通過することは正常であり、java.io.EOFException
は読込みの場合のみスローされます。
seek
、インタフェースImageInputStream
seek
、クラスImageInputStreamImpl
pos
- 目的のファイル・ポインタ位置を示すlong
。IOException
- その他の入出力エラーが発生した場合。public void close() throws IOException
ImageInputStream
IOException
がスローされるか不正な動作が実行される場合があります。 このメソッドを呼び出すと、このインタフェースを実装するクラスが、メモリー、ディスク・スペース、またはファイル記述子などのストリームに関連するリソースを解放できます。 close
、インタフェースCloseable
close
、インタフェースAutoCloseable
close
、インタフェースImageInputStream
close
、クラスImageInputStreamImpl
IOException
- 入出力エラーが発生した場合。protected void finalize() throws Throwable
close
メソッドを呼び出して、開いている入力ソースをすべて閉じます。 このメソッドを、アプリケーション・コードから呼び出してはいけません。 finalize
、クラスImageInputStreamImpl
Throwable
- スーパー・クラスのファイナライズ時にエラーが発生した場合。WeakReference
, PhantomReference
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。