(PHP 4, PHP 5, PHP 7, PHP 8)
odbc_binmode — Manipulação de dados de colunas binárias
Controla a manipulação de dados de colunas binárias. Os tipos SQL ODBC afetados são
BINARY, VARBINARY e
LONGVARBINARY.
O modo padrão pode ser definido usando a diretiva
uodbc.defaultbinmode do php.ini.
Quando dados SQL binários são convertidos em dados de caracteres C (ODBC_BINMODE_CONVERT), cada byte
(8 bits) dos dados de origem é representado como dois caracteres ASCII.
Esses caracteres são a representação de caracteres ASCII do
número em sua forma hexadecimal. Por exemplo, um binário
00000001 é convertido em
"01" e um binário 11111111
é convertido em "FF" .
Embora o tratamento das colunas BINARY e VARBINARY
dependa apenas do "binmode", o tratamento das colunas LONGVARBINARY
também depende do "longreadlen":
| binmode | longreadlen | resultado |
|---|---|---|
ODBC_BINMODE_PASSTHRU |
0 | intermediário |
ODBC_BINMODE_RETURN |
0 | intermediário |
ODBC_BINMODE_CONVERT |
0 | intermediário |
ODBC_BINMODE_PASSTHRU |
>0 | intermediário |
ODBC_BINMODE_RETURN |
>0 | retorna como está |
ODBC_BINMODE_CONVERT |
>0 | retorna como char |
Se odbc_fetch_into() for usada, "intermediário" significa que uma string vazia será retornada para essas colunas. Se odbc_result() for usada, "intermediário" significa que os dados são enviados diretamente ao cliente (ou seja, exibidos).
statementO objeto de resultado ODBC.
mode
Valores possíveis para mode são:
ODBC_BINMODE_PASSTHRU: Intermediário para dados BINARY
ODBC_BINMODE_RETURN: Retorna como está
ODBC_BINMODE_CONVERT: Converte para "char" e retorna
Nota: A manipulação de colunas de binários longos também é afetada por odbc_longreadlen().
Sempre retorna true.
| Versão | Descrição |
|---|---|
| 8.4.0 |
statement agora espera uma instância de Odbc\Result;
anteriormente, esperava um resource.
|