この文は、記述子領域内の変数に関する情報を取り出すか、その値を取り出すために使用します。

構文

GET DESCRIPTOR descriptor-name
{ hostvar = COUNT | VALUE { integer | hostvar } assignment, ... }

assignment :
 hostvar =  
TYPE 
| LENGTH 
| PRECISION 
| SCALE 
| DATA
| INDICATOR 
| NAME 
| NULLABLE 
| RETURNED_LENGTH

descriptor-name : identifier

備考

GET DESCRIPTOR 文は、記述子領域内の変数に関する情報を取り出すか、その値を取り出すために使用します。

値 { integer | hostvar } には、情報を取り出す記述子領域内の変数を指定します。GET ... DATA を実行すると型チェックが実行され、ホスト変数と記述子変数のデータ型が同じかどうか確認されます。LONG VARCHAR と LONG BINARY は GET DESCRIPTOR ... DATA ではサポートされません。

エラーが発生すると、戻り値は SQLCA に格納されます。

パーミッション

なし

関連する動作

なし

参照

• ALLOCATE DESCRIPTOR 文 [ESQL]
• DEALLOCATE DESCRIPTOR 文 [ESQL]
• SET DESCRIPTOR 文 [ESQL]
• SQLDA (SQL descriptor area)

標準と互換性

例

次の例は、sqlda の位置 col_num にあるカラムの型を返します。

int get_type( SQLDA *sqlda, int col_num )
{
    EXEC SQL BEGIN DECLARE SECTION;
    int ret_type;
    int col = col_num;
    EXEC SQL END DECLARE SECTION;
EXEC SQL GET DESCRIPTOR sqlda VALUE :col :ret_type = TYPE;
    return( ret_type );
}

詳細例については、ALLOCATE DESCRIPTOR 文 [ESQL]を参照してください。