VALUES INTO ステートメントは、多くても 1 つの行から成る結果表を作成して、 その行の値をホスト変数に割り当てます。
呼び出し
このステートメントは、アプリケーション・プログラムに組み込む方法のみ可能です。 これは、動的に作成できない実行可能ステートメントです。
許可
権限は不要です。
構文
>>-VALUES----+-expression----------------+--INTO----------------> | .-,-------------. | | V | | '-(-----expression---+---)--' .-,----------------. V | >--------host-variable---+-------------------------------------><
説明
結果行の最初の値はリストの最初の変数、 2 番目値は 2 番目の変数に割り当てられます。 以下同様です。 ホスト変数の数が列の値の数より少ない場合は、 SQLCA の SQLWARN3 フィールドに値 'W' が割り当てられます (付録 B, SQL 連絡 (SQLCA) を参照)。
各変数には、割り当てと比較で説明されている規則に基づいて値が割り当てられます。 割り当ては、リストに指定された順序で行われます。
エラーが発生すると、値はホスト変数に割り当てられません。
例
例 1: この C の例では、CURRENT PATH 特殊レジスターの値を検索してホスト変数に入れます。
EXEC SQL VALUES(CURRENT PATH) INTO :hvl;
例 2: この C の例では、LOB フィールドの一部を検索してホスト変数に入れます。 LOB ロケーターを使用して、据え置き検索を実行します。
EXEC SQL VALUES (substr(:locator1,35)) INTO :details;