GBASE 8s UDR内存管理_01_mi_alloc

函数mi_alloc()的作用是：分配指定大小的用户内存块，并返回指向该块的指针。

1.语法

void *mi_alloc(size)

mi_integer size;

size要分配的字节数。

在客户端LIBMI应用程序中有效？	在用户定义的例程中有效？
是	是

2.用法

        函数mi_alloc()的作用是：为DataBlade API模块分配用户内存的字节数。mi_alloc（）函数是用户内存的构造函数。

        服务器端：从C用户定义例程的角度来看，该函数的行为类似于malloc（）系统调用，只是数据库服务器可以回收mi_alloc（）分配的内存。函数的作用是：在当前内存持续时间内分配内存。默认情况下，当前内存持续时间为PER_ROUTINE。使用PER_ROUTINE持续时间，数据库服务器在C UDR返回后释放分配的内存。

除回调例程外，您可以通过以下任一方式更改内存持续时间：

        1,使用mi_dalloc（）而不是mi_alloc（）来分配内存。

mi_dalloc（）函数的工作方式与mi_alloc（）相同，并提供指定持续时间的选项。

        2,在调用mi_alloc（）之前，先调用mi_switch_mem_duration（）。

函数mi_switch_mem_duration()用于更改所有后续内存分配的当前内存持续时间。

        在UDR例程中，当引发异常时，数据库服务器自动释放用mi_alloc（）分配的内存。

        重要提示：在C UDR中，使用DataBlade API内存管理函数来分配内存。使用DataBlade API内存管理功能可以保证数据库服务器可以自动释放内存，尤其是在返回值或异常的情况下，否则例程将无法释放内存。

        客户端：在客户端LIBMI应用程序中，mi_alloc（）的工作方式与malloc（）完全相同：它在客户端进程的堆上分配存储。数据库服务器不执行任何自动存储检索。客户端LIBMI应用程序必须使用mi_free（）来显式释放mi_alloc（）进行的所有分配。客户端LIBMI应用程序忽略内存持续时间。

客户端LIBMI应用程序可以使用DataBlade API内存管理函数或系统内存管理函数（如malloc（））。

        函数mi_alloc()的作用是：返回一个指向新分配的用户内存的指针。强制转换此指针以匹配用户定义的缓冲区或分配的结构。DataBlade API模块可以使用mi_free（）来释放由mi_alloc（）分配的内存（当不再需要该内存时）。

3.返回值

        一个void指针。

        指向新分配内存的指针。强制转换此指针以匹配为其分配内存的用户定义缓冲区或结构。

        NULL

        函数无法分配内存。

        mi_alloc（）函数在遇到运行时错误时不会引发MI_Exception事件。因此，它不会导致调用回调。