xxx()

主函数。这是计算函数结果的地方。SQL 函数数据类型与您的 C++ 函数的返回类型之间的对应关系如下所示。

也可以声明 DECIMAL 函数，但其值以字符串形式返回，因此您应该像编写 STRING 函数一样编写该函数。 ROW 函数未实现。

xxx_init()

xxx() 的初始化函数。如果存在，它可以用于以下目的

xxx_deinit()

xxx() 的去初始化函数。如果存在，它应该释放初始化函数分配的任何内存。

xxx_clear()

重置当前的聚合值，但不将参数插入为新组的初始聚合值。

xxx_add()

将参数添加到当前的聚合值。

bool maybe_null

如果 xxx() 可以返回 NULL，则 xxx_init() 应该将 maybe_null 设置为 1。如果任何参数声明为 maybe_null，则默认值为 1。

unsigned int decimals

小数点右侧的小数位数。默认值为传递给主函数的参数中最大的小数位数。例如，如果函数传递了 1.34、1.345 和 1.3，则默认值为 3，因为 1.345 有 3 位小数。

对于没有固定小数位数的参数，decimals 值被设置为 31，比DECIMAL、FLOAT 和 DOUBLE 数据类型允许的最大小数位数多 1。此值在 mysql_com.h 头文件中作为常量 NOT_FIXED_DEC 可用。

在以下情况下，参数使用 31 的 decimals 值：例如，没有显式声明小数位数的 FLOAT 或 DOUBLE 列（例如，FLOAT 而不是 FLOAT(10,3)），以及浮点常量，例如 1345E-3。它还用于字符串和其他可能在函数中转换为数字形式的非数字参数。

decimals 成员初始化的值只是一个默认值。它可以在函数内部更改，以反映实际执行的计算。默认值由参数中最大小数位数确定。如果即使只有一个参数的小数位数为 NOT_FIXED_DEC，则该值将用于 decimals。

无符号整数 max_length

结果的最大长度。默认的 max_length 值取决于函数的结果类型。对于字符串函数，默认值为最长参数的长度。对于整数函数，默认值为 21 位。对于实数函数，默认值为 13 加上由 initid->decimals 指示的小数位数。（对于数字函数，长度包括任何符号或小数点字符。）

如果要返回 blob 值，可以将 max_length 设置为 65KB 或 16MB。不会分配此内存，但该值用于确定在需要临时存储数据时使用哪种数据类型。

字符 *ptr

函数可以将其用于自身目的的指针。例如，函数可以使用 initid->ptr 在彼此之间传递分配的内存。 xxx_init() 应该分配内存并将它分配给此指针

initid->ptr = allocated_memory;

在 xxx() 和 xxx_deinit() 中，引用 initid->ptr 来使用或释放内存。

布尔 const_item

xxx_init() 应该将 const_item 设置为 1（如果 xxx() 始终返回相同的值）或 0（否则）。

xxx_reset()

当 MySQL 找到新组中的第一行时，将调用此函数。它应该重置任何内部摘要变量，然后使用给定的 UDF_ARGS 参数作为组内部摘要值中的第一个值。以下声明 xxx_reset()：

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

xxx_reset() 在 MySQL 9.0 中不需要或不使用，在 MySQL 9.0 中，可加载函数接口使用 xxx_clear() 而不是它。但是，如果要使函数与旧版本的服务器一起使用，则可以同时定义 xxx_reset() 和 xxx_clear()。（如果您确实包含这两个函数，则在许多情况下，xxx_reset() 函数可以在内部通过调用 xxx_clear() 来重置所有变量，然后调用 xxx_add() 来将 UDF_ARGS 参数添加为组中的第一个值。）

xxx_clear()

当 MySQL 需要重置摘要结果时，将调用此函数。它在每个新组的开头被调用，但也可以被调用来重置没有匹配行的查询的值。以下声明 xxx_clear()：

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

在调用 xxx_clear() 之前，将 is_null 设置为指向 CHAR(0)。

如果出现错误，可以在 error 参数指向的变量中存储一个值。 error 指向单个字节变量，而不是字符串缓冲区。

xxx_clear() 是 MySQL 9.0 所必需的。

xxx_add()

此函数针对属于同一组的所有行调用。您应该使用它将 UDF_ARGS 参数中的值添加到您的内部摘要变量。

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

无符号整数 arg_count

参数的数量。如果需要函数以特定数量的参数调用，则在初始化函数中检查此值。例如

if (args->arg_count != 2)
{
    strcpy(message,"XXX() requires two arguments");
    return 1;
}

对于其他 UDF_ARGS 成员值（即数组），数组引用以 0 为基准。也就是说，使用从 0 到 args->arg_count − 1 的索引值引用数组成员。

枚举 Item_result *arg_type

指向包含每个参数类型的数组的指针。可能的类型值为 STRING_RESULT、INT_RESULT、REAL_RESULT 和 DECIMAL_RESULT。

要确保参数是给定类型，并在它们不是给定类型时返回错误，请在初始化函数中检查 arg_type 数组。例如

if (args->arg_type[0] != STRING_RESULT ||
    args->arg_type[1] != INT_RESULT)
{
    strcpy(message,"XXX() requires a string and an integer");
    return 1;
}

类型为 DECIMAL_RESULT 的参数作为字符串传递，因此您以与 STRING_RESULT 值相同的方式处理它们。

作为要求函数参数为特定类型的替代方法，可以使用初始化函数将 arg_type 元素设置为所需的类型。这会导致 MySQL 在每次调用 xxx() 时将参数强制转换为这些类型。例如，要指定前两个参数应分别强制转换为字符串和整数，请在 xxx_init() 中执行以下操作

args->arg_type[0] = STRING_RESULT;
args->arg_type[1] = INT_RESULT;

精确值小数参数（例如 1.3 或 DECIMAL 列值）以 DECIMAL_RESULT 类型传递。但是，值作为字符串传递。要接收数字，请使用初始化函数指定应将参数强制转换为 REAL_RESULT 值

args->arg_type[2] = REAL_RESULT;

字符 **args

args->args 向初始化函数传递有关传递给函数的参数的总体性质的信息。对于常量参数 i，args->args[i] 指向参数值。（有关如何正确访问值的说明，请参见后面。）对于非常量参数，args->args[i] 为 0。常量参数是仅使用常量的表达式，例如 3 或 4*7-2 或 SIN(3.14)。非常量参数是指可能在行之间发生变化的值的表达式，例如列名或使用非常量参数调用的函数。

对于主函数的每次调用，args->args 包含当前正在处理的行传递的实际参数。

如果参数 i 表示 NULL，则 args->args[i] 为空指针 (0)。如果参数不是 NULL，则函数可以按如下方式引用它

无符号长整型 *lengths

对于初始化函数，lengths 数组指示每个参数的最大字符串长度。您不应该更改这些。对于主函数的每次调用，lengths 包含当前正在处理的行传递的任何字符串参数的实际长度。对于类型为 INT_RESULT 或 REAL_RESULT 的参数，lengths 仍然包含参数的最大长度（如初始化函数）。

字符 *maybe_null

对于初始化函数，maybe_null 数组指示每个参数的值是否可能为 null（0 表示否，1 表示是）。

字符 **attributes

args->attributes 传递有关函数参数名称的信息。对于参数 i，属性名称可作为字符串在 args->attributes[i] 中获得，属性长度为 args->attribute_lengths[i]。不要假设字符串以 null 结尾。

默认情况下，函数参数的名称是用于指定参数的表达式的文本。对于可加载函数，参数也可以有一个可选的 [AS] 别名 子句，在这种情况下，参数名称为 别名。因此，每个参数的 attributes 值取决于是否给出了别名。

假设可加载函数 my_udf() 如下调用

SELECT my_udf(expr1, expr2 AS alias1, expr3 alias2);

在这种情况下，attributes 和 attribute_lengths 数组将具有以下值

args->attributes[0] = "expr1"
args->attribute_lengths[0] = 5

args->attributes[1] = "alias1"
args->attribute_lengths[1] = 6

args->attributes[2] = "alias2"
args->attribute_lengths[2] = 6

unsigned long *attribute_lengths

attribute_lengths 数组指示每个参数名称的长度。

对于它们传递给可加载函数的参数，应用程序将继续工作，因为该函数现在能够处理任何字符集中的字符串参数，包括二进制字符串。

如果可加载函数要以与其参数的字符集不同的字符集返回字符串结果，则该函数必须在内部执行字符集转换。例如，如果函数接受 latin1 参数但返回 utf8mb4 结果，则情况就是这样。

metaphon() 返回字符串参数的元音字符串。这有点像 Soundex 字符串，但它更适合英语。

myfunc_double() 返回其参数中字符的 ASCII 值之和，除以其参数的长度之和。

myfunc_int() 返回其参数的长度之和。

sequence([const int]) 返回从给定数字开始的序列，如果没有给出数字，则从 1 开始。

lookup() 返回主机名的 IP 地址。

reverse_lookup() 返回 IP 地址的主机名。该函数可以调用一次，使用形式为 'xxx.xxx.xxx.xxx' 的单个字符串参数，也可以调用四次，使用四个数字。

avgcost() 返回平均成本。这是一个聚合函数。