[UDF系列]如何编写InterBase UDF 之二
(接上一篇)
如何编写InterBase UDF
warton译
怎么编写字符串和日期型处理函数的UDF呢？
下面编写一个“Left“函数
内存分配问题：
如果你使用IB(InterBase)5.1以下版本的话，在你的单元文件中键入下面的声明：
function malloc(Bytes: Integer): Pointer; cdecl; external 'msvcrt.dll';
如果你有5.5以上的版本，你就不需要这么做了。这样，先确定ib_util.pas 文件在你的编译器可以找到的路径中，并且ib_util.dll也在你的搜索路径之中。
最简单的方法是放到的库可搜索到的路径。
c:\Program Files\InterBase Corp\InterBase\include
然后复制
c:\Program Files\InterBase Corp\InterBase\lib\ib_util.dll
到你的windows系统目录下(典型的是：c:\Windows\System)。最后在你的单元文件的use子句中将ib_util.pas加进去
uses
...,
ib_util;
为什么有如此奇特的内存分配？为什么我不能用AllocMem分配内存，或者其它方法？问题很简单：你不能，所以不要问!更复杂的问题是每一个编译器使用它喜欢的算法来进行内存管理，这是被操作系统控制着的。例如，VC和Delphi管理内存的方式不同，猜这是为什么？IB是在VC下编译的，在5.5以前的版本中，你必须直接指定运行库。在IB5.5之后，IB给了一个IB调用使得这成为可能。既然这样，那我们继续进行编写字符串操作的函数。
构建函数
在新的单元文件中，作如下声明：
function Left(sz: PChar; Cnt: Integer): PChar; cdecl; export;
在函数实现部分：
(* Return the Cnt leftmost characters of sz *)
function Left(sz: PChar; var Cnt: Integer): PChar;
var
i: Integer;
begin
if (sz = nil) then
result := nil
else begin
i := 0;
while ((sz[i] <> #0) and (i < cnt)) do Inc(i);
result := ib_util_malloc(i+1);
Move(sz[0], result[0], i);
result[i] := #0;
end;
end;
在你的工程文件中，在“exports“部分键入：
exports
Modulo,
Left;
Now,再次编译工程项目….
现在，为了使用函数，在ISQL中重新连接数据库，输入：
declare external function f_Left
cstring(64), integer
returns cstring(64) free_it
entry_point 'Left' module_name 'dll name minus ".dll"';
测试这个函...
select f_Left('Hello', 3) from rdb$database
仍然相当简单，哈？
上我们来编写一个时间函数
在IB6中，有三种不同的时期类型被支持，DATE,TIME,和TIMESTAMP，与IB5.5及以前老版本中的相比，TIMESTAMP 的数据类型实质上相当于IB5.5的DATE类型。
为了在你的程序中”decode”和”encode”这些类型。你应该了解一点IB API相关的信息。输入以下代码：
interface
...
type
TM = record
tm_sec : integer; // Seconds
tm_min : integer; // Minutes
tm_hour : integer; // Hour (0--23)
tm_mday : integer; // Day of month (1--31)
tm_mon : integer; // Month (0--11)
tm_year : integer; // Year (calendar year minus 1900)
tm_wday : integer; // Weekday (0--6) Sunday = 0)
tm_yday : integer; // Day of year (0--365)
tm_isdst : integer; // 0 if daylight savings time is not in effect)
end;
PTM = ^TM;
ISC_TIMESTAMP = record
timestamp_date : Long;
timestamp_time : ULong;
end;
PISC_TIMESTAMP = ^ISC_TIMESTAMP;
implementation
...
procedure isc_encode_timestamp (tm_date: PTM;
ib_date: PISC_TIMESTAMP);
stdcall; external IBASE_DLL;
procedure isc_decode_timestamp (ib_date: PISC_TIMESTAMP;
tm_date: PTM);
stdcall; external IBASE_DLL;
procedure isc_decode_sql_date (var ib_date: Long;
tm_date: PTM);
stdcall; external IBASE_DLL;
procedure isc_encode_sql_date (tm_date: PTM;
var ib_date: Long);
stdcall; external IBASE_DLL;
procedure isc_decode_sql_time (var ib_date: ULong;
tm_date: PTM);
stdcall; external IBASE_DLL;
procedure isc_encode_sql_time (tm_date: PTM;
var ib_date: ULong);
stdcall; external IBASE_DLL;
现在我们写日期UDF:
在单元文件的interface部分，输入声明：
function Year(var ib_date: Long): Integer; cdecl; export;
function Hour(var ib_time: ULong): Integer; cdecl; export;
在implementation(实现)部分，输入：
function Year(var ib_date: Long): Integer;
var
tm_date: TM;
begin
isc_decode_sql_date(@ib_date, @tm_date);
result := tm_date.tm_year + 1900;
end;
function Hour(var ib_time: ULong): Integer;
var
tm_date: TM;
begin
isc_decode_sql_time(@ib_time, @tm_date);
result := tm_date.tm_hour;
end;
最好，在你的工程文件中：在““部分，输入：
exports
Modulo,
Left,
Year,
Hour;
现在编译工程...
为了使用这个函数，就像上面那样：用ISQL连接数据库，输入：
declare external function f_Year
date
returns integer by value
entry_point 'Year' module_name 'dll name minus ".dll"';
declare external function f_Hour
time
returns integer by value
entry_point 'Hour' module_name 'dll name minus ".dll"';
最后再测试一下看!
select f_Year(cast('7/11/00' as date)) from rdb$database
这一部分并非像前面字符串和整数那样操作哪样了，但是还是相当...simple,哼!
编写Linux/Unix平台的UDF
(未完待续!!)
