SQL para C: caractere
Os identificadores para os tipos de dados SQL ODBC de caractere são os seguintes:
- SQL_CHAR
- SQL_VARCHAR
- SQL_LONGVARCHAR
- SQL_WCHAR
- SQL_WVARCHAR
- SQL_WLONGVARCHAR
A tabela a seguir mostra os tipos de dados ODBC C para os quais os dados SQL de caracteres podem ser convertidos. Para obter uma explicação das colunas e termos na tabela, consulte Convertendo dados de tipos de dados SQL para C.
| Identificador de tipo C | Teste | TargetValuePtr | Strlen_or_indptr | SQLSTATE |
|---|---|---|---|---|
| SQL_C_CHAR | Comprimento de bytes de dados <BufferLength Comprimento de bytes de dados >= BufferLength |
Dados Dados truncados |
Comprimento dos dados em bytes Comprimento dos dados em bytes |
n/d 01004 |
| SQL_C_WCHAR | Comprimento do caractere de dados <BufferLength Comprimento do caractere de dados >= BufferLength |
Dados Dados truncados |
Comprimento dos dados em caracteres Comprimento dos dados em caracteres |
n/d 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 | Dados convertidos sem truncamento[b] Dados convertidos com truncamento de dígitos fracionários[a] A conversão de dados resultaria na perda de dígitos inteiros (em vez de fracionários) [a] Os dados não são um literal numérico[b] |
Dados Dados truncados Indefinido Indefinido |
Número de bytes do tipo de dados C Número de bytes do tipo de dados C Indefinido Indefinido |
n/d 01S07 22003 22018 |
| SQL_C_FLOAT SQL_C_DOUBLE | Os dados estão dentro do intervalo do tipo de dados no qual o número está sendo convertido[a] Os dados estão fora do intervalo do tipo de dados no qual o número está sendo convertido[a] Os dados não são um literal numérico[b] |
Dados Indefinido Indefinido |
Tamanho do tipo de dados C Indefinido Indefinido |
n/d 22003 22018 |
| SQL_C_BIT | Os dados são 0 ou 1 Os dados são maiores que 0, menores que 2 e não são iguais a 1 Os dados são menores que 0 ou maiores ou iguais a 2 Os dados não são um literal numérico |
Dados Dados truncados Indefinido Indefinido |
1[b] 1[b] Indefinido Indefinido |
n/d 01S07 22003 22018 |
| SQL_C_BINARY | Comprimento de bytes de dados <= BufferLength Comprimento de bytes de dados >BufferLength |
Dados Dados truncados |
Comprimento dos dados em bytes Comprimento dos dados |
n/d 01004 |
| SQL_C_TYPE_DATE | O valor de dados é um valor de data válido[a] O valor de dados é um valor de carimbo de data/hora válido; a parte de tempo é zero[a] O valor de dados é um valor de carimbo de data/hora válido; a parte de tempo é diferente de zero[a],[c] O valor de dados não é um valor de data/hora válido ou um valor de carimbo de data/hora[a] |
Dados Dados Dados truncados Indefinido |
6[b] 6[b] 6[b] Indefinido |
n/d n/d 01S07 22018 |
| SQL_C_TYPE_TIME | O valor de dados é um valor de tempo válido e o valor de segundos fracionários é 0[a] O valor de dados é um valor de carimbo de data/hora válido ou um valor de tempo válido; a parte de segundos fracionários é zero[a],[d] O valor de dados é um valor de carimbo de data/hora válido; a parte de segundos fracionários é diferente de zero[a],[d],[e] O valor de dados não é um valor de data/hora válido ou um valor de carimbo de data/hora[a] |
Dados Dados Dados truncados Indefinido |
6[b] 6[b] 6[b] Indefinido |
n/d n/d 01S07 22018 |
| SQL_C_TYPE_TIMESTAMP | O valor de dados é um valor de carimbo de data/hora válido ou um valor de tempo válido; fração de segundos porção não truncada[a] O valor de dados é um valor de carimbo de data/hora válido ou um valor de tempo válido; fração de segundos porção truncada[a] O valor de dados é um valor de data válido[a] O valor de dados é um valor de tempo válido[a] O valor de dados não é um valor de data e hora válido, um valor de data/hora ou um valor de carimbo de data/hora[a] |
Dados Dados truncados Dados[f] Dados[g] Indefinido |
16[b] 16[b] 16[b] 16[b] Indefinido |
n/d 01S07 n/d n/d 22018 |
| Todos os tipos de intervalo C | O valor de dados é um valor de intervalo válido; sem truncamento O valor de dados é um valor de intervalo válido; truncamento de um ou mais campos à direita Os dados são um intervalo válido; precisão significativa do campo à esquerda é perdida O valor de dados não é um valor de intervalo válido |
Dados Dados truncados Indefinido Indefinido |
Comprimento dos dados em bytes Comprimento dos dados em bytes Indefinido Indefinido |
n/d 01S07 22015 22018 |
[a] O valor de BufferLength é ignorado para essa conversão. O driver pressupõe que o tamanho de *TargetValuePtr seja do tamanho do tipo de dados C.
[b] Esse é o tamanho do tipo de dados C correspondente.
[c] A parte de tempo do valor do carimbo de data/ hora é truncada.
[d] A parte de data do carimbo de data/hora-valor é ignorada.
[e] A parte de segundos fracionários do carimbo de data/hora é truncada.
[f] Os campos de tempo da estrutura de carimbo de data/hora são definidos como zero.
[g] Os campos de data da estrutura de carimbo de data/hora são definidos como a data atual.
Espaços extras
Os espaços à esquerda e à direita são ignorados quando os dados de caracteres SQL são convertidos em qualquer um dos seguintes tipos:
- date
- numeric
- time
- timestamp
- dados do intervalo C