カーソル

データへのポインタです。1 行ずつの操作ができます。

概要

カーソルは、結果セット内に "position" を含むエンティティで、1 行ずつ操作するように設計されています。ライフ・サイクル内で操作できる関連コマンドは、以下のとおりです。

DECLARE — カーソルの内容を指定する。
OPEN — カーソルをオープンする。
FETCH — 任意のカーソル位置からデータを取得する。
CLOSE — 開いているカーソルをクローズし、メモリを解放する。

ホスト変数の指定に使用する INTO 節は、DECLARE 文と FETCH 文のいずれか、または両方の節として指定できます。

例

以下の例は、埋め込み SQL 内で使用されている EmpCursor と呼ばれるカーソルです。

   SET name="John Doe",state="##"
   &sql(DECLARE EmpCursor CURSOR FOR SELECT Name, Home_State
       INTO :name,:state FROM Sample.Person)
   WRITE !,"BEFORE: Name=",name," State=",state
   &sql(OPEN EmpCursor)
   FOR { &sql(FETCH EmpCursor)
        QUIT:SQLCODE  
        WRITE !,"DURING: Name=",name," State=",state }
   &sql(CLOSE EmpCursor)
   WRITE !,"AFTER: Name=",name," State=",state