odbc_binmode

(PHP 3 >= 3.0.6, PHP 4, PHP 5)

odbc_binmode -- バイナリカラムデータを処理する

説明

bool odbc_binmode ( resource result_id, int mode )

(関係するODBC SQL型: BINARY, VARBINARY, LONGVARBINARY)

バイナリ SQL データが文字データに変換される時、ソースデータの 各バイト (8 ビット) は、2 つのアスキー文字で表現されます。 これらの文字は、16 進表現で数値をアスキー文字で表現したものです。 例えば、2 進数 000000001 は "01" に変換され、 11111111 は "FF" に変換されます。

表 1. LONGVARBINARY 処理

binmodelongreadlen結果
ODBC_BINMODE_PASSTHRU0通過
ODBC_BINMODE_RETURN0通過
ODBC_BINMODE_CONVERT0通過
ODBC_BINMODE_PASSTHRU0通過
ODBC_BINMODE_PASSTHRU>0通過
ODBC_BINMODE_RETURN>0そのまま返す
ODBC_BINMODE_CONVERT>0char として返す

odbc_fetch_into() を使用した場合、 「通過」は空文字列が対応するカラムに返されることを意味します。

result_id0 を指定した場合、 ここで設定した値は、新規の結果に関するデフォルト値として用いられます。

注意: longreadlen のデフォルト値は 4096 で、binmode のデフォルト値は ODBC_BINMODE_RETURN です。 バイナリロングカラムの処理は、odbc_longreadlen() の影響も受けます。