ExecuteScalar(void *, size_t, ul_column_storage_type, const char *, ...)-Methode

public virtual bool ExecuteScalar(
    void * dstPtr,
    size_t dstSize,
    ul_column_storage_type dstType,
    const char * sql,
    ... 
)

dstPtr Ein Zeiger auf eine Variable des erforderlichen Datentyps, um den Wert aufzunehmen.
dstSize Die Größe der Variablen für den Empfang des Werts, falls zutreffend.
dstType Der Typ des Werts für die Abfrage. Er muss zum Variablentyp passen.
sql Die SELECT-Anweisung, optional mit '?'- Parametern.
... String (char *)-Parameterwerte zum Ersetzen.

True, wenn die Abfrage erfolgreich ausgeführt und ein Wert abgerufen wurde. Sonst wird False zurückgegeben, wenn kein Wert abgerufen wurde. Prüfen Sie SQLCODE, um zu ermitteln, warum False zurückgegeben wird. Der ausgewählte Wert ist NULL, wenn keine Warnung oder ein Fehler (SQLE_NOERROR) angegeben wird.

dstPtr muss auf eine Variable des richtigen Typs verweisen, die zu dstType passt. dstSize ist nur für Werte mit variabler Größe erforderlich, wie Zeichenfolgen und Binärdaten. Sonst wird die Angabe ignoriert. Die variablen Werte der Parameterliste müssen den Parametern in der Anweisung entsprechen und es wird angenommen, dass alle Werte Zeichenfolgen sind. (Intern wandelt UltraLite die Parameterwerte wie für die Anweisung erforderlich um.)

Die folgenden Typen werden unterstützt:

#UL_TYPE_BIT/#UL_TYPE_TINY Verwenden Sie den Variablentyp ul_byte (8 Bit, ohne Vorzeichen).
#UL_TYPE_U_SHORT/#UL_TYPE_S_SHORT Verwenden Sie den Variablentyp ul_u_short/ul_s_short (16 Bit).
#UL_TYPE_U_LONG/#UL_TYPE_S_LONG Verwenden Sie den Variablentyp ul_u_long/ul_s_long (32 Bit).
#UL_TYPE_U_BIG/#UL_TYPE_S_BIG Verwenden Sie den Variablentyp ul_u_big/ul_s_big (64 Bit).
#UL_TYPE_DOUBLE Verwenden Sie den Variablentyp ul_double (double).
#UL_TYPE_REAL Verwenden Sie den Variablentyp ul_real (float).
#UL_TYPE_BINARY Verwenden Sie den Variablentyp und geben Sie ul_binary dstSize (wie in GetBinary()) an.
#UL_TYPE_TIMESTAMP_STRUCT Verwenden Sie den Variablentyp DECL_DATETIME.
#UL_TYPE_CHAR Verwenden Sie den Variablentyp char [] (Zeichenpuffer) und legen Sie dstSize mit der Größe des Puffers fest (wie in GetString()).
#UL_TYPE_WCHAR Verwenden Sie den Variablentyp ul_wchar [] (ein breiter Zeichenpuffer) und legen Sie dstSize mit der Größe des Puffers fest (wie in GetString()).
#UL_TYPE_TCHAR Gleich wie in UL_TYPE_CHAR oder UL_TYPE_WCHAR, abhängig davon, für welche Version die Funktion aufgerufen wird.

Weitere Hinweise zu diesen Typen finden Sie unter ul_column_storage_type-Enumeration.

Das folgende Beispiel zeigt den Abruf einer Ganzzahl:

ul_u_long	val;
ok = conn->ExecuteScalar( &val, 0, UL_TYPE_U_LONG,
    "SELECT count(*) FROM t WHERE col LIKE ?", "ABC%" );

Das folgende Beispiel zeigt den Abruf einer Zeichenfolge:

char	val[40];
ok = conn->ExecuteScalar( &val, sizeof(val), UL_TYPE_CHAR,
    "SELECT uuidtostr( newid() )" );

ExecuteScalar(void , size_t, ul_column_storage_type, const char , ...)-Methode

Syntax

Parameter

Rückgabe

Bemerkungen