文章內(nèi)容

27.2.3.1. UDF 對簡單函數(shù)的調(diào)用順序

發(fā)布時間: 2012/8/17 17:59:48

下面介紹創(chuàng)建簡單UDF時需要定義的不同函數(shù)。27.2.3節(jié)，“添加新的自定義函數(shù)”中介紹了MySQL調(diào)用這些函數(shù)的順序。

如本節(jié)所示，應(yīng)該說明主函數(shù)xxx()。注意返回值和參數(shù)會有所不同，這取決于你說明的SQL函數(shù)xxx()在CREATE FUNCTION聲明中返回的是STRING，INTEGER類型還是REAL類型示：

對于STRING 型函數(shù)：

char *xxx(UDF_INIT *initid, UDF_ARGS *args,
          char *result, unsigned long *length,
          char *is_null, char *error);

對于INTEGER型函數(shù)：

long long xxx(UDF_INIT *initid, UDF_ARGS *args,
              char *is_null, char *error);

對于REAL型函數(shù)：

double xxx(UDF_INIT *initid, UDF_ARGS *args,
              char *is_null, char *error);

初始化和去初始化函數(shù)如下說明：電腦技巧www.boydavid.com

my_bool xxx_init(UDF_INIT *initid, UDF_ARGS *args, char *message);

void xxx_deinit(UDF_INIT *initid);

initid 參數(shù)被傳遞給所有的三個函數(shù)。它指向一個UDF_INIT 結(jié)構(gòu)，這個結(jié)構(gòu)被用來在函數(shù)之間交換信息。UDF_INIT 結(jié)構(gòu)項跟隨著。初始化函數(shù)應(yīng)該給任何它想要改變的項賦值。（要使用項的默認(rèn)值，就讓它不被改變）

my_bool maybe_null

如果xxx() 能返回NULL，xxx_init()應(yīng)maybe_null 為 1 。如果任一參量被說明了 maybe_null值，其默認(rèn)值是1 。
unsigned int decimals

小數(shù)位數(shù)。默認(rèn)值是傳到主函數(shù)的參量里小數(shù)的最大位數(shù)。（例如，如果函數(shù)傳遞 1.34, 1.345, 和1.3, 那么默認(rèn)值為，因為1.345 有3位小數(shù)。
unsigned int max_length

結(jié)果的最大長度。max_length 的默認(rèn)值因函數(shù)的結(jié)果類型而異。對字符串函數(shù)，默認(rèn)值是最長參量的長度。對整型函數(shù)，默認(rèn)是21位。對實型函數(shù)，默認(rèn)是13再加上initid->decimals指示的小數(shù)位數(shù)。（對數(shù)字函數(shù)，長度包含正負(fù)號或者小數(shù)點符）。

如果想返回團值，你可以把max_length 設(shè)為從65KB到16MB。這個內(nèi)存不會被分配，但是如果有臨時數(shù)據(jù)需要存儲，這個設(shè)置了的值被用來決定使用哪種列的類型。
char *ptr

函數(shù)可以用作本身目的的指針。比如，函數(shù)可以用initid->ptr 來在分配了的內(nèi)存內(nèi)部通訊。 xxx_init() 應(yīng)該分配內(nèi)存，并指派給這個指針：
```
initid->ptr = allocated_memory;
 電腦技術(shù)www.boydavid.com 
```
在 xxx() 和 xxx_deinit()中，借用 initid->ptr 來使用或分配內(nèi)存。