sqlite_create_aggregate

Описание

bool sqlite_create_aggregate ( resource dbhandle, string function_name, mixed step_func, mixed finalize_func [, int num_args] )

sqlite_create_aggregate() похожа на sqlite_create_function(), за исключением того, что регистрирует функцию, которая может быть использована для вычисления результата на основе всех записей результата запроса.

Главное отличие этой функции от sqlite_create_function() состоит в том, что для работы агрегатной функции неоходимы 2 функции; step_func вызывается для каждой записи из результат запроса. Эта функция должна аккумулировать результат и сохранять его в контекстной переменной. После обработки всех записей, вызывается finalize_func, которая должна обработать данные из контекстной переменной и вернуть результат.

Пример 1. Пример агрегатной функции max_length <?php $data = array(     'one' ,     'two' ,     'three' ,     'four' ,     'five' ,     'six' ,     'seven' ,     'eight' ,     'nine' ,     'ten' ,    ); $dbhandle = sqlite_open ( ':memory:' ); sqlite_query ( $dbhandle , "CREATE TABLE strings(a)" ); foreach ( $data as $str ) {      $str = sqlite_escape_string ( $str );      sqlite_query ( $dbhandle , "INSERT INTO strings VALUES ('$str')" ); } function max_len_step (& $context , $string ) {     if ( strlen ( $string ) > $context ) {          $context = strlen ( $string );     } } function max_len_finalize (& $context ) {     return $context ; } sqlite_create_aggregate ( $dbhandle , 'max_len' , 'max_len_step' , 'max_len_finalize' ); var_dump ( sqlite_array_query ( $dbhandle , 'SELECT max_len(a) from strings' )); ?>

В этом примере, мы создаем агрегатную функцию, коорая возвращает длину самой длинной строки в одном из полей результата запроса. Для каждой записи, вызывается функция max_len_step, которой помимо строки передается контекстная переменная context. Эту переменню вы можете использовать по своему усмотрению для накопления результатов вычислений. В нашем примере, в этой переменной хранится максимальная длина строки; если длина строки string больше, чем значение, сохраненное в контекстной переменной, контекстной переменной присваивается новое значение.

После обработки всех записей, SQLite вызовет функцию max_len_finalize для определения результата агрегатной функции. Здесь можно было бы провести вычисления, основанные на значении контекстной переменной context, но в этом простейшем примере, все вычисления были произведены в процессе обработки запроса, и остается только вернуть полученное значение.

Смотрите также

sqlite_create_function(), sqlite_udf_encode_binary() и sqlite_udf_decode_binary().