3.18.13 getIntValint型での列データの取得

<この項の構成>
(1) 機能
(2) 形式
(3) 引数
(4) 戻り値
(5) 例外

(1) 機能

検索結果集合のカーソル行から,指定した列のデータをint型で取得します。

列値がNULL値の場合は,0が返却されます。列値がINT型でない場合は,java.lang.Object#toStringメソッドの実行結果がさらにint型の値に変換されて返却されます。列値がINT型の場合は,そのままjava.langInteger#intValueメソッドの実行結果が返却されます。

データを取得する列は,列インデクス(形式1)または列名(形式2)で指定します。なお,列名で指定した場合で,その列名が重複しているときは,どの列データを取得するかは保証できません。

(2) 形式

(a) 形式1

int getIntVal(
    int     columnIndex
)

(b) 形式2

int getIntVal(
    String  columnName
)

(3) 引数

columnIndex(入力)
0から始まる列インデクスを指定します。
columnName(入力)
列名を指定します。nullを指定すると,列名が付いていない列のデータをint型で取得できます。

(4) 戻り値

列データ(int型)

(5) 例外

IllegalArgumentException
指定した列名がなかった場合
IllegalStateException
カーソル状態が不正の場合
IndexOutOfBoundsException
列インデクスが不正の場合
NumberFormatException
数値変換に失敗した場合