カーソル

データへのポインタです。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