(PHP 4, PHP 5, PHP 7, PHP 8)
odbc_binmode — Modifica la gestión de columnas de datos binarios
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:
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).
statement
The ODBC result object.
mode
Valores posibles para el parámetro mode
:
ODBC_BINMODE_PASSTHRU
: devolver los datos en binario
ODBC_BINMODE_RETURN
: devolver sin conversión
ODBC_BINMODE_CONVERT
: convertir en carácter
Nota: La gestión de columnas de tipo binary long también se ve afectada por la función odbc_longreadlen().
Siempre devuelve true
.
Versión | Descripción |
---|---|
8.4.0 |
statement expects an Odbc\Result
instance now; previously, a resource was expected.
|