Modifica la gestión de columnas de datos binarios

# odbc_binmode

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

odbc_binmode — Modifica la gestión de columnas de datos binarios

### Descripción

function 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`

  El objeto de resultado ODBC.

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

### Valores devueltos

Retorna siempre `true`.

### Historial de cambios

Versión | Descripción
--- | ---
8.4.0 | `statement` ahora espera una instancia de Odbc\Result; anteriormente, se esperaba un resource.

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open