8.6.40 getLong(int columnIndex)
- 〈この項の構成〉
(1) 機能
ResultSetオブジェクトの現在行の列の値を,Javaプログラミング言語のlongで取得します。値を取得する列は,引数で指定します。
(2) 形式
public synchronized long getLong(int columnIndex) throws SQLException
(3) 引数
- int columnIndex:
-
列番号を指定します。
(4) 戻り値
列値が返却されます。検索結果と戻り値の関係を次の表に示します。
HADBのデータ型 |
検索結果 |
戻り値 |
---|---|---|
CHAR VARCHAR |
ナル値 |
0 |
[半角空白]整数の文字列表現,10進数の文字列表現,または浮動小数点の文字列表現[半角空白]であり,かつLong.MIN_VALUE以上,Long.MAX_VALUE以下 |
検索結果の整数部分の値をlong値にしたもの |
|
[半角空白]整数の文字列表現,10進数の文字列表現,または浮動小数点の文字列表現[半角空白]であり,かつLong.MAX_VALUEより大きいかLong.MIN_VALUEより小さい |
SQLExceptionが投入される |
|
[半角空白]-Infinity[半角空白] |
||
[半角空白][+]Infinity[半角空白] |
||
[半角空白][+|-]NaN[半角空白] |
||
上記以外(double値,またはBigDecimalオブジェクトにできない) |
||
SMALLINT |
ナル値 |
0 |
上記以外 |
検索結果をlong値にしたもの |
|
INTEGER BIGINT |
ナル値 |
0 |
上記以外 |
検索結果をlong値にしたもの |
|
DECIMAL NUMERIC |
ナル値 |
0 |
Long.MIN_VALUE以上かつLong.MAX_VALUE以下 |
検索結果の整数部分の値をlong値にしたもの |
|
DOUBLE PRECISION FLOAT |
ナル値 |
0 |
Long.MIN_VALUE以上かつLong.MAX_VALUE以下 |
検索結果の整数部分の値をlong値にしたもの |
|
上記以外 |
SQLExceptionが投入される |
|
BOOLEAN※ |
ナル値 |
0 |
true |
1 |
|
false |
0 |
|
そのほか |
該当しません |
SQLExceptionが投入される |
- 注※
-
DatabaseMetadataから生成したResultsetオブジェクトの場合,BOOLEAN型データが存在します。
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
このResultSetオブジェクトがクローズされている場合
このResultSetオブジェクトを生成したStatementオブジェクトがクローズされたことによって,ResultSetオブジェクトがクローズされた場合も含みます。
-
このResultSetオブジェクトを生成したStatementオブジェクトを作成したConnectionがクローズされている場合
-
トランザクションの決着によってResultSetオブジェクトが無効になった場合
-
存在しない列番号を指定した場合
-
このメソッドでは取得できないデータ型の場合
-
列の値がlongとして取得できない場合
-
JDBCドライバ内でエラーが発生した場合