SQLExceptionクラス

SQLExceptionクラスは、生成されたエラー、エラー・コードおよび関連するメッセージに関する情報を提供します。

表13-39 SQLExceptionの概要

メソッド	説明
SQLException()	`SQLException`のコンストラクタです。
getErrorCode()	データベース・エラー・コードを戻します。
getMessage()	この例外のエラー・メッセージの`string`を戻します。
getNLSMessage()	この例外のエラー・メッセージの`string`を戻します（Unicodeサポート）。
getNLSUStringMessage()	この例外のエラー・メッセージの`UString`を戻します（Unicodeサポート）。
getUStringMessage()	この例外のエラー・メッセージの`UString`を戻します。
getXAErrorCode()	例外のメッセージ文字列を戻します。
setErrorCtx()	エラー・コンテキストを設定します。
what()	この`SQLException`に関連付けられているエラー・メッセージを戻します。

SQLException()

これは、SQLExceptionコンストラクタです。

構文	説明
SQLException();	`NULLのSQLException`オブジェクトが作成されます。
SQLException( const SQLException &e);	`SQLException`オブジェクトが別の`SQLException`オブジェクトのコピーとして作成されます。

パラメータ	説明
e	コピーする`SQLException`を指定します。

getErrorCode()

データベース・エラー・コードを取得します。

構文

int getErrorCode() const;

getMessage()

エラー・メッセージ文字列が作成されていた場合は、このSQLExceptionのエラー・メッセージ文字列を戻します。SQLExceptionにエラー・メッセージが作成されていない場合は、NULLを戻します。

構文

string getMessage() const;

getNLSMessage()

エラー・メッセージのstringが作成されている場合は、このSQLExceptionのエラー・メッセージのstringを戻します。グローバリゼーション対応環境を渡します。SQLExceptionにエラー・メッセージが作成されていない場合は、NULLのstringを戻します。エラー・メッセージには、環境に関連付けられているキャラクタ・セットが使用されます。

構文

string getNLSMessage(
   Environment *env) const;

パラメータ	説明
env	グローバリゼーション対応環境を指定します。

getNLSUStringMessage()

エラー・メッセージのUStringが作成されている場合は、このSQLExceptionのエラー・メッセージのUStringを戻します。グローバリゼーション対応環境を渡します。SQLExceptionにエラー・メッセージが作成されていない場合は、NULLのUStringを戻します。エラー・メッセージには、環境に関連付けられているキャラクタ・セットが使用されます。

構文

UString getNLSUStringMessage(
   Environment *env) const;

パラメータ	説明
env	グローバリゼーション対応環境を指定します。

getUStringMessage()

エラー・メッセージのUStringが作成されている場合は、このSQLExceptionのエラー・メッセージのUStringを戻します。SQLExceptionにエラー・メッセージが作成されていない場合は、NULLのUStringを戻します。エラー・メッセージには、環境に関連付けられているキャラクタ・セットが使用されます。

構文

UString getUStringMessage() const;

getXAErrorCode()

発生した例外の原因がXAエラーであるかSQLエラーであるかを判別します。

動的登録を使用するC++ XAアプリケーションで使用します。例外の原因がXAの場合はXAエラー・コードを、それ以外の場合はXA_OKを戻します。

構文

int getXAErrorCode(
   const string &dbname) const;

パラメータ	説明
dbname	データベース名を指定します。このデータベース名は、Open Stringに指定されてリソース・マネージャへの接続時に使用されるオプションの`dbname`と同じです。

setErrorCtx()

エラー・コンテキストへのポインタを設定します。

構文

void setErrorCtx(
   void *ctx);

パラメータ	説明
ctx	エラー・コンテキストへのポインタを指定します。

what()

標準C++準拠関数。SQLExceptionに関連付けられているエラー・メッセージを戻します。

構文

const char *what() const throw();