SQL zu C: binär
Die Bezeichner für die binären ODBC SQL-Datentypen sind:
SQL_BINARY
SQL_VARBINARY
SQL_LONGVARBINARY
Die folgende Tabelle zeigt die ODBC C-Datentypen, in die binäre SQL-Daten konvertiert werden können. Eine Erklärung der Spalten und Begriffe in der Tabelle finden Sie unter Konvertieren von Daten aus SQL in C-Datentypen.
| C-Typbezeichner | Test | *TargetValuePtr | *StrLen_or_IndPtr | SQLSTATE |
|---|---|---|---|---|
| SQL_C_CHAR | (Bytelänge der Daten) * 2 <BufferLength (Bytelänge der Daten) * 2 >= BufferLength |
Daten Abgeschnittene Daten |
Länge der Daten in Bytes Länge der Daten in Bytes |
– 01004 |
| SQL_C_WCHAR | (Zeichenlänge der Daten) * 2 <BufferLength (Zeichenlänge der Daten) * 2 >= BufferLength |
Daten Abgeschnittene Daten |
Länge der Daten in Zeichen Länge der Daten in Zeichen |
– 01004 |
| SQL_C_BINARY | Bytelänge von Daten <= BufferLength Bytelänge der Daten >bufferLength |
Daten Abgeschnittene Daten |
Länge der Daten in Bytes Länge der Daten in Bytes |
– 01004 |
Wenn binäre SQL-Daten in Zeichen C-Daten konvertiert werden, wird jedes Byte (8 Bit) der Quelldaten als zwei ASCII-Zeichen dargestellt. Diese Zeichen sind die ASCII-Zeichendarstellung der Zahl in ihrer hexadezimalen Form. Beispielsweise wird eine binäre 00000001 in "01" und eine binäre 11111111 in "FF" konvertiert.
Der Treiber konvertiert immer einzelne Bytes in Paare von Hexadezimalstellen und beendet die Zeichenfolge mit einem NULL-Byte. Aus diesem Grund wird das letzte Byte des *TargetValuePtr-Puffers nicht verwendet, wenn BufferLength gerade ist und kleiner als die Länge der konvertierten Daten ist. (Die konvertierten Daten erfordern eine gerade Anzahl von Bytes, das vorletzte Byte ist ein NULL-Byte, und das letzte Byte kann nicht verwendet werden.)
Hinweis
Anwendungsentwickler werden davon abgeraten, binäre SQL-Daten an einen Zeichen-C-Datentyp zu binden. Diese Konvertierung ist in der Regel ineffizient und langsam.