array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.odbc-binmode.php', 1 => 'odbc_binmode', 2 => 'Manipulação de dados de colunas binárias', ), 'up' => array ( 0 => 'ref.uodbc.php', 1 => 'Funções de ODBC', ), 'prev' => array ( 0 => 'function.odbc-autocommit.php', 1 => 'odbc_autocommit', ), 'next' => array ( 0 => 'function.odbc-close.php', 1 => 'odbc_close', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/uodbc/functions/odbc-binmode.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

odbc_binmode

(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_binmode — Manipulação de dados de colunas binárias

Descrição

odbc_binmode(Odbc\Result $statement, int $mode): true

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":
Manipulação de LONGVARBINARY
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).

Parâmetros

statement

O objeto de resultado ODBC.

mode

Valores possíveis para mode são:

Nota: A manipulação de colunas de binários longos também é afetada por odbc_longreadlen().

Valor Retornado

Sempre retorna true.

Registro de Alterações

Versão Descrição
8.4.0 statement agora espera uma instância de Odbc\Result; anteriormente, esperava um resource.