SQL à C : Caractère
Les identificateurs des types de données SQL ODBC de caractère sont les suivants :
- SQL_CHAR
- SQL_VARCHAR
- SQL_LONGVARCHAR
- SQL_WCHAR
- SQL_WVARCHAR
- SQL_WLONGVARCHAR
Le tableau suivant montre les types de données ODBC C vers lesquels les données SQL caractères 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 <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 |
| SQL_C_WCHAR | Longueur de caractères des données <BufferLength Longueur des caractères des données >= 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_STINYINT SQL_C_UTINYINT SQL_C_TINYINT SQL_C_SBIGINT SQL_C_UBIGINT SQL_C_SSHORT SQL_C_USHORT SQL_C_SHORT SQL_C_SLONG SQL_C_ULONG SQL_C_LONG SQL_C_NUMERIC | Données converties sans troncation[b] Données converties avec troncation de chiffres fractionnaires[a] La conversion de données entraînerait la perte de chiffres entiers (par opposition à des chiffres fractionnaires)[a] Les données ne sont pas un littéral numérique[b] |
Données Données tronquées Indéfini Indéfini |
Nombre d’octets du type de données C Nombre d’octets du type de données C Indéfini Indéfini |
n/a 01S07 22003 22018 |
| SQL_C_FLOAT SQL_C_DOUBLE | Les données se trouvent dans la plage du type de données vers lequel le nombre est converti[a] Les données se trouvent en dehors de la plage du type de données vers lequel le nombre est converti[a] Les données ne sont pas un littéral numérique[b] |
Données Indéfini Indéfini |
Taille du type de données C Indéfini Indéfini |
n/a 22003 22018 |
| SQL_C_BIT | Les données sont 0 ou 1 Les données sont supérieures à 0, inférieures à 2 et non égales à 1 Les données sont inférieures à 0 ou supérieures ou égales à 2 Les données ne sont pas un littéral numérique |
Données Données tronquées Indéfini Indéfini |
1[b] 1[b] Indéfini Indéfini |
n/a 01S07 22003 22018 |
| 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 |
n/a 01004 |
| SQL_C_TYPE_DATE | La valeur de données est une valeur de date valide[a] La valeur de données est une valeur d’horodatage valide ; la partie de temps est égale à zéro[a] La valeur de données est une valeur d’horodatage valide ; la partie time est différente de zéro[a],[c] La valeur de données n’est pas une valeur date-valeur ou timestamp-value valide[a] |
Données Données Données tronquées Indéfini |
6[b] 6[b] 6[b] Indéfini |
n/a n/a 01S07 22018 |
| SQL_C_TYPE_TIME | La valeur de données est une valeur de temps valide et la valeur de fraction de secondes est 0[a] La valeur de données est une valeur d’horodatage ou une valeur de temps valide ; fraction de secondes la portion est égale à zéro[a],[d] La valeur de données est une valeur d’horodatage valide ; fractions de secondes la partie est différente de zéro[a],[d],[e] La valeur de données n’est pas une valeur de temps ou une valeur d’horodatage valide[a] |
Données Données Données tronquées Indéfini |
6[b] 6[b] 6[b] Indéfini |
n/a n/a 01S07 22018 |
| SQL_C_TYPE_TIMESTAMP | La valeur de données est une valeur d’horodatage ou une valeur de temps valide ; fractions de secondes non tronquées[a] La valeur de données est une valeur d’horodatage ou une valeur de temps valide ; fractions de secondes tronquées[a] La valeur de données est une valeur de date valide[a] La valeur de données est une valeur de temps valide[a] La valeur de données n’est pas une valeur de date,d’heure ou de valeur d’horodatage valide[a] |
Données Données tronquées Données[f] Données[g] Indéfini |
16[b] 16[b] 16[b] 16[b] Indéfini |
n/a 01S07 n/a n/a 22018 |
| Tous les types d’intervalleS C | La valeur de données est une valeur d’intervalle valide ; aucune troncation La valeur de données est une valeur d’intervalle valide ; troncation d’un ou plusieurs champs de fin Les données sont un intervalle valide ; une précision significative du champ de pointe est perdue La valeur de données n’est pas une valeur d’intervalle valide |
Données Données tronquées Indéfini Indéfini |
Longueur des données en octets Longueur des données en octets Indéfini Indéfini |
n/a 01S07 22015 22018 |
[a] La valeur de BufferLength est ignorée pour cette conversion. Le pilote suppose que la taille de *TargetValuePtr est la taille du type de données C.
[b] Il s’agit de la taille du type de données C correspondant.
[c] La partie de temps de la valeur timestamp est tronquée.
[d] La partie date de la valeur timestamp est ignorée.
[e] La partie fractionnaire de secondes de l’horodatage est tronquée.
[f] Les champs d’heure de la structure timestamp sont définis sur zéro.
[g] Les champs de date de la structure timestamp sont définis sur la date actuelle.
Espaces supplémentaires
Les espaces de début et de fin sont ignorés lorsque les données de caractères SQL sont converties en l’un des types suivants :
- Date
- numeric
- time
- timestamp
- données interval C