odbc_binmode

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

odbc_binmodeModifica la gestión de columnas de datos binarios

Descripción

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

odbc_binmode() controla la gestión de las columnas de datos binarios. Los tipos ODBC SQL afectados son BINARY, VARBINARY y LONGVARBINARY. El modo predeterminado puede definirse utilizando la directiva php.ini uodbc.defaultbinmode

Cuando un dato SQL se convierte en carácter C, (ODBC_BINMODE_CONVERT) los 8 bits del carácter fuente se representan por dos caracteres ASCII. Estos caracteres son representaciones ASCII de los números en formato hexadecimal. Por ejemplo, el binario 00000001 se convierte en "01" y el binario 11111111 se convierte en "FF".

Mientras que la gestión de las columnas BINARY y VARBINARY depende únicamente del binmode, la gestión de las columnas LONGVARBINARY depende también de longreadlen, como se muestra a continuación:

Conversión de LONGVARBINARY
Modo Longitud Resultado
ODBC_BINMODE_PASSTHRU 0 passthru
ODBC_BINMODE_RETURN 0 passthru
ODBC_BINMODE_CONVERT 0 passthru
ODBC_BINMODE_PASSTHRU >0 passthru
ODBC_BINMODE_RETURN >0 Tal cual
ODBC_BINMODE_CONVERT >0 Carácter

Si se utiliza odbc_fetch_into(), passthru significa que se devolverá una cadena vacía para estas columnas. Si se utiliza la función odbc_result(), passthru significa que los datos se envían directamente al cliente (es decir, se imprimen).

Parámetros

statement

The ODBC result object.

mode

Valores posibles para el parámetro mode:

Nota: La gestión de columnas de tipo binary long también se ve afectada por la función odbc_longreadlen().

Valores devueltos

Siempre devuelve true.

Historial de cambios

Versión Descripción
8.4.0 statement expects an Odbc\Result instance now; previously, a resource was expected.