public class FileImageOutputStream extends ImageOutputStreamImpl
File
またはRandomAccessFile
に直接書き込むImageOutputStream
の実装です。bitOffset, byteOrder, flushedPos, streamPos
コンストラクタと説明 |
---|
FileImageOutputStream(File f)
指定された
File に書き込むFileImageOutputStream を構築します。 |
FileImageOutputStream(RandomAccessFile raf)
指定された
RandomAccessFile に書き込むFileImageOutputStream を構築します。 |
修飾子と型 | メソッドと説明 |
---|---|
void |
close()
ストリームを閉じます。
|
protected void |
finalize()
ガベージ・コレクションの前にこのオブジェクトをファイナライズします。
|
long |
length()
ストリームが未知の長さであることを示す
-1L を返します。 |
int |
read()
ストリームから1バイトを読み込み、それを0から255までの
int として返します。 |
int |
read(byte[] b, int off, int len)
ストリームから最大
len バイトを読み込み、b にインデックスoff から格納します。 |
void |
seek(long pos)
現在のストリーム位置を設定してビット・オフセットを0にリセットします。
|
void |
write(byte[] b, int off, int len)
バイトのシーケンスをストリームの現在位置に書き込みます。
|
void |
write(int b)
ストリームの現在の位置に1バイト書き込みます。
|
flushBits, write, writeBit, writeBits, writeBoolean, writeByte, writeBytes, writeChar, writeChars, writeChars, writeDouble, writeDoubles, writeFloat, writeFloats, writeInt, writeInts, writeLong, writeLongs, writeShort, writeShorts, writeUTF
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
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
flushBefore
flush, 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 FileImageOutputStream(File f) throws FileNotFoundException, IOException
File
に書き込むFileImageOutputStream
を構築します。f
- 書込み先のFile
。IllegalArgumentException
- f
がnull
の場合。SecurityException
- セキュリティ・マネージャが存在し、ファイルへの書込みアクセスが許可されない場合。FileNotFoundException
- f
が通常のファイルを示さないか、ほかの何らかの理由で読み込みおよび書込み用に開くことができない場合。IOException
- 入出力エラーが発生した場合。public FileImageOutputStream(RandomAccessFile raf)
RandomAccessFile
に書き込むFileImageOutputStream
を構築します。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 void write(int b) throws IOException
ImageOutputStream
b
の上位24ビットは無視されます。
ストリーム内のビット・オフセットがゼロでない場合、現在のバイトの残りは0でパディングされ、最初に書き込まれます。書込み後は、ビット・オフセットは0です。実装側は、ImageOutputStreamImpl
のflushBits
メソッドを使用してこれを保証できます。
write
、インタフェース: DataOutput
write
、インタフェース: ImageOutputStream
write
、クラス: ImageOutputStreamImpl
b
- 下位8ビットが書き込まれるint
。IOException
- 入出力エラーが発生した場合。public void write(byte[] b, int off, int len) throws IOException
ImageOutputStream
len
が0の場合、何も書き込みません。バイトb[off]
を最初に書き込み、次にバイトb[off+1]
を書き込む、という具合になります。
ストリーム内のビット・オフセットがゼロでない場合、現在のバイトの残りは0でパディングされ、最初に書き込まれます。書込み後は、ビット・オフセットは0です。実装側は、ImageOutputStreamImpl
のflushBits
メソッドを使用してこれを保証できます。
write
、インタフェース: DataOutput
write
、インタフェース: ImageOutputStream
write
、クラス: ImageOutputStreamImpl
b
- 書き込まれるbyte
配列。off
- データの開始オフセット。len
- 書き込むbyte
数。IOException
- 入出力エラーが発生した場合。public long length()
ImageInputStreamImpl
-1L
を返します。サブクラスでこのメソッドをオーバーライドして、実際の長さの情報を指定する必要があります。length
、インタフェース: ImageInputStream
length
、クラス: ImageInputStreamImpl
public void seek(long pos) throws IOException
EOFException
は読込みの場合のみスローされます。書込みが実行されるまで、ファイル長は増加しません。seek
、インタフェース: ImageInputStream
seek
、クラス: ImageInputStreamImpl
pos
- 目的のファイル・ポインタ位置を示すlong
。IndexOutOfBoundsException
- pos
がフラッシュ位置よりも小さい場合。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, 2014, Oracle and/or its affiliates. All rights reserved.