17.4.5　CallableStatementインタフェース

(a)　getBigDecimal(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.math.BigDecimalオブジェクトとして取得します。

【形式】

public synchronized java.math.BigDecimal getBigDecimal(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値を持つjava.math.BigDecimalオブジェクト（値がNULLの場合，nullを返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のjava.math.BigDecimalオブジェクトとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M｜N][VAR]CHAR	NULL	null
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]	？パラメタの値を持つBigDecimalオブジェクト。文字列の前後の半角空白を取り除いた値をBigDecimalオブジェクトにします。
	上記以外	SQLExceptionを投入
SMALLINT	NULL	null
	NULL以外	？パラメタの値を持つBigDecimalオブジェクト
INTEGER	NULL	null
	NULL以外	？パラメタの値を持つBigDecimalオブジェクト
REAL	NULL	null
	Infinity	SQLExceptionを投入
	-Infinity	SQLExceptionを投入
	NaN	SQLExceptionを投入
	上記以外	？パラメタの値を持つBigDecimalオブジェクト
FLOAT	NULL	null
	Infinity	SQLExceptionを投入
	-Infinity	SQLExceptionを投入
	NaN	SQLExceptionを投入
	上記以外	？パラメタの値を持つBigDecimalオブジェクト
DECIMAL	NULL	null
	NULL以外	？パラメタの値を持つBigDecimalオブジェクト
BOOLEAN	NULL	null
	true	BigDecimal(1)でBigDecimalオブジェクトにしたもの
	false	BigDecimal(0)でBigDecimalオブジェクトにしたもの
その他	−	SQLExceptionを投入

（凡例）

−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタの場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(b)　getBigDecimal(int parameterIndex, int scale)

【機能】

指定された？パラメタの値を，scaleで指定された小数点以下のけた数を持つJavaプログラミング言語のjava.math.BigDecimalオブジェクトとして取得します。

【形式】

public synchronized java.math.BigDecimal getBigDecimal(int parameterIndex, int scale) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

int scale：

位取り。指定できる範囲は0≦scale≦2147483647です。

【戻り値】

指定された？パラメタの値で小数点以下のけた数を引数scaleにした値を持つjava.math.BigDecimalオブジェクト（値がNULLの場合，nullを返します）

【機能詳細】

指定された？パラメタの値を，scaleで指定された小数点以下のけた数を持つJavaプログラミング言語のjava.math.BigDecimalオブジェクトとして取得します。

？パラメタの値が持つ小数点以下のけた数より引数scaleの値が小さい場合，？パラメタの小数点以下のけた数をscaleで切り捨てます。？パラメタの値が持つ小数点以下のけた数より引数scaleの値が大きい場合，？パラメタの小数点以下のけた数をscaleまで0で補完します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getBigDecimal(int parameterIndex)」の【機能詳細】を参照してください。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• scaleに0未満を指定した場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(c)　getBlob(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Blobオブジェクトとして取得します。

【形式】

public synchronized java.sql.Blob getBlob(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2…と指定します。

【戻り値】

指定された？パラメタの値を持つjava.sql.Blobオブジェクト（値がNULLの場合，nullを返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Blobオブジェクトとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
BINARY BLOB	NULL	null
	NULL以外	？パラメタの値を持つjava.sql.Blobオブジェクト
その他	−	SQLExceptionを投入

（凡例）

−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(d)　getBlob(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Blobオブジェクトとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係は「getBlob(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized java.sql.Blob getBlob (String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値を持つjava.sql.Blobオブジェクト（値がNULLの場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(e)　getBoolean(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のbooleanとして取得します。

【形式】

public synchronized boolean getBoolean(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値（値がNULLの場合，falseを返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のbooleanとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M][VAR]CHAR NVARCHAR	NULL	false
	[半角空白]半角true（大文字と小文字は区別しない）[半角空白]	true
	[半角空白]半角1[半角空白]	true
	上記以外	false
NCHAR	NULL	false
	先頭が[半角空白]半角true（大文字と小文字は区別しない）	true
	上記以外	false
SMALLINT	NULL	false
	0	false
	0以外	true
INTEGER	NULL	false
	0	false
	0以外	true
REAL	NULL	false
	Infinity	true
	-Inifnity	true
	NaN	true
	0.0又は-0.0	false
	上記以外	true
FLOAT	NULL	false
	Infinity	true
	-Inifnity	true
	NaN	true
	0.0又は-0.0	false
	上記以外	true
DECIMAL	NULL	false
	0[.00…0]	false
	上記以外	true
BOOLEAN	NULL	false
	NULL以外	？パラメタ値
その他	−	SQLExceptionを投入

（凡例）

−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(f)　getBoolean(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のbooleanとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getBoolean(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized boolean getBoolean (String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値（値がNULLの場合，falseを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(g)　getByte(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のbyteとして取得します。

【形式】

public synchronized byte getByte(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値（値がNULLの場合，0を返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語の byteとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M｜N][VAR]CHAR	NULL	0
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]であり，かつByte.MIN_VALUE以上，Byte.MAX_VALUE以下	？パラメタ値をbyte値にしたもの
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]であり，かつByte.MAX_VALUEより大きいかByte.MIN_VALUEより小さい	SQLExceptionを投入
	[半角空白][+]Infinity[半角空白]	SQLExceptionを投入
	[半角空白]-Infinity[半角空白]	SQLExceptionを投入
	[半角空白][+｜-]NaN[半角空白]	SQLExceptionを投入
	上記以外（double値にできない）	SQLExceptionを投入
SMALLINT	NULL	0
	Byte.MIN_VALUE以上かつByte.MAX_VALUE以下	？パラメタ値をbyte値にしたもの
	上記以外	SQLExceptionを投入
INTEGER	NULL	0
	Byte.MIN_VALUE以上かつByte.MAX_VALUE以下	？パラメタ値をbyte値にしたもの
	上記以外	SQLExceptionを投入
REAL	NULL	0
	Infinity	SQLExceptionを投入
	-Infinity	SQLExceptionを投入
	NaN	SQLExceptionを投入
	Byte.MIN_VALUE以上かつByte.MAX_VALUE以下	？パラメタ値の整数部分の値をbyte値にしたもの
	上記以外	SQLExceptionを投入
FLOAT	NULL	0
	Infinity	SQLExceptionを投入
	-Infinity	SQLExceptionを投入
	NaN	SQLExceptionを投入
	Byte.MIN_VALUE以上かつByte.MAX_VALUE以下	？パラメタ値の整数部分の値をbyte値にしたもの
	上記以外	SQLExceptionを投入
DECIMAL	NULL	0
	Byte.MIN_VALUE以上かつByte.MAX_VALUE以下	？パラメタ値の整数部分の値をbyte値にしたもの
	上記以外	SQLExceptionを投入
BOOLEAN	NULL	0
	true	1
	false	0
その他	−	SQLExceptionを投入

（凡例）

−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(h)　getByte(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のbyteとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係は，「getByte(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized byte getByte (String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値（値がNULLの場合，0を返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(i)　getBytes(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のbyteの配列として取得します。

【形式】

public synchronized byte[] getBytes(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値を持つbyte配列（値がNULLの場合，nullを返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のbyteの配列として取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M｜N][VAR]CHAR BINARY BLOB	NULL	null
	NULL以外	？パラメタ値をbyte配列にしたもの
その他	−	SQLExceptionを投入

（凡例）

−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• データベースアクセスエラーが発生した場合

(j)　getBytes(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のbyteの配列として取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getBytes(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized byte[] getBytes(String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値を持つbyte配列（値がNULLの場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• データベースアクセスエラーが発生した場合

(k)　getDate(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Dateオブジェクトとして取得します。

【形式】

public synchronized java.sql.Date getDate(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値を持つjava.sql.Dateオブジェクト（値がNULLの場合，nullを返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Dateオブジェクトとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M｜N][VAR]CHAR	NULL	null
	[半角空白]日付形式[半角空白]	？パラメタ値の前後の半角空白を取り除きjava.sql.Dateオブジェクトにしたもの
	上記以外	SQLExceptionを投入
DATE	NULL	null
	NULL以外	？パラメタ値をjava.sql.Dateオブジェクトにしたもの
TIMESTAMP	NULL	null
	NULL以外	？パラメタ値をjava.sql.Dateオブジェクトにしたもの
その他	−	SQLExceptionを投入

（凡例）

−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• ？パラメタの値がjava.sql.Dateとして取得できない値の場合

(l)　getDate(int parameterIndex, java.util.Calendar cal)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Dateオブジェクトとして取得します。このメソッドは，指定されたカレンダーを使って取得した適切なミリ秒値から日付を作成します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getDate(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized java.sql.Date getDate (int parameterIndex, java.util.Calendar cal) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

java.util.Calendar cal：

データベースに格納されている値のタイムゾーンが設定されたカレンダー

【戻り値】

指定された？パラメタの値を持つjava.sql.Dateオブジェクト（値がNULLの場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• ？パラメタの値がjava.sql.Dateとして取得できない値の場合

(m)　getDate(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Dateオブジェクトとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getDate(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized java.sql.Date getDate (String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値を持つjava.sql.Dateオブジェクト（値がNULLの場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• ？パラメタの値がjava.sql.Dateとして取得できない値の場合

(n)　getDate(String parameterName, java.util.Calendar cal)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Dateオブジェクトとして取得します。このメソッドは，指定されたカレンダーを使って取得した適切なミリ秒値から日付を作成します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getDate(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized java.sql.Date getDate (String parameterName, java.util.Calendar cal) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

java.util.Calendar cal：

データベースに格納されている値のタイムゾーンが設定されたカレンダー

【戻り値】

指定された？パラメタの値を持つjava.sql.Dateオブジェクト（値がNULLの場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• ？パラメタの値がjava.sql.Dateとして取得できない値の場合

(o)　getDouble(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のdoubleとして取得します。

【形式】

public synchronized double getDouble(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値（値がNULLの場合，0を返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のdoubleとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M｜N][VAR]CHAR	NULL	0.0
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]であり，かつ-Double.MAX_VALUE以上，かつDouble.MIN_VALUE以下，かつDouble.MIN_VALUE以上かつDouble.MAX_VALUE以下	？パラメタ値をdouble値にしたもの
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]かつDouble.MAX_VALUEより大きい	Infinity
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]かつ-Double.MAX_VALUEより小さい	-Infinity
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]かつDouble.MIN_VALUEより小さく0より大きい	0.0
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]かつ-Double.MIN_VALUEより大きく0より小さい	-0.0
	[半角空白]-Infinity[半角空白]	-Infinity
	[半角空白][+]Infinity[半角空白]	Infinity
	[半角空白][+｜-]NaN[半角空白]	NaN
	上記以外（double値にできない）	SQLExceptionを投入
SMALLINT	NULL	0.0
	NULL以外	？パラメタ値をdouble値にしたもの
INTEGER	NULL	0
	NULL以外	？パラメタ値をdouble値にしたもの
REAL	NULL	0.0
	Infinity	Infinity
	-Infinity	-Infinity
	NaN	NaN
	上記以外	？パラメタ値をdouble値にしたもの
FLOAT	NULL	0.0
	Infinity	Infinity
	-Infinity	-Infinity
	NaN	NaN
	上記以外	？パラメタ値
DECIMAL	NULL	0
	NULL以外	？パラメタ値をdouble値にしたもの
BOOLEAN	NULL	0.0
	true	1.0
	false	0.0
その他	−	SQLExceptionを投入

（凡例）

−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(p)　getDouble(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のdoubleとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getDouble(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized double getDouble (String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値（値がNULLの場合，0を返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(q)　getFloat(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のfloatとして取得します。

【形式】

public synchronized float getFloat(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値（値がNULLの場合，0を返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のfloatとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M｜N][VAR]CHAR	NULL	0.0
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]であり，かつ次のどちらか -Float.MAX_VALUE以上-Float.MIN_VALUE以下 Float.MIN_VALUE以上Float.MAX_VALUE以下	？パラメタ値をfloat値にしたもの
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]かつFloat.MAX_VALUEより大きい	Infinity
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]かつ-Float.MAX_VALUEより小さい	-Infinity
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]かつFloat.MIN_VALUEより小さく0より大きい	0.0
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]かつ-Float.MIN_VALUEより大きく0より小さい	-0.0
	[半角空白]-Infinity[半角空白]	-Infinity
	[半角空白][+]Infinity[半角空白]	Infinity
	[半角空白][+｜-]NaN[半角空白]	NaN
	上記以外（float値にできない）	SQLExceptionを投入
SMALLINT	NULL	0.0
	NULL以外	？パラメタ値をfloat値にしたもの
INTEGER	NULL	0.0
	NULL以外	？パラメタ値をfloat値にしたもの
REAL	NULL	0.0
	Infinity	Infinity
	-Infinity	-Infinity
	NaN	NaN
	上記以外	？パラメタ値
FLOAT	NULL	0.0
	Infinity	Infinity
	-Infinity	-Infinity
	NaN	NaN
	-Float.MAX_VALUE以上-Float.MIN_VALUE以下，又はFloat.MIN_VALUE以上Float.MAX_VALUE以下	？パラメタ値をfloat値にしたもの
	Float.MAX_VALUEより大きい	Infinity
	-Float.MAX_VALUEより小さい	-Infinity
	Float.MIN_VALUEより小さく0より大きい	0.0
	-Float.MIN_VALUEより大きく0より小さい	-0.0
DECIMAL	NULL	0.0
	NULL以外	？パラメタ値をfloat値にしたもの
BOOLEAN	NULL	0.0
	true	1.0
	false	0.0
その他	−	SQLExceptionを投入

（凡例）

−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(r)　getFloat(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のfloatとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getFloat(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized float getFloat (String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値（値がNULLの場合，0を返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(s)　getInt(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のintとして取得します。

【形式】

public synchronized int getInt(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値（値がNULLの場合，0を返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のintとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M｜N][VAR]CHAR	NULL	0
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]であり，かつInteger.MIN_VALUE以上，Integer.MAX_VALUE以下	？パラメタ値の整数部分の値をint値にしたもの
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]であり，かつInteger.MAX_VALUEより大きいかInteger.MIN_VALUEより小さい	SQLExceptionを投入
	[半角空白]-Infinity[半角空白]	SQLExceptionを投入
	[半角空白][+]Infinity[半角空白]	SQLExceptionを投入
	[半角空白][+｜-]NaN[半角空白]	SQLExceptionを投入
	上記以外（double値にできない）	SQLExceptionを投入
SMALLINT	NULL	0
	NULL以外	？パラメタ値をint値にしたもの
INTEGER	NULL	0
	NULL以外	？パラメタ値
REAL	NULL	0
	Infinity	SQLExceptionを投入
	-Infinity	SQLExceptionを投入
	NaN	SQLExceptionを投入
	Integer.MIN_VALUE以上かつ，Integer.MAX_VALUE以下	？パラメタ値の整数部分の値をint値にしたもの
	上記以外	SQLExceptionを投入
FLOAT	NULL	0
	Infinity	SQLExceptionを投入
	-Infinity	SQLExceptionを投入
	NaN	SQLExceptionを投入
	Integer.MIN_VALUE以上かつ，Integer.MAX_VALUE以下	？パラメタ値の整数部分の値をint値にしたもの
	上記以外	SQLExceptionを投入
DECIMAL	NULL	0
	Integer.MIN_VALUE以上かつInteger.MAX_VALUE以下	？パラメタ値の整数部分の値をint値にしたもの
	上記以外	SQLExceptionを投入
BOOLEAN	NULL	0
	true	1
	false	0
その他	−	SQLExceptionを投入

（凡例）

−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(t)　getInt(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のintとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getInt(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized int getInt (String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値（値がNULLの場合，0を返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(u)　getLong(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のlongとして取得します。

【形式】

public synchronized long getlong(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値（値がNULLの場合，0を返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のlongとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M｜N][VAR]CHAR	NULL	0
	[半角空白]整数の文字列表現又は10進数の文字列表現かつ15文字以内[半角空白]	？パラメタ値の整数部分の値をlong値にしたもの
	[半角空白]整数の文字列表現又は10進数の文字列表現であり，文字以上又は浮動小数点の文字列表現[半角空白]であり，かつLong.MIN_VALUE以上，Long.MAX_VALUE以下	？パラメタ値の整数部分の値をlong値にしたもの
	[半角空白]整数の文字列表現又は10進数の文字列表現であり，16文字以上又は浮動小数点の文字列表現[半角空白]であり，かつLong.MAX_VALUEより大きいかLong.MIN_VALUEより小さい	SQLExceptionを投入
	[半角空白]-Infinity[半角空白]	SQLExceptionを投入
	[半角空白][+]Infinity[半角空白]	SQLExceptionを投入
	[半角空白][+｜-]NaN[半角空白]	SQLExceptionを投入
	上記以外（double値又はBigDecimalオブジェクトにできない）	SQLExceptionを投入
SMALLINT	NULL	0
	NULL以外	？パラメタ値をlong値にしたもの
INTEGER	NULL	0
	NULL以外	？パラメタ値をlong値にしたもの
REAL	NULL	0
	Infinity	SQLExceptionを投入
	-Infinity	SQLExceptionを投入
	NaN	SQLExceptionを投入
	Long.MIN_VALUE以上かつ，Long.MAX_VALUE以下	？パラメタ値の整数部分の値をlong値にしたもの
	上記以外	SQLExceptionを投入
FLOAT	NULL	0
	Infinity	SQLExceptionを投入
	-Infinity	SQLExceptionを投入
	NaN	SQLExceptionを投入
	Long.MIN_VALUE以上かつ，Long.MAX_VALUE以下	？パラメタ値の整数部分の値をlong値にしたもの
	上記以外	SQLExceptionを投入
DECIMAL	NULL	0
	Long.MIN_VALUE以上かつLong.MAX_VALUE以下	？パラメタ値の整数部分の値をlong値にしたもの
	上記以外	SQLExceptionを投入
BINARY BLOB	NULL	0
	0長データ	0
	1バイト以上	最大8バイトをリトルエンディアン形式でlong値にしたもの
BOOLEAN	NULL	0
	true	1
	false	0
その他	−	SQLExceptionを投入

（凡例）

−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(v)　getLong(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のlongとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getLong(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized long getLong (String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値（値がNULLの場合，0を返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(w)　getObject(int parameterIndex)

【機能】

？パラメタの値を，Javaプログラミング言語のjava.lang.Objectとして取得します。

【形式】

public synchronized Object getObject (int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値を持つjava.lang.Object（値がNULLの場合，nullを返します）

【機能詳細】

？パラメタの値を，Javaプログラミング言語のjava.lang.Objectとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M｜N][VAR]CHAR	NULL	null
	NULL以外	？パラメタ値
SMALLINT	NULL	null
	NULL以外	？パラメタ値で生成したIntegerオブジェクト
INTEGER	NULL	null
	NULL以外	？パラメタ値で生成したIntegerオブジェクト
REAL	NULL	null
	NULL以外	？パラメタ値で生成したFloatオブジェクト
FLOAT	NULL	null
	NULL以外	？パラメタ値で生成したDoubleオブジェクト
DECIMAL	NULL	null
	NULL以外	？パラメタ値
DATE	NULL	null
	NULL以外	？パラメタ値で生成したjava.sql.Dateオブジェクト
TIME	NULL	null
	NULL以外	？パラメタ値で生成したjava.sql.Timeオブジェクト
TIMESTAMP	NULL	null
	NULL以外	？パラメタ値で生成したjava.sql.Timestampオブジェクト
BINARY BLOB	NULL	null
	NULL以外	？パラメタ値
BOOLEAN	NULL	null
	NULL以外	？パラメタ値で生成したBooleanオブジェクト

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• データベースアクセスエラーが発生した場合

(x)　getObject(String parameterName)

【機能】

？パラメタの値を，Javaプログラミング言語のjava.lang.Objectとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getObject(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized Object getObject (String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値を持つjava.lang.Object（値がNULLの場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(y)　getShort(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のshortとして取得します。

【形式】

public synchronized short getShort(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値（値がNULLの場合，0を返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のshortとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M｜N][VAR]CHAR	NULL	0
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]であり，かつShort.MIN_VALUE以上，Short.MAX_VALUE以下	？パラメタ値の整数部分の値をshort値にしたもの
	[半角空白]整数の文字列表現，10進数の文字列表現又は浮動小数点数の文字列表現[半角空白]であり，かつShort.MAX_VALUEより大きいかShort.MIN_VALUEより小さい	SQLExceptionを投入
	[半角空白]-Infinity[半角空白]	SQLExceptionを投入
	[半角空白][+]Infinity[半角空白]	SQLExceptionを投入
	[半角空白][+｜-]NaN[半角空白]	SQLExceptionを投入
	上記以外（double値にできない）	SQLExceptionを投入
SMALLINT	NULL	0
	NULL以外	？パラメタ値
INTEGER	NULL	0
	Short.MIN_VALUE以上かつ，Short.MAX_VALUE以下	？パラメタ値をshort値にしたもの
	上記以外	SQLExceptionを投入
REAL	NULL	0
	Infinity	SQLExceptionを投入
	-Infinity	SQLExceptionを投入
	NaN	SQLExceptionを投入
	Short.MIN_VALUE以上かつ，Short.MAX_VALUE以下	？パラメタ値の整数部分の値をshort値にしたもの
	上記以外	SQLExceptionを投入
FLOAT	NULL	0
	Infinity	SQLExceptionを投入
	-Infinity	SQLExceptionを投入
	NaN	SQLExceptionを投入
	Short.MIN_VALUE以上かつ，Short.MAX_VALUE以下	？パラメタ値の整数部分の値をshort値にしたもの
	上記以外	SQLExceptionを投入
DECIMAL	NULL	0
	Short.MIN_VALUE以上かつShort.MAX_VALUE以下	？パラメタ値の整数部分の値をshort値にしたもの
	上記以外	SQLExceptionを投入
BOOLEAN	NULL	0
	true	1
	false	0
その他	−	SQLExceptionを投入

（凡例）

−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(z)　getShort(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のshortとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係は，「getShort(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized short getShort (String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値（値がNULLの場合，0を返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(aa)　getString(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.lang.Stringオブジェクトとして取得します。

【形式】

public synchronized String getString(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値を持つjava.lang.Stringオブジェクト（値がNULLの場合，nullを返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のjava.lang.Stringオブジェクトとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M｜N][VAR]CHAR	NULL	null
	NULL以外	？パラメタ値 ただし，システムプロパティHiRDB_for_Java_DAB_CONVERT_NULLにTRUEを設定し，かつ？パラメタの値が0長文字列の場合はnull
SMALLINT	NULL	null
	NULL以外	？パラメタ値を文字列表現にしたStringオブジェクト
INTEGER	NULL	null
	NULL以外	？パラメタ値を文字列表現にしたStringオブジェクト
REAL	NULL	null
	Infinity	文字列"Infinity"のStringオブジェクト
	-Infinity	文字列"-Infinity"のStringオブジェクト
	NaN	文字列"NaN"のStringオブジェクト
	上記以外	？パラメタ値を文字列表現にしたStringオブジェクト
FLOAT	NULL	null
	Infinity	文字列"Infinity"のStringオブジェクト
	-Infinity	文字列"-Infinity"のStringオブジェクト
	NaN	文字列"NaN"のStringオブジェクト
	上記以外	？パラメタ値を文字列表現にしたStringオブジェクト
DECIMAL	NULL	null
	NULL以外	？パラメタ値を文字列表現にしたStringオブジェクト
DATE	NULL	null
	NULL以外	JdbConvert.convertDate()で取得したyyyy-MM-DD形式の文字列のStringオブジェクト
TIME	NULL	null
	NULL以外	hh:mm:ss形式の文字列のStringオブジェクト
TIMESTAMP	NULL	null
	NULL以外	yyyy-MM-DD△hh:mm:ss[.ffffff]形式の文字列のStringオブジェクト
BINARY BLOB	NULL	null
	NULL以外	？パラメタ値のStringオブジェクト
BOOLEAN	NULL	null
	true	文字列"true"のStringオブジェクト
	false	文字列"false"のStringオブジェクト

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(ab)　getString(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.lang.Stringオブジェクトとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係は，「getString(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized String getString(String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値を持つjava.lang.Stringオブジェクト（値がNULLの場合，nullを返します）。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

(ac)　getTime(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Timeオブジェクトとして取得します。

【形式】

public synchronized java.sql.Time getTime(int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値を持つjava.sql.Timeオブジェクト（値がNULLの場合，nullを返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Timeオブジェクトとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係を次に示します。

HiRDBのデータ型	？パラメタの値	戻り値
[M｜N][VAR]CHAR	NULL	null
	[半角空白]時刻形式[半角空白]	？パラメタ値の前後の半角空白を取り除きjava.sql.Timeオブジェクトにしたもの
	上記以外	SQLExceptionを返します
TIME	NULL	null
	NULL以外	？パラメタ値をjava.sql.Timeオブジェクトにしたもの
TIMESTAMP	NULL	null
	NULL以外	？パラメタ値をjava.sql.Timeオブジェクトにしたもの
その他	−	SQLExceptionを返します

（凡例）

−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• ？パラメタの値がjava.sql.Timeとして取得できない値の場合

(ad)　getTime(int parameterIndex, java.util.Calendar cal)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Timeオブジェクトとして取得します。このメソッドは指定されたカレンダーを使って取得した適切なミリ秒値から時刻を作成します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getTime(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized java.sql.Time getTime (int parameterIndex, java.util.Calendar cal) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

java.util.Calendar cal：

データベースに格納されている値のタイムゾーンが設定されたカレンダー

【戻り値】

指定された？パラメタの値を持つjava.sql.Timeオブジェクト（値がNULLの場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• ？パラメタの値がjava.sql.Timeとして取得できない値の場合

(ae)　getTime(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Timeオブジェクトとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getTime(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized java.sql.Time getTime (String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値を持つjava.sql.Timeオブジェクト（値がNULLの場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• ？パラメタの値がjava.sql.Timeとして取得できない値の場合

(af)　getTime(String parameterName, java.util.Calendar cal)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Timeオブジェクトとして取得します。このメソッドは指定されたカレンダーを使って取得した適切なミリ秒値から時刻を作成します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については，「getTime(int parameterIndex)」の【機能詳細】を参照してください。

【形式】

public synchronized java.sql.Time getTime (String parameterName, java.util.Calendar cal) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

java.util.Calendar cal：

データベースに格納されている値のタイムゾーンが設定されたカレンダー

【戻り値】

指定された？パラメタの値を持つjava.sql.Timeオブジェクト（値がNULLの場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• ？パラメタの値がjava.sql.Timeとして取得できない値の場合

(ag)　getTimestamp(int parameterIndex)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Timestampオブジェクトとして取得します。

【形式】

public synchronized java.sql.Timestamp getTimestamp (int parameterIndex) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

【戻り値】

指定された？パラメタの値を持つjava.sql.Timestampオブジェクト（値がNULLの場合，nullを返します）

【機能詳細】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Timestampオブジェクトとして取得します。

HiRDBのデータ型による？パラメタ値と戻り値の関係については「TIME型，DATE型，及びTIMESTAMP型列のデータ変換処理」を参照してください。TIME型，DATE型，TIMESTAMP型，文字列型以外のデータ型を取得した場合，SQLExceptionを投入します。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• ？パラメタの値がjava.sql.Timestampとして取得できない値の場合

(ah)　getTimestamp(int parameterIndex, java.util.Calendar cal)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Timestampオブジェクトとして取得します。このメソッドは指定されたカレンダーを使って取得した適切なミリ秒値からタイムスタンプを作成します。

各HiRDBのデータ型での？パラメタ値と戻り値の関係については，「TIME型，DATE型，及びTIMESTAMP型列のデータ変換処理」を参照してください。TIME型，DATE型，TIMESTAMP型，文字列型以外のデータ型を取得した場合，SQLExceptionを投入します。

【形式】

public synchronized java.sql.Timestamp getTimestamp (int parameterIndex, java.util.Calendar cal) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

java.util.Calendar cal：

データベースに格納されている値のタイムゾーンが設定されたカレンダー

【戻り値】

指定された？パラメタの値を持つjava.sql.Timestampオブジェクト（値がNULLの場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• ？パラメタの値がjava.sql.Timestampとして取得できない値の場合

(ai)　getTimestamp(String parameterName)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Timestampオブジェクトとして取得します。

各HiRDBのデータ型での？パラメタ値と戻り値の関係については，「TIME型，DATE型，及びTIMESTAMP型列のデータ変換処理」を参照してください。TIME型，DATE型，TIMESTAMP型，文字列型以外のデータ型を取得した場合，SQLExceptionを投入します。

【形式】

public synchronized java.sql.Timestamp getTimestamp (String parameterName) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

【戻り値】

指定された？パラメタの値を持つjava.sql.Timestampオブジェクト（値がNULLの場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• ？パラメタの値がjava.sql.Timestampとして取得できない値の場合

(aj)　getTimestamp(String parameterName, java.util.Calendar cal)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.sql.Timestampオブジェクトとして取得します。このメソッドは指定されたカレンダーを使って取得した適切なミリ秒値からタイムスタンプを作成します。

各HiRDBのデータ型での？パラメタ値と戻り値の関係については，「TIME型，DATE型，及びTIMESTAMP型列のデータ変換処理」を参照してください。TIME型，DATE型，TIMESTAMP型，文字列型以外のデータ型を取得した場合，SQLExceptionを投入します。

【形式】

public synchronized java.sql.Timestamp getTimestamp (String parameterName, java.util.Calendar cal) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

java.util.Calendar cal：

データベースに格納されている値のタイムゾーンが設定されたカレンダー

【戻り値】

指定された？パラメタの値を持つjava.sql.Timestampオブジェクト（値がNULLの場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがINパラメタである場合

• 指定した？パラメタはこのメソッドでは取得できないデータ型である場合

• ？パラメタの値がjava.sql.Timestampとして取得できない値の場合

(ak)　registerOutParameter(int parameterIndex, int sqlType)

【機能】

指定されたOUTパラメタのデータ型を，指定されたJDBCの型として登録します。

このメソッドで，DECIMAL型のOUTパラメタ及びINOUTパラメタを設定する場合，スケール値は0とみなします。

【形式】

public synchronized void registerOutParameter(int parameterIndex, int sqlType) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

int sqlType：

登録するJDBCの型

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対して，close()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• HiRDBのデータ型とマッピングできないJDBCの型を指定した場合

(al)　registerOutParameter(int parameterIndex, int sqlType, int scale)

【機能】

指定されたOUTパラメタのデータ型を，指定されたJDBCの型として登録します。

【形式】

public synchronized void registerOutParameter(int parameterIndex, int sqlType, int scale) throws SQLException

【引数】

int parameterIndex：

？パラメタの番号。最初のパラメタは1，2番目のパラメタは2，…と指定します。

int sqlType：

登録するJDBCの型

int scale：

位取り。指定できる範囲は0≦scale≦38です。

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対して，close()が既に発行されている場合

• 存在しない？パラメタの番号を指定した場合

• 指定した？パラメタがINパラメタである場合

• HiRDBのデータ型とマッピングできないJDBCの型を指定した場合

• scaleに指定した値が0未満，又は38より大きい場合

(am)　registerOutParameter(String parameterName, int sqlType)

【機能】

指定されたOUTパラメタのデータ型を，指定されたJDBCの型として登録します。

このメソッドで，DECIMAL型のOUTパラメタ及びINOUTパラメタを設定する場合，スケール値は0とみなします。

【形式】

public synchronized void registerOutParameter(String parameterName, int sqlType) throws SQLException

【引数】

String parameterName：

パラメタ名。大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符（"）が含まれている場合，引用符（"）も？パラメタ名に含まれます。

int sqlType：

登録するJDBCの型

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対して，close()が既に発行されている場合

• 存在しないパラメタ名を指定した場合

  parameterNameの指定値が，null又は0長文字列の場合も含みます。

• 指定した？パラメタがINパラメタである場合

• HiRDBのデータ型とマッピングできないJDBCの型を指定した場合

(an)　registerOutParameter(String parameterName, int sqlType, int scale)

【機能】

指定されたOUTパラメタのデータ型を，指定されたJDBCの型として登録します。

【形式】

public synchronized void registerOutParameter(String parameterName, int sqlType, int scale) throws SQLException

【引数】

String parameterName：

パラメタ名。大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符（"）が含まれている場合，引用符（"）も？パラメタ名に含まれます。

int sqlType：

登録するJDBCの型

int scale：

位取り。指定できる範囲は0≦scale≦38です。

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対して，close()が既に発行されている場合

• 存在しないパラメタ名を指定した場合

  parameterNameの指定値が，null又は0長文字列の場合も含みます。

• 指定した？パラメタがINパラメタである場合

• HiRDBのデータ型とマッピングできないJDBCの型を指定した場合

• scaleに指定した値が0未満，又は38より大きい場合

(ao)　setAsciiStream(String parameterName, java.io.InputStream x, int length)

【機能】

指定されたjava.io.InputStreamオブジェクトの持つ値を指定された？パラメタ値に指定された長さだけ設定します。

【形式】

public synchronized void setAsciiStream(String parameterName, java.io.InputStream x, int length) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

java.io.InputStream x：

？パラメタに設定する値を持つInputStreamオブジェクト

int length：

設定するストリームのバイト数

【戻り値】

なし。

【機能詳細】

指定されたInputStreamオブジェクトの持つ値を？パラメタ値に設定します。

このメソッドは，xから入力を終えた後，xに対してclose()メソッドを実行しません。

？パラメタのHiRDBのデータ型が[M｜N][VAR]CHAR，BINARY，BLOB以外はSQLExceptionとなります。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがOUTパラメタである場合

• lengthに0未満の値が指定された場合

• このメソッドでは設定できない？パラメタのデータ型である場合

• 指定された値が？パラメタのデータ型の範囲外，又は変換できない形式である場合

• ストリームからの読み込みに失敗した場合

(ap)　setBigDecimal(String parameterName, java.math.BigDecimal x)

【機能】

指定されたjava.math.BigDecimal値を指定された？パラメタ値に設定します。

【形式】

public synchronized void setBigDecimal(String parameterName, java.math.BigDecimal x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

java.math.BigDecimal x：

？パラメタに設定する値を持つBigDecimalオブジェクト

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがOUTパラメタである場合

• 指定したデータの整数部のけた数が，表定義の整数部のけた数を超えるため，表定義のデータ型に変換できない場合

• このメソッドでは設定できない？パラメタのデータ型である場合

• 指定された値が？パラメタのデータ型の範囲外，又は変換できない形式である場合

(aq)　setBinaryStream(String parameterName, java.io.InputStream x, int length)

【機能】

指定された？パラメタの値を，Javaプログラミング言語のjava.math.BigDecimalオブジェクトとして取得します。

【形式】

public synchronized void setBinaryStream(String parameterName, java.io.InputStream x, int length) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

java.io.InputStream x：

？パラメタに設定する値を持つInputStreamオブジェクト

int length：

設定するストリームのバイト数

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがOUTパラメタである場合

• lengthに0未満の値が指定された場合

• このメソッドでは設定できない？パラメタのデータ型である場合

• 指定された値が？パラメタのデータ型の範囲外，又は変換できない形式である場合

• ストリームからの読み込みに失敗した場合

(ar)　setBoolean(String parameterName, boolean x)

【機能】

指定されたboolean値を？パラメタ値に設定します。

指定した?パラメタのHiRDBのデータ型がCHAR，MCHAR，NCHAR，VARCHAR，MVARCHAR，NVARHARの場合，?パラメタへの設定値はxがtrueのときは"true"，falseのときは"false△"（△は半角スペース）となります。

【形式】

public synchronized void setBoolean(String parameterName, boolean x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

boolean x：

？パラメタに設定する値

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定した？パラメタがOUTパラメタである場合

(as)　setByte(String parameterName, byte x)

【機能】

指定されたbyte値を？パラメタ値に設定します。

【形式】

public synchronized void setByte(String parameterName, byte x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

byte x：

？パラメタに設定する値

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定した？パラメタがOUTパラメタである場合

(at)　setBytes(String parameterName,byte[] x)

【機能】

指定されたbyte配列を？パラメタ値に設定します。

【形式】

public synchronized void setBytes(String parameterName, byte[] x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

byte[] x：

？パラメタに設定する値を持つbyte配列

【戻り値】

なし。

【機能詳細】

？パラメタのHiRDBのデータ型がBINARY，BLOB以外はSQLExceptionとなります。

このメソッドでは，byte配列中の設定値を参照しません。executeXXX()メソッド実行時にbyte配列中の設定値を参照します。そのため，このメソッド実行からexecuteXXX()メソッド実行するまでの間にbyte配列中の設定値を変更した場合，変更後の設定値が？パラメタの値となります。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• 指定した？パラメタがOUTパラメタである場合

(au)　setCharacterStream(String parameterName, Reader x, int length)

【機能】

指定されたReaderオブジェクトの持つ値を？パラメタ値に設定します。

？パラメタのHiRDBのデータ型が[M｜N][VAR]CHAR，BINARY，BLOB以外はSQLExceptionとなります。

【形式】

public synchronized void setCharacterStream(String parameterName, Reader x, int length) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

Reader x：

？パラメタに設定する値を持つReaderオブジェクト

int length：

文字数

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• lengthに0未満の値が指定された場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• エンコード失敗

• 指定した？パラメタがOUTパラメタである場合

(av)　setDate(String parameterName, java.sql.Date x)

【機能】

指定されたjava.sql.Dateオブジェクトの持つ値を？パラメタ値に設定します。

【形式】

public synchronized void setDate(String parameterName, java.sql.Date x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

java.sql.Date x：

？パラメタに設定する値を持つjava.sql.Dateオブジェクト

【戻り値】

なし。

【機能詳細】

ローカルタイムで指定されたjava.sql.Dateオブジェクトを指定されたカレンダーのタイムゾーンの時間に変換し，？パラメタ値に設定します。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• 指定した？パラメタがOUTパラメタである場合

(aw)　setDate(String parameterName, java.sql.Date x,Calendar cal)

【機能】

ローカルタイムで指定されたjava.sql.Dateオブジェクトを指定されたカレンダーのタイムゾーンの時間に変換し，？パラメタ値に設定します。

【形式】

public synchronized void setDate(String parameterName, java.sql.Date x,Calendar cal) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

java.sql.Date x：

？パラメタに設定する値を持つjava.sql.Dateオブジェクト

Calendar cal：

データベースに格納する値のタイムゾーンが設定されたカレンダー。nullが指定された場合，JavaVMのデフォルトのタイムゾーンのカレンダーが指定されたとします。

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• 指定した？パラメタがOUTパラメタである場合

(ax)　setDouble(String parameterName, double x)

【機能】

指定されたdouble値を？パラメタ値に設定します。

【形式】

public synchronized void setDouble(String parameterName, double x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

double x：

？パラメタに設定する値

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• 指定した？パラメタがOUTパラメタである場合

(ay)　setFloat(String parameterName, float x)

【機能】

指定されたfloat値を？パラメタ値に設定します。

【形式】

public synchronized void setFloat(String parameterName, float x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

float x：

？パラメタに設定する値

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• 指定した？パラメタがOUTパラメタである場合

(az)　setInt(String parameterName, int x)

【機能】

指定されたint値を？パラメタ値に設定します。

【形式】

public synchronized void setInt(String parameterName, int x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

int x：

？パラメタに設定する値

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• 指定した？パラメタがOUTパラメタである場合

(ba)　setLong(String parameterName, long x)

【機能】

指定されたlong値を？パラメタ値に設定します。

【形式】

public synchronized void setLong(String parameterName, long x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

long x：

？パラメタに設定する値

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• 指定した？パラメタがOUTパラメタである場合

(bb)　setNull(String parameterName,int sqlType)

【機能】

指定された？パラメタにNULL値を設定します。

引数sqlTypeはこのドライバでは無視します。

【形式】

public synchronized void setNull(String parameterName,int sqlType) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

int sqlType：

JDBCのSQLデータ型

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定した？パラメタがOUTパラメタである場合

(bc)　setObject(String parameterName, Object x)

【機能】

指定されたオブジェクトの持つ値を？パラメタ値に設定します。

【形式】

public synchronized void setObject(String parameterName, Object x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

Object x：

？パラメタに設定する値を持つオブジェクト

【戻り値】

なし。

【機能詳細】

指定されたオブジェクトの持つ値を？パラメタ値に設定します。

parameterIndexで指定した?パラメタの型がHiRDBのCHAR，MCHAR，NCHAR，VARCHAR，MVARCHAR，又はNVARHARで，xがBooleanオブジェクトの場合，?パラメタへの設定値はxがtrueのときは"true"，falseのときは"false△"(△は半角スペース)となります。

xがbyte配列の場合，byte配列中の設定値を参照しません。executeXXX()メソッド実行時にbyte配列中の設定値を参照します。そのため，このメソッド実行からexecuteXXX()メソッド実行するまでの間にbyte配列中の設定値を変更した場合，変更後の設定値が？パラメタの値となります。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• 指定した？パラメタがOUTパラメタである場合

(bd)　setObject(String parameterName, Object x, int targetSqlType)

【機能】

指定されたオブジェクトの持つ値を？パラメタ値に設定します。

【形式】

public synchronized void setObject(String parameterName, Object x, int targetSqlType) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

Object x：

？パラメタに設定する値を持つオブジェクト

int targetSqlType：

JDBCのSQLデータ型

【戻り値】

なし。

【機能詳細】

指定されたオブジェクトの持つ値を？パラメタ値に設定します。

targetSqlTypeがjava.sql.Types.CHAR，java.sql.Types.VARCHAR，又はjava.sql.Types.LONGVARCHARで，xがBooleanオブジェクトの場合，?パラメタへの設定値はxがtrueのときは"1"，"0"になります。

なお，HiRDBデータ型であるNCHAR，NVARCHAR型の?パラメタへの設定値が"1"，"0"になる場合，SQLExceptionを投入します。

xがbyte配列の場合，byte配列中の設定値を参照しません。executeXXX()メソッド実行時にbyte配列中の設定値を参照します。そのため，このメソッド実行からexecuteXXX()メソッド実行するまでの間にbyte配列中の設定値を変更した場合，変更後の設定値が？パラメタの値となります。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• targetSqlTypeが次の場合

  Types.ARRAY，Types.CLOB，Types.REF，Types.STRUCT

• 指定した？パラメタがOUTパラメタである場合

(be)　setObject(String parameterName, Object x, int targetSqlType, int scale)

【機能】

指定されたオブジェクトの持つ値を？パラメタ値に設定します。

【形式】

public synchronized void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

Object x：

？パラメタに設定する値を持つオブジェクト

int targetSqlType：

JDBCのSQLデータ型

int scale：

位取り（指定値は無視する）

【戻り値】

なし。

【機能詳細】

指定されたオブジェクトの持つ値を？パラメタ値に設定します。

targetSqlTypeがjava.sql.Types.CHAR，java.sql.Types.VARCHAR，又はjava.sql.Types.LONGVARCHARで，xがBooleanオブジェクトの場合，?パラメタへの設定値はxがtrueのときは"1"，"0"になります。

なお，HiRDBデータ型であるNCHAR，NVARCHAR型の?パラメタへの設定値が"1"，"0"になる場合，SQLExceptionを投入します。

xがbyte配列の場合，byte配列中の設定値を参照しません。executeXXX()メソッド実行時にbyte配列中の設定値を参照します。そのため，このメソッド実行からexecuteXXX()メソッド実行するまでの間にbyte配列中の設定値を変更した場合，変更後の設定値が？パラメタの値となります。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• targetSqlTypeが次の場合

  Types.ARRAY，Types.CLOB，Types.REF，Types.STRUCT

• 指定した？パラメタがOUTパラメタである場合

(bf)　setShort(String parameterName, short x)

【機能】

指定されたshort値を？パラメタ値に設定します。

【形式】

public synchronized void setShort(String parameterName, short x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

short x：

？パラメタに設定する値

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定した？パラメタがOUTパラメタである場合

(bg)　setString(String parameterName, String x)

【機能】

指定されたStringオブジェクトを？パラメタ値に設定します。

【形式】

public synchronized void setString(String parameterName, String x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

String x：

？パラメタに設定する値を持つStringオブジェクト

【戻り値】

なし。

【機能詳細】

引数xで指定されたStringオブジェクトを？パラメタに設定します。

引数xの指定値が0長文字列の場合の？パラメタ設定値を次の表に示します。

表17‒34　？パラメタの設定値

？パラメタのデータ型	？パラメタの設定値
[M｜N][VAR]CHAR	システムプロパティHiRDB_for_Java_DAB_CONVERT_NULLにTRUEを設定している場合 null 上記以外 0長文字列
BINARY，又はBLOB	0長文字列
その他	null

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• エンコード失敗

• 指定した？パラメタがOUTパラメタである場合

(bh)　setTime(String parameterName, Time x)

【機能】

指定されたjava.sql.Timeオブジェクトを？パラメタ値に設定します。

【形式】

public synchronized void setTime(String parameterName, Time x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

java.sql.Time x：

？パラメタに設定する値を持つjava.sql.Timeオブジェクト

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定した？パラメタがOUTパラメタである場合

(bi)　setTime(String parameterName, java.sql.Time x,Calendar cal)

【機能】

ローカルタイムで指定されたjava.sql.Timeオブジェクトを指定されたカレンダーのタイムゾーンの時間に変換し，？パラメタ値に設定します。

【形式】

public synchronized void setTime(String parameterName, java.sql.Time x,Calendar cal) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

java.sql.Time x：

？パラメタに設定する値を持つjava.sql.Timeオブジェクト

Calendar cal：

データベースに格納する値のタイムゾーンが設定されたカレンダー。nullが指定された場合，JavaVMのデフォルトのタイムゾーンのカレンダーが指定されたとします。

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定した？パラメタがOUTパラメタである場合

(bj)　setTimestamp(String parameterName, java.sql.Timestamp x)

【機能】

指定されたjava.sql.Timestampオブジェクトを？パラメタ値に設定します。

【形式】

public synchronized void setTimestamp(String parameterName, java.sql.Timestamp x) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

java.sql.Timestamp x：

？パラメタに設定する値を持つjava.sql.Timestampオブジェクト

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• 指定した？パラメタがOUTパラメタである場合

(bk)　setTimestamp(String parameterName, java.sql.Timestamp x,Calendar cal)

【機能】

ローカルタイムで指定されたjava.sql.Timestampオブジェクトを指定されたカレンダーのタイムゾーンの時間に変換し，？パラメタ値に設定します。

【形式】

public synchronized void setTimestamp(String parameterName, java.sql.Timestamp x,Calendar cal) throws SQLException

【引数】

String parameterName：

パラメタ名。パラメタ名の大文字と小文字は区別しません。parameterNameの文字列すべてを？パラメタ名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も？パラメタ名に含まれます。

java.sql.Timestamp x：

？パラメタに設定する値を持つjava.sql.Timestampオブジェクト

Calendar cal：

データベースに格納する値のタイムゾーンが設定されたカレンダー。nullが指定された場合，JavaVMのデフォルトのタイムゾーンのカレンダーが指定されたとします。

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対してclose()が既に発行されている場合

• 存在しないパラメタ名を指定した場合（parameterNameの指定値がnull又は0長文字列の場合も含む）

• ？パラメタのHiRDBデータ型がこのメソッドでは設定できないデータ型の場合

• 指定された値が列のデータ型の範囲外，又は変換できない形式の場合

• 指定した？パラメタがOUTパラメタである場合

(bl)　wasNull()

【機能】

最後に読み込まれたOUTパラメタ又はINOUTパラメタの値が，NULLかどうかを取得します。

【形式】

public synchronized boolean wasNull() throws SQLException

【引数】

なし。

【戻り値】

最後に読み込まれたパラメタがNULLの場合はtrue，そうでない場合はfalseを返します。

各条件での戻り値を次の表に示します。

表17‒35　各条件での戻り値

条件	戻り値
最後に読み込まれたパラメタがNULLの場合	true
最後に読み込まれたパラメタがNULL以外の場合	false
execute系メソッド実行前（OUTパラメタ用ResultSetがnull）の場合	false
一度も値の取得（getXXX）を行っていない場合	false
clearParameters実行後の場合	clearParameters実行前と同じ値
execute系メソッドの再実行後（OUTパラメタ用ResultSetのcloseをまたぐ）の場合	false

【発生する例外】

次の場合，SQLExceptionを投入します。

• CallableStatementオブジェクトに対してclose()が既に発行されている場合

• このCallableStatementオブジェクトを生成したConnectionオブジェクトに対して，close()が既に発行されている場合

(a)　ストアドプロシジャのOUTパラメタの属性

• JDBC規格では，executeXXXメソッドを実行する前にregisterOutParameterメソッドを実行して，OUTパラメタ及びINOUTパラメタの属性を登録する必要があります。しかし，Type4 JDBCドライバでは，CALL文の前処理で取得したOUTパラメタ及びINOUTパラメタの属性を使用するため，registerOutParameterメソッドの実行は任意です。

• registerOutParameterメソッドで設定した情報は，executeXXXメソッド実行時に有効となります。そのため，executeXXXメソッド実行後にregisterOutParameterメソッドで設定しても実行結果には影響しません。また，executeXXXメソッド実行後にclearParametersで設定情報をクリアしても実行結果には影響しません。

(b)　DECIMAL型使用時の注意事項

DECIMAL型のOUTパラメタ及びINOUTパラメタを設定する場合，小数点以下のけた数を受け入れない形式のregisterOutParameter(int parameterIndex, int sqlType)メソッドを使用したときは，けた数を0とみなします。

(c)　DECIMAL型の？パラメタに対する値指定

HiRDBのDECIMAL型の？パラメタに対してsetXXXメソッドで値を指定する場合，CALL文の前処理で取得した精度及び位取りと，値の精度及び位取りが一致していないときの動作を次に示します。

CALL文の前処理で取得した精度よりも大きい場合：SQLExceptionを投入します。

CALL文の前処理で取得した精度よりも小さい場合：拡張します。

CALL文の前処理で取得した位取りよりも大きい場合：CALL文の前処理で取得した位取りで切り捨てます。

CALL文の前処理で取得した位取りよりも小さい場合：0で補完し拡張します。

(d)　1コネクション当たりのステートメントオブジェクト数の上限

1つのConnectionオブジェクトに対し，使用中のステートメントオブジェクト（Statement，PreparedStatement，及びCallableStatement)の数の合計が4096以上となった場合，SQLExceptionを投入します。詳細は「Statementインタフェース」の「注意事項」を参照してください。