ImageInputStreamImpl (Java Platform SE 8)

java.lang.Object
- javax.imageio.stream.ImageInputStreamImpl

すべての実装されたインタフェース:

Closeable, DataInput, AutoCloseable, ImageInputStream

直系の既知のサブクラス:

FileCacheImageInputStream, FileImageInputStream, ImageOutputStreamImpl, MemoryCacheImageInputStream
```
public abstract class ImageInputStreamImpl
extends Object
implements ImageInputStream
```
ImageInputStreamインタフェースを実装する抽象クラスです。このクラスの目的は、サブクラスで実装する必要のあるメソッドの数を減らすことです。
特に、このクラスはバイト順の解釈、バッファリング、マーク付けとリセット、破棄、クローズ、および廃棄の大半またはすべてを処理します。

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`protected int`	`bitOffset` ストリーム内の現在のビット・オフセットです。
`protected ByteOrder`	`byteOrder` 列挙クラス`java.nio.ByteOrder`のインスタンスで表されるストリームのバイト順で、`ByteOrder.BIG_ENDIAN`はネットワーク・バイト順、`ByteOrder.LITTLE_ENDIAN`は逆順を示します。
`protected long`	`flushedPos` それより前のデータが破棄される位置です。
`protected long`	`streamPos` ストリーム内の現在の読込み位置です。

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

ImageInputStreamImpl()
ImageInputStreamImplを構築します。

コンストラクタ
コンストラクタと説明
`ImageInputStreamImpl()` `ImageInputStreamImpl`を構築します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッド具象メソッド
修飾子と型	メソッドと説明
`protected void`	`checkClosed()` ストリームが閉じられていた場合は`IOException`をスローします。
`void`	`close()` ストリームを閉じます。
`protected void`	`finalize()` ガベージ・コレクションの前にこのオブジェクトをファイナライズします。
`void`	`flush()` 現在のストリーム位置より前の初期のストリーム位置を破棄します。
`void`	`flushBefore(long pos)` 指示された位置より前のストリームの先頭部分を破棄します。
`int`	`getBitOffset()` 現在のビット・オフセットを0から7までの整数として返します。
`ByteOrder`	`getByteOrder()` このストリームから読み込まれるデータのバイト順を、`java.nio.ByteOrder`列挙のインスタンスとして返します。
`long`	`getFlushedPosition()` シークが実行されるストリーム内の一番初期の位置を返します。
`long`	`getStreamPosition()` ストリームの現在のバイト位置を返します。
`boolean`	`isCached()` デフォルトの実装ではfalseを返します。
`boolean`	`isCachedFile()` デフォルトの実装ではfalseを返します。
`boolean`	`isCachedMemory()` デフォルトの実装ではfalseを返します。
`long`	`length()` ストリームが未知の長さであることを示す`-1L`を返します。
`void`	`mark()` マーク付けされた位置のスタック上に現在のストリーム位置をプッシュします。
`abstract int`	`read()` ストリームから1バイトを読み込み、それを0から255までの`int`として返します。
`int`	`read(byte[] b)` `read(b, 0, b.length)`を呼び出す簡易メソッドです。
`abstract int`	`read(byte[] b, int off, int len)` ストリームから最大`len`バイトを読み込み、`b`にインデックス`off`から格納します。
`int`	`readBit()` ストリームから1ビットを読み込み、それを値`0`または`1`の`int`として返します。
`long`	`readBits(int numBits)` ストリームからビット列を読み込み、`long`として返します。読み込んだ最初のビットが出力の最上位ビットになります。
`boolean`	`readBoolean()` ストリームから1バイトを読み込み、0でない場合は`true`の`boolean`値を返し、0の場合は`false`を返します。
`byte`	`readByte()` ストリームから1バイトを読み込み、それを`byte`値として返します。
`void`	`readBytes(IIOByteBuffer buf, int len)` ストリームから`len`バイトまでを読み込み、指定された`IIOByteBuffer`を変更してデータを検出可能なバイト配列、オフセット、および長さを示します。
`char`	`readChar()` `readUnsignedShort`と同等、ただし結果は`char`データ型を使用して返されます。
`double`	`readDouble()` ストリームから8バイトを読み込み、現在のバイト順に従って概念上それらを連結して、結果を`double`値として返します。
`float`	`readFloat()` ストリームから4バイトを読み込み、現在のバイト順に従って概念上それらを連結して、結果を`float`値として返します。
`void`	`readFully(byte[] b)` ストリームから`b.length`バイトを読み込み、`b`にインデックス`0`から格納します。
`void`	`readFully(byte[] b, int off, int len)` ストリームから`len`バイトを読み込み、`b`にインデックス`off`から格納します。
`void`	`readFully(char[] c, int off, int len)` ストリームから現在のバイト順に従って`len`バイトのchar (符号なし16ビット整数)値を読み込み、それらを`c`にインデックス`off`から格納します。
`void`	`readFully(double[] d, int off, int len)` ストリームから現在のバイト順に従って`len`バイトのdouble (64ビットIEEE倍精度浮動小数点数)値を読み込み、それらを`d`にインデックス`off`から格納します。
`void`	`readFully(float[] f, int off, int len)` ストリームから現在のバイト順に従って`len`バイトのfloat (32ビットIEEE単精度浮動小数点数)値を読み込み、それらを`f`にインデックス`off`から格納します。
`void`	`readFully(int[] i, int off, int len)` ストリームから現在のバイト順に従って`len`バイトのint (符号付き32ビット整数)値を読み込み、それらを`i`にインデックス`off`から格納します。
`void`	`readFully(long[] l, int off, int len)` ストリームから現在のバイト順に従って`len`バイトのlong (符号付き64ビット整数)値を読み込み、それらを`l`にインデックス`off`から格納します。
`void`	`readFully(short[] s, int off, int len)` ストリームから現在のバイト順に従って`len`バイトのshort (符号付き16ビット整数)値を読み込み、それらを`s`にインデックス`off`から格納します。
`int`	`readInt()` ストリームから4バイトを読み込み、現在のバイト順に従って概念上それらを連結して、結果を`int`値として返します。
`String`	`readLine()` 入力ストリームから、次の行のテキストを読み込みます。
`long`	`readLong()` ストリームから8バイトを読み込み、現在のバイト順に従って概念上それらを連結して、結果を`long`値として返します。
`short`	`readShort()` ストリームから2バイトを読み込み、現在のバイト順に従って概念上それらを連結して、結果を`short`値として返します。
`int`	`readUnsignedByte()` ストリームからバイトを読み込んで、概念上、整数に変換し、符号拡張ビットを取り除くためにそれを`0xff`でマスクして、`byte`値として返します。
`long`	`readUnsignedInt()` ストリームから4バイトを読み込んで現在のバイト順に従って概念上それらを連結し、結果の値をlongに変換して、符号拡張ビットを取り除くために`0xffffffffL`でマスクします。その結果を符号なし`long`値として返します。
`int`	`readUnsignedShort()` ストリームから2バイトを読み込んで、現在のバイト順に従って概念上それらを連結し、結果として得られる値を`int`に変換して、符号拡張ビットを取り除くために`0xffff`でマスクします。その結果を符号なし`int`値として返します。
`String`	`readUTF()` 修正UTF-8形式でエンコードされた文字列を読み込みます。
`void`	`reset()` マーク付けされた位置のスタックから現在のストリーム・バイトおよびビット位置をリセットします。
`void`	`seek(long pos)` 現在のストリーム位置を目的の位置に設定します。
`void`	`setBitOffset(int bitOffset)` ビット・オフセットに0から7までの整数を設定します。
`void`	`setByteOrder(ByteOrder byteOrder)` このストリームからの今後のデータ値の読込みのために、バイト順を設定します。
`int`	`skipBytes(int n)` `seek(getStreamPosition()+n)`を呼び出して、現在のストリーム位置を前進させます。
`long`	`skipBytes(long n)` `seek(getStreamPosition()+n)`を呼び出して、現在のストリーム位置を前進させます。

クラス java.lang.Objectから継承されたメソッド
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - byteOrder
```
protected ByteOrder byteOrder
```
    列挙クラスjava.nio.ByteOrderのインスタンスで表されるストリームのバイト順で、ByteOrder.BIG_ENDIANはネットワーク・バイト順、ByteOrder.LITTLE_ENDIANは逆順を示します。デフォルト値はByteOrder.BIG_ENDIANです。
  - streamPos
```
protected long streamPos
```
    ストリーム内の現在の読込み位置です。サブクラスがオーバーライドする、読込み位置を変更するすべてのメソッドからこの値を保護し、現状のままに保つことは、サブクラスの責任です。
  - bitOffset
```
protected int bitOffset
```
    ストリーム内の現在のビット・オフセットです。サブクラスがオーバーライドする、ビット・オフセットを変更するすべてのメソッドからこの値を保護し、現状のままに保つことは、サブクラスの責任です。
  - flushedPos
```
protected long flushedPos
```
    それより前のデータが破棄される位置です。これより前の位置にシークすることはできません。flushedPosは常に0以上になります。
- コンストラクタの詳細
  - ImageInputStreamImpl
```
public ImageInputStreamImpl()
```
    ImageInputStreamImplを構築します。
- メソッドの詳細
  - checkClosed
```
protected final void checkClosed()
                          throws IOException
```
    ストリームが閉じられていた場合はIOExceptionをスローします。サブクラスは、ストリームが開いていることが必要などのメソッドからも、このメソッドを呼び出すことができます。
    
    例外:
    
    IOException - ストリームが閉じられている場合。
  - setByteOrder
```
public void setByteOrder(ByteOrder byteOrder)
```
    インタフェースからコピーされた説明: ImageInputStream
    
    このストリームからの今後のデータ値の読込みのために、バイト順を設定します。たとえば、’0x01 0x02 0x03 0x04’のバイト・シーケンスは、4バイト整数として読み込まれた場合、ネットワーク・バイト順を使用すると‘0x01020304’の値となり、逆バイト順では‘0x04030201’の値となります。
    列挙クラスjava.nio.ByteOrderを使用してバイト順を指定します。値ByteOrder.BIG_ENDIANでは、高位のバイトが先頭となる、いわゆるビッグエンディアン(ネットワーク・バイト順)が指定されます。MotorolaとSparcプロセッサはデータをこの形式で格納します。一方Intelプロセッサは、データを逆順のByteOrder.LITTLE_ENDIANで格納します。
    バイト順は、readBitsメソッドから返される結果(ImageOutputStream.writeBitsにより書き込まれる値)には影響を与えません。
    
    定義:
    
    setByteOrder、インタフェース: ImageInputStream
    
    パラメータ:
    
    byteOrder - ByteOrder.BIG_ENDIANまたはjava.nio.ByteOrder.LITTLE_ENDIANのいずれか(今後の読込みでネットワーク・バイト順またはその逆順のどちらを使用するかを示す)。
    
    関連項目:
    
    ByteOrder, ImageInputStream.getByteOrder(), ImageInputStream.readBits(int)
  - getByteOrder
```
public ByteOrder getByteOrder()
```
    インタフェースからコピーされた説明: ImageInputStream
    
    このストリームから読み込まれるデータのバイト順を、java.nio.ByteOrder列挙のインスタンスとして返します。
    
    定義:
    
    getByteOrder、インタフェース: ImageInputStream
    
    戻り値:
    
    ByteOrder.BIG_ENDIANまたはByteOrder.LITTLE_ENDIANのいずれか(使用されるバイト順を示す)。
    
    関連項目:
    
    ByteOrder, ImageInputStream.setByteOrder(java.nio.ByteOrder)
  - read
```
public abstract int read()
                  throws IOException
```
    ストリームから1バイトを読み込み、それを0から255までのintとして返します。EOFに達すると-1を返します。
    サブクラスでこのメソッドを実装する必要があります。サブクラス実装で終了する前にストリーム位置を更新します。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットする必要があります。
    
    定義:
    
    read、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリーム内の次のバイトの値。または、EOFに達した場合は-1。
    
    例外:
    
    IOException - ストリームが閉じられている場合。
  - read
```
public int read(byte[] b)
         throws IOException
```
    read(b, 0, b.length)を呼び出す簡易メソッドです。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    read、インタフェース: ImageInputStream
    
    パラメータ:
    
    b - 書き込まれるバイト配列。
    
    戻り値:
    
    実際に読み込まれたバイト数、またはEOFを示す-1。
    
    例外:
    
    NullPointerException - bがnullの場合。
    
    IOException - 入出力エラーが発生した場合。
  - read
```
public abstract int read(byte[] b,
                         int off,
                         int len)
                  throws IOException
```
    ストリームから最大lenバイトを読み込み、bにインデックスoffから格納します。ストリームの終わりに達したためにバイトを読み込めない場合は、-1を返します。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットする必要があります。
    サブクラスでこのメソッドを実装する必要があります。サブクラス実装で終了する前にストリーム位置を更新します。
    
    定義:
    
    read、インタフェース: ImageInputStream
    
    パラメータ:
    
    b - 書き込まれるバイト配列。
    
    off - 書込み先のb内の開始位置。
    
    len - 読み込む最大バイト数。
    
    戻り値:
    
    実際に読み込まれたバイト数、またはEOFを示す-1。
    
    例外:
    
    IndexOutOfBoundsException - offが負の値の場合、lenが負の値の場合、またはoff+lenがb.lengthより大きい場合。
    
    NullPointerException - bがnullの場合。
    
    IOException - 入出力エラーが発生した場合。
  - readBytes
```
public void readBytes(IIOByteBuffer buf,
                      int len)
               throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームからlenバイトまでを読み込み、指定されたIIOByteBufferを変更してデータを検出可能なバイト配列、オフセット、および長さを示します。呼出し側で、IIOByteBufferで検出されたデータを変更してはいけません。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readBytes、インタフェース: ImageInputStream
    
    パラメータ:
    
    buf - 変更されるIIOByteBufferオブジェクト。
    
    len - 読み込む最大byte数。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
  - readBoolean
```
public boolean readBoolean()
                    throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから1バイトを読み込み、0でない場合はtrueのboolean値を返し、0の場合はfalseを返します。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readBoolean、インタフェース: DataInput
    
    定義:
    
    readBoolean、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームからのboolean値
    
    例外:
    
    EOFException - ストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - readByte
```
public byte readByte()
              throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから1バイトを読み込み、それをbyte値として返します。0x00から0x7fまでのバイト値は0から127までの整数を表します。0x80から0xffまでの値は-128から/1までの負の値を表します。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readByte、インタフェース: DataInput
    
    定義:
    
    readByte、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームからの符号付きバイト値
    
    例外:
    
    EOFException - ストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - readUnsignedByte
```
public int readUnsignedByte()
                     throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームからバイトを読み込んで、概念上、整数に変換し、符号拡張ビットを取り除くためにそれを0xffでマスクして、byte値として返します。
    したがって、0x00から0x7fまでのバイト値は0から127までの整数値として単純に返されます。通常は負のbyte値を表す0x80から0xffまでの値は、128から255までの正の整数に対応付けされます。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readUnsignedByte、インタフェース: DataInput
    
    定義:
    
    readUnsignedByte、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームからの符号なしバイト値
    
    例外:
    
    EOFException - ストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - readShort
```
public short readShort()
                throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから2バイトを読み込み、現在のバイト順に従って概念上それらを連結して、結果をshort値として返します。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readShort、インタフェース: DataInput
    
    定義:
    
    readShort、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームからの符号付きshort値
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    ImageInputStream.getByteOrder()
  - readUnsignedShort
```
public int readUnsignedShort()
                      throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから2バイトを読み込んで、現在のバイト順に従って概念上それらを連結し、結果として得られる値をintに変換して、符号拡張ビットを取り除くために0xffffでマスクします。その結果を符号なしint値として返します。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readUnsignedShort、インタフェース: DataInput
    
    定義:
    
    readUnsignedShort、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームからの符号なしshort値のint
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    ImageInputStream.getByteOrder()
  - readChar
```
public char readChar()
              throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    readUnsignedShortと同等、ただし結果はcharデータ型を使用して返されます。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readChar、インタフェース: DataInput
    
    定義:
    
    readChar、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームからの符号なしchar値
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    ImageInputStream.readUnsignedShort()
  - readInt
```
public int readInt()
            throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから4バイトを読み込み、現在のバイト順に従って概念上それらを連結して、結果をint値として返します。
    ストリーム内のビット・オフセットは無視され、0として扱われます。
    
    定義:
    
    readInt、インタフェース: DataInput
    
    定義:
    
    readInt、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームからの符号付きint値
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    ImageInputStream.getByteOrder()
  - readUnsignedInt
```
public long readUnsignedInt()
                     throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから4バイトを読み込んで現在のバイト順に従って概念上それらを連結し、結果の値をlongに変換して、符号拡張ビットを取り除くために0xffffffffLでマスクします。その結果を符号なしlong値として返します。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readUnsignedInt、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームからの符号なしint値(long)
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    ImageInputStream.getByteOrder()
  - readLong
```
public long readLong()
              throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから8バイトを読み込み、現在のバイト順に従って概念上それらを連結して、結果をlong値として返します。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readLong、インタフェース: DataInput
    
    定義:
    
    readLong、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームからの符号付きlong値
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    ImageInputStream.getByteOrder()
  - readFloat
```
public float readFloat()
                throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから4バイトを読み込み、現在のバイト順に従って概念上それらを連結して、結果をfloat値として返します。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readFloat、インタフェース: DataInput
    
    定義:
    
    readFloat、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームからのfloat値
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    ImageInputStream.getByteOrder()
  - readDouble
```
public double readDouble()
                  throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから8バイトを読み込み、現在のバイト順に従って概念上それらを連結して、結果をdouble値として返します。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readDouble、インタフェース: DataInput
    
    定義:
    
    readDouble、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームからのdouble値
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    ImageInputStream.getByteOrder()
  - readLine
```
public String readLine()
                throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    入力ストリームから、次の行のテキストを読み込みます。このメソッドは、行末記号またはファイルの終わりを検出するまで、連続するバイトを読み込んで、各バイトをそれぞれ文字に変換します。読み込まれた文字は次に、Stringとして返されます。このメソッドはバイトを処理するものなので、Unicode文字セットの入力を完全にはサポートしません。
    ファイルの終わりが検出されるまでに1バイトも読み込めなかった場合には、nullが返されます。それ以外の場合、読み込まれた各バイトはゼロ拡張によってchar型に変換されます。文字'\n'が検出されると、この文字は破棄され、読込みは中止されます。文字'\r'が検出されると、この文字は破棄され、その次のバイトが文字'\n'に変換されますが、この文字も破棄されて、読込みが中止されます。文字'\n'と文字'\r'のどちらかより前にファイルの終わりが検出されると、読込みが中止されます。読込みが中止されると、読み込まれて破棄されていないすべての文字を取り込んだ順番で格納しているStringが返されます。この文字列のそれぞれの文字は\u0100、つまり(char)256より小さい値を持ちます。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readLine、インタフェース: DataInput
    
    定義:
    
    readLine、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームからのテキスト行を含むString
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
  - readUTF
```
public String readUTF()
               throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    修正UTF-8形式でエンコードされた文字列を読み込みます。readUTFの汎用規約では、修正UTF-8形式でエンコードされたUnicode文字列の表現を読み込みます。読み込まれた文字列は、Stringとして返されます。
    まず、2バイトを読み込み、それを使ってreadUnsignedShortメソッドとまったく同じ方法で符号なし16ビット整数を作成します。この際、現在のバイト順の設定に関係なくネットワーク・バイト順を使用します。この整数値はUTF長と呼ばれ、読み込まれる追加のバイト数を表します。次に、このバイトがグループ単位で文字に変換されます。各グループの長さは、グループの先頭バイトの値から計算されます。グループに後続のバイトがあれば、それは次のグループの先頭バイトです。
    グループの先頭バイトがビット・パターンの0xxxxxxx (ただし、xは0または1を意味します)に一致する場合、グループはそのバイトだけで構成されます。バイトはゼロ拡張されて単一の文字を表現します。
    グループの先頭バイトがビット・パターン110xxxxxに一致する場合、そのグループはそのバイトaと2番目のバイトbから構成されます。バイトbが存在しない場合(バイトaが読み込まれた最後のバイトだった場合)や、バイトbがビット・パターン10xxxxxxに一致しない場合には、UTFDataFormatExceptionがスローされます。そうでない場合、グループは次の文字に変換されます。
```
 (char)(((a& 0x1F) << 6) | (b & 0x3F))
 
```
    グループの先頭バイトがビット・パターン1110xxxxに一致する場合、そのグループは先頭バイトaに加えて、2つのバイトbとcから構成されます。バイトcが存在しない場合(バイトaが読み込まれた一連のバイトの最後の2つに入っていた場合)や、バイトbまたはcがビット・パターン10xxxxxxに一致しない場合には、UTFDataFormatExceptionがスローされます。そうでない場合、グループは次の文字に変換されます。
```
 (char)(((a & 0x0F) << 12) | ((b & 0x3F) << 6) | (c & 0x3F))
 
```
    グループの先頭バイトがパターン1111xxxxかパターン10xxxxxxに一致する場合、UTFDataFormatExceptionがスローされます。
    この処理全体のどこかでファイルの終わりが検出されると、java.io.EOFExceptionがスローされます。
    各グループがこの処理で1文字に変換されると、対応するグループが入力ストリームから読み込まれたのと同じ順序で各文字が収集され、Stringを表現します。そして、このStringが返されます。
    現在のバイト順の設定は無視されます。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    注: ここで使用される修正UTF-8は標準UTF-8と互換性がありません。このため、標準UTF-8を使用するイメージ形式の実装ではこのメソッドを使用しないでください。
    定義:
    
    readUTF、インタフェース: DataInput
    
    定義:
    
    readUTF、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームから読み込まれたString
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    UTFDataFormatException - 文字列中のバイトが、有効な修正UTF-8形式でエンコードされた文字列以外であった場合。
    
    IOException - 入出力エラーが発生した場合。
  - readFully
```
public void readFully(byte[] b,
                      int off,
                      int len)
               throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームからlenバイトを読み込み、bにインデックスoffから格納します。ストリームの終わりに達すると、java.io.EOFExceptionがスローされます。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readFully、インタフェース: DataInput
    
    定義:
    
    readFully、インタフェース: ImageInputStream
    
    パラメータ:
    
    b - 書き込まれるバイト配列。
    
    off - 書込み先のb内の開始位置。
    
    len - 読み込む最大byte数。
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - readFully
```
public void readFully(byte[] b)
               throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームからb.lengthバイトを読み込み、bにインデックス0から格納します。ストリームの終わりに達すると、java.io.EOFExceptionがスローされます。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readFully、インタフェース: DataInput
    
    定義:
    
    readFully、インタフェース: ImageInputStream
    
    パラメータ:
    
    b - byteの配列。
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - readFully
```
public void readFully(short[] s,
                      int off,
                      int len)
               throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから現在のバイト順に従ってlenバイトのshort (符号付き16ビット整数)値を読み込み、それらをsにインデックスoffから格納します。ストリームの終わりに達すると、java.io.EOFExceptionがスローされます。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readFully、インタフェース: ImageInputStream
    
    パラメータ:
    
    s - 書き込まれるshort配列。
    
    off - 書込み先のs内の開始位置。
    
    len - 読み込む最大short数。
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - readFully
```
public void readFully(char[] c,
                      int off,
                      int len)
               throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから現在のバイト順に従ってlenバイトのchar (符号なし16ビット整数)値を読み込み、それらをcにインデックスoffから格納します。ストリームの終わりに達すると、java.io.EOFExceptionがスローされます。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readFully、インタフェース: ImageInputStream
    
    パラメータ:
    
    c - 書き込まれるchar配列。
    
    off - 書込み先のc内の開始位置。
    
    len - 読み込む最大char数。
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - readFully
```
public void readFully(int[] i,
                      int off,
                      int len)
               throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから現在のバイト順に従ってlenバイトのint (符号付き32ビット整数)値を読み込み、それらをiにインデックスoffから格納します。ストリームの終わりに達すると、java.io.EOFExceptionがスローされます。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readFully、インタフェース: ImageInputStream
    
    パラメータ:
    
    i - 書き込まれるint配列。
    
    off - 書込み先のi内の開始位置。
    
    len - 読み込む最大int数。
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - readFully
```
public void readFully(long[] l,
                      int off,
                      int len)
               throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから現在のバイト順に従ってlenバイトのlong (符号付き64ビット整数)値を読み込み、それらをlにインデックスoffから格納します。ストリームの終わりに達すると、java.io.EOFExceptionがスローされます。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readFully、インタフェース: ImageInputStream
    
    パラメータ:
    
    l - 書き込まれるlong配列。
    
    off - 書込み先のl内の開始位置。
    
    len - 読み込む最大long数。
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - readFully
```
public void readFully(float[] f,
                      int off,
                      int len)
               throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから現在のバイト順に従ってlenバイトのfloat (32ビットIEEE単精度浮動小数点数)値を読み込み、それらをfにインデックスoffから格納します。ストリームの終わりに達すると、java.io.EOFExceptionがスローされます。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readFully、インタフェース: ImageInputStream
    
    パラメータ:
    
    f - 書き込まれるfloat配列。
    
    off - 書込み先のf内の開始位置。
    
    len - 読み込む最大float数。
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - readFully
```
public void readFully(double[] d,
                      int off,
                      int len)
               throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから現在のバイト順に従ってlenバイトのdouble (64ビットIEEE倍精度浮動小数点数)値を読み込み、それらをdにインデックスoffから格納します。ストリームの終わりに達すると、java.io.EOFExceptionがスローされます。
    ストリーム内のビット・オフセットは、読込みを行う前に0にリセットされます。
    
    定義:
    
    readFully、インタフェース: ImageInputStream
    
    パラメータ:
    
    d - 書き込まれるdouble配列。
    
    off - 書込み先のd内の開始位置。
    
    len - 読み込む最大double数。
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - getStreamPosition
```
public long getStreamPosition()
                       throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームの現在のバイト位置を返します。次の読込みはこのオフセットから開始されます。
    
    定義:
    
    getStreamPosition、インタフェース: ImageInputStream
    
    戻り値:
    
    ストリームの位置を含むlong
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
  - getBitOffset
```
public int getBitOffset()
                 throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    現在のビット・オフセットを0から7までの整数として返します。ビット・オフセットは、readBitsメソッドの呼出しで暗黙的に更新されます。値0は読み込まれるバイトの最上位ビット、値7は最下位ビットを示します。
    ビット・オフセットは、ストリームを最初に開くときに0に設定され、seek、skipBytes、またはreadかreadFullyメソッドのいずれかが呼び出されると0にリセットされます。
    
    定義:
    
    getBitOffset、インタフェース: ImageInputStream
    
    戻り値:
    
    0から7までのオフセット値を含むint。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    ImageInputStream.setBitOffset(int)
  - setBitOffset
```
public void setBitOffset(int bitOffset)
                  throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ビット・オフセットに0から7までの整数を設定します。getStreamPositionから返される、ストリーム内のバイト・オフセットは変更されません。値0は読み込まれるバイトの最上位ビット、値7は最下位ビットを示します。
    
    定義:
    
    setBitOffset、インタフェース: ImageInputStream
    
    パラメータ:
    
    bitOffset - 目的のオフセットで、0から7までのint。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    ImageInputStream.getBitOffset()
  - readBit
```
public int readBit()
            throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームから1ビットを読み込み、それを値0または1のintとして返します。ビット・オフセットは1ずつ増加し、8を法として減分します。
    
    定義:
    
    readBit、インタフェース: ImageInputStream
    
    戻り値:
    
    値0または1のint。
    
    例外:
    
    EOFException - すべてのビットを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - readBits
```
public long readBits(int numBits)
              throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    ストリームからビット列を読み込み、longとして返します。読み込んだ最初のビットが出力の最上位ビットになります。読込みは、getStreamPositionで指定されるバイト内のgetBitOffsetで指定されるビット位置から開始されます。ビット・オフセットはnumBitsだけ増加し、8を法として減分します。
    ストリームのバイト順はこのメソッドに影響しません。このメソッドの戻り値はビットが同時に読み込まれたかのように構築され、戻り値の右側にシフトされます。これを次の擬似コードで示します。
```
 long accum = 0L;
 for (int i = 0; i < numBits; i++) {
   accum <<= 1; // Shift left one bit to make room
   accum |= readBit();
 }
 
```
    したがって、逆ネットワーク・バイト順が使用されている場合(つまり、getByteOrder()== false)、readBits(32)の結果がreadInt()の結果と異なる場合があります。
    すべてのビットを読み込む前にストリームの終わりを検出した場合、java.io.EOFExceptionがスローされます。
    定義:
    
    readBits、インタフェース: ImageInputStream
    
    パラメータ:
    
    numBits - 読み込むビット数を示す0から64までのint。
    
    戻り値:
    
    最後に読み込んだビットを最下位ビットに格納したlongのビット列。
    
    例外:
    
    EOFException - すべてのビットを読み込む前に、このストリームの終わりに達した場合。
    
    IOException - 入出力エラーが発生した場合。
  - length
```
public long length()
```
    ストリームが未知の長さであることを示す-1Lを返します。サブクラスでこのメソッドをオーバーライドして、実際の長さの情報を指定する必要があります。
    
    定義:
    
    length、インタフェース: ImageInputStream
    
    戻り値:
    
    未知の長さを示す -1L
  - skipBytes
```
public int skipBytes(int n)
              throws IOException
```
    seek(getStreamPosition()+n)を呼び出して、現在のストリーム位置を前進させます。
    ビット・オフセットは0にリセットされます。
    
    定義:
    
    skipBytes、インタフェース: DataInput
    
    定義:
    
    skipBytes、インタフェース: ImageInputStream
    
    パラメータ:
    
    n - 前方にシークするバイト数。
    
    戻り値:
    
    スキップされたバイト数を示すint。
    
    例外:
    
    IOException - 開始または終了位置を計算する際にgetStreamPositionがIOExceptionをスローする場合。
  - skipBytes
```
public long skipBytes(long n)
               throws IOException
```
    seek(getStreamPosition()+n)を呼び出して、現在のストリーム位置を前進させます。
    ビット・オフセットは0にリセットされます。
    
    定義:
    
    skipBytes、インタフェース: ImageInputStream
    
    パラメータ:
    
    n - 前方にシークするバイト数。
    
    戻り値:
    
    スキップされたバイト数を示すlong。
    
    例外:
    
    IOException - 開始または終了位置を計算する際にgetStreamPositionがIOExceptionをスローする場合。
  - seek
```
public void seek(long pos)
          throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    現在のストリーム位置を目的の位置に設定します。次回の読込みはこの位置で行われます。ビット・オフセットは0に設定されます。
    posがgetflushedPositionから返されるフラッシュ位置よりも小さい場合は、IndexOutOfBoundsExceptionがスローされます。
    シークでファイルの終わりを通過することは正常であり、java.io.EOFExceptionは読込みの場合のみスローされます。
    
    定義:
    
    seek、インタフェース: ImageInputStream
    
    パラメータ:
    
    pos - 目的のファイル・ポインタ位置を示すlong。
    
    例外:
    
    IOException - その他の入出力エラーが発生した場合。
  - mark
```
public void mark()
```
    マーク付けされた位置のスタック上に現在のストリーム位置をプッシュします。
    
    定義:
    
    mark、インタフェース: ImageInputStream
  - reset
```
public void reset()
           throws IOException
```
    マーク付けされた位置のスタックから現在のストリーム・バイトおよびビット位置をリセットします。
    以前にマーク付けされた位置がストリームの破棄された部分である場合にはIOExceptionがスローされます。
    
    定義:
    
    reset、インタフェース: ImageInputStream
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
  - flushBefore
```
public void flushBefore(long pos)
                 throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    指示された位置より前のストリームの先頭部分を破棄します。ストリームのフラッシュされた部分内のオフセットにシークしようとすると、IndexOutOfBoundsExceptionがスローされます。
    flushBeforeを呼び出すと、このインタフェースを実装するクラスが、ストリームからデータを格納するのに使用するメモリーやディスク・スペースなどのリソースを解放できます。
    
    定義:
    
    flushBefore、インタフェース: ImageInputStream
    
    パラメータ:
    
    pos - フラッシュされるストリーム接頭辞の長さを示すlong。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
  - flush
```
public void flush()
           throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    現在のストリーム位置より前の初期のストリーム位置を破棄します。flushBefore(getStreamPosition())と同等です。
    
    定義:
    
    flush、インタフェース: ImageInputStream
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
  - getFlushedPosition
```
public long getFlushedPosition()
```
    インタフェースからコピーされた説明: ImageInputStream
    
    シークが実行されるストリーム内の一番初期の位置を返します。戻り値は、以前のflushBefore呼出しに渡されたすべての値の最大値になります。
    
    定義:
    
    getFlushedPosition、インタフェース: ImageInputStream
    
    戻り値:
    
    一番初期の正当なシーク位置を示すlong。
  - isCached
```
public boolean isCached()
```
    デフォルトの実装ではfalseを返します。サブクラスは、データをキャッシュに格納する場合はこれをオーバーライドする必要があります。
    
    定義:
    
    isCached、インタフェース: ImageInputStream
    
    戻り値:
    
    このImageInputStreamがデータをキャッシュに格納する場合はtrue。
    
    関連項目:
    
    ImageInputStream.isCachedMemory(), ImageInputStream.isCachedFile()
  - isCachedMemory
```
public boolean isCachedMemory()
```
    デフォルトの実装ではfalseを返します。サブクラスは、データをメイン・メモリーにキャッシュする場合はこれをオーバーライドする必要があります。
    
    定義:
    
    isCachedMemory、インタフェース: ImageInputStream
    
    戻り値:
    
    このImageInputStreamがデータをメイン・メモリーにキャッシュする場合はtrue。
    
    関連項目:
    
    ImageInputStream.isCached(), ImageInputStream.isCachedFile()
  - isCachedFile
```
public boolean isCachedFile()
```
    デフォルトの実装ではfalseを返します。サブクラスは、データを一時ファイルにキャッシュする場合はこれをオーバーライドする必要があります。
    
    定義:
    
    isCachedFile、インタフェース: ImageInputStream
    
    戻り値:
    
    このImageInputStreamがデータを一時ファイルにキャッシュする場合はtrue。
    
    関連項目:
    
    ImageInputStream.isCached(), ImageInputStream.isCachedMemory()
  - close
```
public void close()
           throws IOException
```
    インタフェースからコピーされた説明: ImageInputStream
    
    ストリームを閉じます。閉じたストリームにアクセスしようとすると、IOExceptionがスローされるか不正な動作が実行される場合があります。このメソッドを呼び出すと、このインタフェースを実装するクラスが、メモリー、ディスク・スペース、またはファイル記述子などのストリームに関連するリソースを解放できます。
    
    定義:
    
    close、インタフェース: Closeable
    
    定義:
    
    close、インタフェース: AutoCloseable
    
    定義:
    
    close、インタフェース: ImageInputStream
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
  - finalize
```
protected void finalize()
                 throws Throwable
```
    ガベージ・コレクションの前にこのオブジェクトをファイナライズします。closeメソッドを呼び出して、開いている入力ソースをすべて閉じます。このメソッドを、アプリケーション・コードから呼び出してはいけません。
    
    オーバーライド:
    
    finalize、クラス: Object
    
    例外:
    
    Throwable - スーパー・クラスのファイナライズ時にエラーが発生した場合。
    
    関連項目:
    
    WeakReference, PhantomReference

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスImageInputStreamImpl

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

フィールドの詳細

byteOrder

streamPos

bitOffset

flushedPos

コンストラクタの詳細

ImageInputStreamImpl

メソッドの詳細

checkClosed

setByteOrder

getByteOrder

read

read

read

readBytes

readBoolean

readByte

readUnsignedByte

readShort

readUnsignedShort

readChar

readInt

readUnsignedInt

readLong

readFloat

readDouble

readLine

readUTF

readFully

readFully

readFully

readFully

readFully

readFully

readFully

readFully

getStreamPosition

getBitOffset

setBitOffset

readBit

readBits

length

skipBytes

skipBytes

seek

mark

reset

flushBefore

flush

getFlushedPosition

isCached

isCachedMemory

isCachedFile

close

finalize