[UDF系列]如何编写InterBase UDF 之二

类别:数据库 点击:0 评论:0 推荐:

(接上一篇)

如何编写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

(未完待续!!)

本文地址:http://com.8s8s.com/it/it21330.htm