8.4.29 getUpdateCount()
- 〈この項の構成〉
(1) 機能
更新行数をint型で返します。
更新行数がInteger.MAX_VALUEを超える可能性がある場合は,getUpdateCountメソッドではなく,getLargeUpdateCountメソッドを使用してください。getUpdateCountメソッドを使用した場合に,Integer.MAX_VALUEを超えると0が返却されます。
(2) 形式
public synchronized int getUpdateCount() throws SQLException
(3) 引数
なし。
(4) 戻り値
戻り値の詳細を次の表に示します。
Statementオブジェクトのメソッドの実行条件 |
getUpdateCountまたはgetLargeUpdateCountメソッドの戻り値 |
|||
---|---|---|---|---|
executeXXXメソッドを実行していない場合 |
-1 |
|||
executeXXXメソッドを実行している場合 |
最後に実行したexecuteXXXメソッドのあとに,getMoreResultsメソッドを実行した場合 |
-1 |
||
最後に実行したexecuteXXXメソッドでエラーが発生した場合 |
-1 |
|||
最後にexecuteBatchメソッドまたはexecuteLargeBatchメソッドを実行した場合 |
-1 |
|||
最後にexecuteBatchメソッドまたはexecuteLargeBatchメソッド以外のexecuteXXXメソッドを実行した場合 |
最後に実行したSQL文が検索系SQLの場合 |
-1 |
||
最後に実行したSQLが検索系SQL以外のSQL文の場合 |
INSERT,UPDATE,DELETE |
更新行数※ |
||
そのほか |
0 |
- 注※
-
更新行数がInteger.MAX_VALUEを超える可能性がある場合は,getUpdateCountメソッドではなく,getLargeUpdateCountメソッドを使用してください。getUpdateCountメソッドを使用した場合に,Integer.MAX_VALUEを超えると0が返却されます。
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
Statementオブジェクトがクローズされている場合
-
Statementオブジェクトを生成したConnectionオブジェクトがクローズされている場合