odbc_binmode

(PHP 4, PHP 5, PHP 7)

odbc_binmodeBehandlung von Binärdaten

Beschreibung

odbc_binmode ( resource $result_id , int $mode ) : bool

Steuert die Behandlung binärer Spaltendaten. Betroffene ODBC SQL Typen sind BINARY, VARBINARY und LONGVARBINARY.

Werden SQL-Binärdaten in C-Zeichendaten konvertiert, wird jedes Byte (8 Bits) der ursprünglichen Daten zu zwei ASCII-Zeichen, die der hexadezimalen Darstellung des Wertes entsprechen. Der Binärwert 00000001 wird zum Beispiel zu "01" gewandelt, der Binärwert 11111111 zu "FF".

Die Benutzung von LONGVARBINARY
binmode longreadlen Resultat
ODBC_BINMODE_PASSTHRU 0 Direkte Ausgabe
ODBC_BINMODE_RETURN 0 Direkte Ausgabe
ODBC_BINMODE_CONVERT 0 Direkte Ausgabe
ODBC_BINMODE_PASSTHRU 0 Direkte Ausgabe
ODBC_BINMODE_PASSTHRU >0 Direkte Ausgabe
ODBC_BINMODE_RETURN >0 Direkte Ausgabe
ODBC_BINMODE_CONVERT >0 Rückgabe als CHAR-Werte

Wenn odbc_fetch_into() genutzt wird, wird bei direkter Ausgabe ein leerer String als Spaltenwert zurückgeliefert.

Parameter-Liste

result_id

Die Ergebniskennung.

Wenn result_id gleich 0 ist, wird die Einstellung als Standardwert für die neue Ergebnisse verwendet.

Hinweis: Der Standardwert für longreadlen ist 4096, und für mode ODBC_BINMODE_RETURN. Die Behandlung von binary long Spalten wird ebenfalls durch odbc_longreadlen() beeinflusst.

mode

Mögliche Werte für mode sind:

  • ODBC_BINMODE_PASSTHRU: schleift BINÄRE Daten durch
  • ODBC_BINMODE_RETURN: liefert die Binärdaten unverändert zurück
  • ODBC_BINMODE_CONVERT: konvertiert die Binärdaten zu Zeichen und liefert sie zurück

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.