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オブジェクトが無効になった場合
-
データベースのアクセスエラーが発生した場合