sqlite_udf_decode_binary
(PHP 5 < 5.4.0, PECL sqlite >= 1.0.0)
sqlite_udf_decode_binary — UDFにパラメータとして渡されたバイナリデータをデコードする
説明
string sqlite_udf_decode_binary
( string
$data
)パラメータで渡されたバイナリデータを UDF にデコードします。
バイナリデータをUDFにより処理させる必要がある場合、UDFに渡されたパ ラメータに関してこの関数をコールする必要があります。 これは、PHPにより適用されたバイナリエンコーディングが内容と元のパラ メータを隠蔽するためです。
PHP は、自動的にエンコード/デコード処理を行いません。これは、これを 行うと著しい性能劣化を生じる可能性があるためです。
パラメータ
-
data -
デコード対象となる、エンコードされたデータ。これは sqlite_udf_encode_binary() あるいは sqlite_escape_string() で作成したものです。
返り値
デコードされた文字列を返します。
例
例1 バイナリ対応 max_length 集約関数の例
<?php
$data = array(
'one',
'two',
'three',
'four',
'five',
'six',
'seven',
'eight',
'nine',
'ten',
);
$db = sqlite_open(':memory:');
sqlite_query($db, "CREATE TABLE strings(a)");
foreach ($data as $str) {
$str = sqlite_escape_string($str);
sqlite_query($db, "INSERT INTO strings VALUES ('$str')");
}
function max_len_step(&$context, $string)
{
$string = sqlite_udf_decode_binary($string);
if (strlen($string) > $context) {
$context = strlen($string);
}
}
function max_len_finalize(&$context)
{
return $context;
}
sqlite_create_aggregate($db, 'max_len', 'max_len_step', 'max_len_finalize');
var_dump(sqlite_array_query($db, 'SELECT max_len(a) from strings'));
?>
参考
- sqlite_udf_encode_binary() - UDFから返す前にバイナリデータをエンコードする
- sqlite_create_function() - SQLステートメントで使用するために"通常の"ユーザー定義関数を登録する
- sqlite_create_aggregate() - SQLステートメントで使用する集約UDFを登録する
忘却曲線を使ってこの関数を確実に記憶に残す
