Da SQL a C: dati binari
Gli identificatori per i tipi di dati ODBC SQL binari sono:
SQL_BINARY
SQL_VARBINARY
SQL_LONGVARBINARY
Nella tabella seguente vengono illustrati i tipi di dati ODBC C in cui è possibile convertire i dati SQL binari. Per una spiegazione delle colonne e dei termini nella tabella, vedere Conversione di dati da SQL a tipi di dati C.
| Identificatore del tipo C | Test | *TargetValuePtr | *StrLen_or_IndPtr | SQLSTATE |
|---|---|---|---|---|
| SQL_C_CHAR | (Lunghezza byte dei dati) * 2 <BufferLength (Lunghezza byte dei dati) * 2 >= BufferLength |
Dati Dati troncati |
Lunghezza dei dati in byte Lunghezza dei dati in byte |
N/D 01004 |
| SQL_C_WCHAR | (Lunghezza carattere dei dati) * 2 <BufferLength (Lunghezza carattere dei dati) * 2 >= BufferLength |
Dati Dati troncati |
Lunghezza dei dati in caratteri Lunghezza dei dati in caratteri |
N/D 01004 |
| SQL_C_BINARY | Lunghezza byte dei dati <= BufferLength Lunghezza byte dei dati >BufferLength |
Dati Dati troncati |
Lunghezza dei dati in byte Lunghezza dei dati in byte |
N/D 01004 |
Quando i dati SQL binari vengono convertiti in dati C di tipo carattere, ogni byte (8 bit) dei dati di origine viene rappresentato come due caratteri ASCII. Questi caratteri sono la rappresentazione di caratteri ASCII del numero nel formato esadecimale. Ad esempio, un 00000001 binario viene convertito in "01" e un 11111111 binario viene convertito in "FF".
Il driver converte sempre singoli byte in coppie di cifre esadecimali e termina la stringa di caratteri con un byte Null. Per questo motivo, se BufferLength è pari e è minore della lunghezza dei dati convertiti, l'ultimo byte del buffer *TargetValuePtr non viene usato. I dati convertiti richiedono un numero pari di byte, il byte successivo all'ultimo è un byte Null e l'ultimo byte non può essere usato.
Nota
Gli sviluppatori di applicazioni sono sconsigliati di associare dati SQL binari a un tipo di dati C carattere. Questa conversione è in genere inefficiente e lenta.