(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).
statementThe 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.
|