22.3.2.2. Вызывающие последовательности UDF для Агрегатных функций

xxx_reset()

Эта функция вызывается, когда MySQL находит первую строку в новой группе. Это должно сбросить любые внутренние сводные переменные и затем использовать данный UDF_ARGS параметр как первое значение в Вашей внутренней сводке оценивает за группу. Объявить xxx_reset() следующим образом:

void xxx_reset(UDF_INIT *initid, UDF_ARGS *args,               char *is_null, char *error);

xxx_reset() не необходим или используется в MySQL 5.7, в котором UDF соединяют интерфейсом с использованием xxx_clear() вместо этого. Однако, можно определить обоих xxx_reset() и xxx_clear() если Вы хотите иметь свою работу UDF с более старыми версиями сервера. (Если Вы действительно включаете обе функции, xxx_reset() функция во многих случаях может быть реализована внутренне, вызывая xxx_clear() сбрасывать все переменные, и затем вызов xxx_add() добавить UDF_ARGS параметр как первое значение в группе.)

xxx_clear()

Эта функция вызывается, когда MySQL должен сбросить сводные результаты. Это вызывают вначале для каждой новой группы, но может также быть вызвано, чтобы сбросить значения для запроса, где не было никаких строк соответствия. Объявить xxx_clear() следующим образом:

void xxx_clear(UDF_INIT *initid, char *is_null, char *error);

is_null устанавливается указать на CHAR(0) перед вызовом xxx_clear().

Если что-то пошло не так, как надо, можно сохранить значение в переменной к который error точки параметра. error точки к однобайтовой переменной, не к строковому буферу.

xxx_clear() требуется MySQL 5.7.

xxx_add()

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

void xxx_add(UDF_INIT *initid, UDF_ARGS *args,char *is_null, char *error);