SQL à C : Binary
Les identificateurs des types de données SQL ODBC binaires sont les suivants :
SQL_BINARY
SQL_VARBINARY
SQL_LONGVARBINARY
Le tableau suivant montre les types de données ODBC C vers lesquels les données SQL binaires peuvent être converties. Pour obtenir une explication des colonnes et des termes de la table, consultez Conversion de données de SQL en types de données C.
| Identificateur de type C | Test | *TargetValuePtr | *StrLen_or_IndPtr | SQLSTATE |
|---|---|---|---|---|
| SQL_C_CHAR | (Longueur en octets des données) * 2 <BufferLength (Longueur en octets des données) * 2 >= BufferLength |
Données Données tronquées |
Longueur des données en octets Longueur des données en octets |
n/a 01004 |
| SQL_C_WCHAR | (Longueur des caractères des données) * 2 <BufferLength (Longueur des caractères des données) * 2 >= BufferLength |
Données Données tronquées |
Longueur des données en caractères Longueur des données en caractères |
n/a 01004 |
| SQL_C_BINARY | Longueur en octets des données <= BufferLength Longueur en octets des données >BufferLength |
Données Données tronquées |
Longueur des données en octets Longueur des données en octets |
n/a 01004 |
Lorsque des données SQL binaires sont converties en données de caractère C, chaque octet (8 bits) des données sources est représenté sous la forme de deux caractères ASCII. Ces caractères sont la représentation en caractères ASCII du nombre dans sa forme hexadécimale. Par exemple, un 00000001 binaire est converti en « 01 » et un 11111111 binaire est converti en « FF ».
Le pilote convertit toujours des octets individuels en paires de chiffres hexadécimaux et termine la chaîne de caractères avec un octet null. Pour cette raison, si BufferLength est pair et est inférieur à la longueur des données converties, le dernier octet de la mémoire tampon *TargetValuePtr n’est pas utilisé. (Les données converties nécessitent un nombre pair d’octets, l’avant-dernier octet est un octet Null et le dernier octet ne peut pas être utilisé.)
Notes
Les développeurs d’applications sont découragés de lier des données SQL binaires à un type de données C caractère. Cette conversion est généralement inefficace et lente.