Mit dieser Anweisung rufen Sie Informationen über eine Variable innerhalb eines Deskriptorbereichs oder ihren Wert ab.

Syntax

GET DESCRIPTOR Deskriptorname
{ Hostvariable = COUNT | VALUE { Ganzzahl | Hostvariable } Zuweisung, ... }

Zuweisung :
 Hostvariable =  
TYPE 
| LENGTH 
| PRECISION 
| SCALE 
| DATA
| INDICATOR 
| NAME 
| NULLABLE 
| RETURNED_LENGTH

Deskriptorname : Bezeichner

Bemerkungen

Die GET DESCRIPTOR-Anweisung wird verwendet, um Informationen über eine Variable innerhalb eines Deskriptorbereichs abzurufen oder um ihren Inhalt zu ermitteln.

Mit dem Wert von { Ganzzahl | Hostvariable } wird die Variable innerhalb des Deskriptorbereichs bestimmt, über den die Daten abgerufen werden sollen. Bei GET … DATA findet eine Typüberprüfung statt, um sicherzustellen, dass die Hostvariable und die Deskriptorvariable den gleichen Datentyp haben. LONG VARCHAR und LONG BINARY werden von GET DESCRIPTOR DATA nicht unterstützt.

Wenn ein Fehler auftritt, wird er in dem SQLCA zurückgegeben.

Berechtigungen

Keine.

Nebenwirkungen

Keine.

Siehe auch

• ALLOCATE DESCRIPTOR-Anweisung [ESQL]
• DEALLOCATE DESCRIPTOR-Anweisung [ESQL]
• SET DESCRIPTOR-Anweisung [ESQL]
• Der SQL-Deskriptor-Bereich (SQLDA)

Standards und Kompatibilität

Beispiel

Mit dem folgenden Beispiel wird der Typ einer Spalte mit der Position "Spaltennummer" in SQLDA zurückgegeben.

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 );
}

Ein detaillierteres Beispiel finden Sie unter ALLOCATE DESCRIPTOR-Anweisung [ESQL].