- java.lang.Object
- 
- java.io.InputStream
- 
- java.io.FilterInputStream
- 
- java.io.LineNumberInputStream
 
 
 
- 
- すべての実装されたインタフェース:
- Closeable,- AutoCloseable
 
 @Deprecated public class LineNumberInputStream extends FilterInputStream 非推奨。このクラスは、バイトが文字を適切に表していると誤って想定しています。 JDK 1.1以降、文字ストリームの処理には、行番号をカウントするためのクラスが含まれている新しい文字ストリーム・クラスを使うことが推奨されています。このクラスは入力ストリーム・フィルタであり、現在の行番号を監視して保持する機能が追加されています。行とはバイトの連なりであり、復帰文字( '\r')、改行文字('\n')、または復帰文字とそれに続く改行文字で終わります。 これら3種類のすべてで、行を終了させる文字は1個の改行文字として返されます。行番号は 0から始まり、readが改行文字を返すたびに1ずつ増分します。- 導入されたバージョン:
- 1.0
- 関連項目:
- LineNumberReader
 
- 
- 
フィールドのサマリー- 
クラス java.io.FilterInputStreamで宣言されたフィールドin
 
- 
 - 
コンストラクタのサマリーコンストラクタ コンストラクタ 説明 LineNumberInputStream(InputStream in)非推奨。指定された入力ストリームから読み込む、新しい行番号付き入力ストリームを作成します。
 - 
メソッドのサマリーすべてのメソッド インスタンス・メソッド 具象メソッド 非推奨のメソッド 修飾子と型 メソッド 説明 intavailable()非推奨。ブロックせずに入力ストリームから読み込むことができるバイト数を返します。intgetLineNumber()非推奨。現在の行番号を返します。voidmark(int readlimit)非推奨。この入力ストリームの現在位置にマークを設定します。intread()非推奨。この入力ストリームからデータの次のバイトを読み込みます。intread(byte[] b, int off, int len)非推奨。最大lenバイトのデータを、この入力ストリームからバイト配列に読み込みます。voidreset()非推奨。このストリームを、この入力ストリームで最後にmarkメソッドが呼び出されたときの位置に再配置します。voidsetLineNumber(int lineNumber)非推奨。行番号を指定された引数で設定します。longskip(long n)非推奨。この入力ストリームからnバイトのデータをスキップして破棄します。- 
クラス java.io.FilterInputStreamで宣言されたメソッドclose, markSupported, read
 - 
クラス java.io.InputStreamで宣言されたメソッドnullInputStream, readAllBytes, readNBytes, readNBytes, transferTo
 
- 
 
- 
- 
- 
コンストラクタの詳細- 
LineNumberInputStreampublic LineNumberInputStream(InputStream in) 非推奨。指定された入力ストリームから読み込む、新しい行番号付き入力ストリームを作成します。- パラメータ:
- in- ベースとなる入力ストリーム。
 
 
- 
 - 
メソッドの詳細- 
readpublic int read() throws IOException非推奨。この入力ストリームからデータの次のバイトを読み込みます。 バイト値は、0-255の範囲のintとして返されます。 ストリームの終わりに達したために読み込むバイトがない場合は、-1が返されます。 入力データが読み込めるようになるか、ストリームの終わりが検出されるか、または例外が発生するまで、このメソッドはブロックされます。LineNumberInputStreamのreadメソッドはそのベースとなる入力ストリームのreadメソッドを呼び出します。 入力に現れる復帰文字と改行文字を調べ、適切な行番号を保ちます。 復帰文字と復帰文字+改行文字は、どちらも1個の改行文字に変換されます。- オーバーライド:
- read、クラス- FilterInputStream
- 戻り値:
- データの次のバイト。ストリームの終わりに達した場合は-1。
- 例外:
- IOException- 入出力エラーが発生した場合。
- 関連項目:
- FilterInputStream.in,- getLineNumber()
 
 - 
readpublic int read(byte[] b, int off, int len) throws IOException非推奨。最大lenバイトのデータを、この入力ストリームからバイト配列に読み込みます。 このメソッドは、入力の一部が利用できるようになるまでブロックします。LineNumberInputStreamのreadメソッドは、引数を取らないreadメソッドを繰返し呼び出してバイト配列に書き込みます。- オーバーライド:
- read、クラス- FilterInputStream
- パラメータ:
- b- データの読込み先のバッファ。
- off- データの開始オフセット。
- len- 読み込まれる最大バイト数。
- 戻り値:
- バッファに読み込まれたバイトの合計数。ストリームの終わりに達してデータがない場合は-1。
- 例外:
- IOException- 入出力エラーが発生した場合。
- 関連項目:
- read()
 
 - 
skippublic long skip(long n) throws IOException非推奨。この入力ストリームからnバイトのデータをスキップして破棄します。 さまざまな理由から、skipメソッドは指定よりも少ないバイト数しかスキップしないことがあります。0の場合もあります。 スキップされた実際のバイト数が返されます。nが負の場合、バイトはスキップされません。LineNumberInputStreamのskipメソッドはバイト配列を作成し、nバイトが読み込まれるまで、またはストリームの終わりに達するまで繰り返しその中に読み込みます。- オーバーライド:
- skip、クラス- FilterInputStream
- パラメータ:
- n- スキップされるバイト数。
- 戻り値:
- 実際にスキップされたバイト数。
- 例外:
- IOException- 入出力エラーが発生した場合。
- 関連項目:
- FilterInputStream.in
 
 - 
setLineNumberpublic void setLineNumber(int lineNumber) 非推奨。行番号を指定された引数で設定します。- パラメータ:
- lineNumber- 新規行番号。
- 関連項目:
- getLineNumber()
 
 - 
getLineNumberpublic int getLineNumber() 非推奨。現在の行番号を返します。- 戻り値:
- 現在の行番号。
- 関連項目:
- setLineNumber(int)
 
 - 
availablepublic int available() throws IOException非推奨。ブロックせずに入力ストリームから読み込むことができるバイト数を返します。ブロックせずにベースとなる入力ストリームからk個の文字を読込み可能な場合、 LineNumberInputStreamがブロックせずに読込み可能な文字数はk/2となる可能性があることに注意してください。これは、ベースとなる入力ストリームからのk個の文字がk/2対の'\r'と'\n'である可能性もあり、これがk/2個の'\n'文字に変換されるかもしれないからです。- オーバーライド:
- available、クラス- FilterInputStream
- 戻り値:
- ブロックしないで入力ストリームから読み込むことができるバイト数。
- 例外:
- IOException- 入出力エラーが発生した場合。
- 関連項目:
- FilterInputStream.in
 
 - 
markpublic void mark(int readlimit) 非推奨。この入力ストリームの現在位置にマークを設定します。 これに続いてresetメソッドを呼び出すと、最後にマークされた位置にこのストリームが再配置されるため、以降の読込みでは同じバイトが再度読み込まれます。LineNumberInputStreamのmarkメソッドは、private変数に現在の行番号を記録してから、ベースとなる入力ストリームのmarkメソッドを呼び出します。- オーバーライド:
- mark、クラス- FilterInputStream
- パラメータ:
- readlimit- マーク位置が無効になる前に読込み可能なバイト数の上限。
- 関連項目:
- FilterInputStream.in,- reset()
 
 - 
resetpublic void reset() throws IOException非推奨。このストリームを、この入力ストリームで最後にmarkメソッドが呼び出されたときの位置に再配置します。LineNumberInputStreamのresetメソッドは、まず行番号をmarkメソッドが呼び出された時点の値にリセットし、それからベースとなる入力ストリームのresetメソッドを呼び出します。ストリームのマークは、ストリームに何が含まれているかをチェックするために、データを少しだけ先読みする必要がある場合に使われます。 これをもっとも容易に実行する方法は、一般的なパーサーを呼び出すことです。 ストリームがパーサーで取り扱えるタイプであれば、これでうまく行きます。 ストリームがそのようなタイプではない場合、パーサーは失敗した時点で例外を発生させます。これにより、readlimitバイトの範囲内でこれが発生した場合は、外部のコードでストリームをリセットし、別のパーサーを呼び出すことができます。 - オーバーライド:
- reset、クラス- FilterInputStream
- 例外:
- IOException- 入出力エラーが発生した場合。
- 関連項目:
- FilterInputStream.in,- mark(int)
 
 
- 
 
-