8.6.2 absolute(int row)
- 〈この項の構成〉
(1) 機能
ResultSetオブジェクト内の指定された行にカーソルを移動します。
(2) 形式
public synchronized boolean absolute(int row) throws SQLException
(3) 引数
- int row:
-
カーソルの移動先の行番号を指定します。正の番号を指定した場合,行番号は結果セットの先頭からカウントされます。負の番号を指定した場合,行番号は結果セットの終端からカウントされます。
(4) 戻り値
absoluteメソッドを呼び出したあとのカーソル位置が,先頭行の前または最終行の後ろの場合はfalseが,そうでない場合はtrueが返却されます。
absoluteメソッド実行時のカーソルの移動先と戻り値を次の表に示します。
結果集合の行数※ |
rowの指定値 |
カーソルの移動先 |
戻り値 |
---|---|---|---|
0 |
0以外 |
先頭行の前のまま |
false |
n |
n<row |
最終行の後ろ |
false |
1≦row≦n |
row |
true |
|
-n≦row≦-1 |
(n+1)+row |
true |
|
row<-n |
先頭行の前 |
false |
- 注※
-
setMaxRowsの値より実際の行数の方が多い場合は,setMaxRowsの値になります。
setLargeMaxRowsの値より実際の行数の方が多い場合は,setLargeMaxRowsの値になります。
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
このResultSetオブジェクトがクローズされている場合
このResultSetオブジェクトを生成したStatementオブジェクトがクローズされたことによって,ResultSetオブジェクトがクローズされた場合も含みます。
-
このResultSetオブジェクトを生成したStatementオブジェクトを作成したConnectionがクローズされている場合
-
このResultSetオブジェクトの型がResultSet.TYPE_FORWARD_ONLYの場合
-
rowに0を指定した場合
-
トランザクションの決着によってResultSetオブジェクトが無効になった場合
-
データベースのアクセスエラーが発生した場合