mco_cursor_close

接口适用于实时数据库 RT 。

此函数允许应用程序显式关闭游标。

高优先级事务（设置为 MCO_TRANS_HIGH 及更高优先级的事务）通过“智能锁定”的技术优化对索引的访问。

通常，在访问页面之前，我们会使用自旋锁锁定页面，并在离开页面之前释放自旋锁（解锁）。当使用智能锁定时，在遍历（搜索）B 树期间，数据库运行时不会释放锁，直到我们到达结果集的末尾，或者调用 mco_cursor_close() 函数。

    MCO_RET	mco_cursor_close(	
        /*IN*/ mco_trans_h t, 
        /*INOUT*/ mco_cursor_h c
    );

参数

t

mco_trans_h

由 mco_trans_start() 函数返回的 mco_trans_h 事务句柄。

c

mco_cursor_h

从游标或索引搜索函数返回的游标句柄。

返回

MCO_S_OK

已成功关闭游标。

MCO_E_CURSOR_CLOSED

游标已关闭。

示例

    /*  应用程序代码片段 */

     
    const char * dbname = "SimpleDb";
     
    int main(int argc, char* argv[])
    {
        mco_db_h db;
        MCO_RET rc;
        mco_device_t       dev;
        mco_db_params_t    db_params;
        mco_trans_h t;
        mco_cursor_t c;
        MCO_CURSOR_TYPE ctype;
         
        ...
        rc = mco_db_open_dev( dbname, simple_get_dictionary(), &dev, 1, &db_params );
        if ( MCO_S_OK != rc )
        {
            rc = mco_db_connect(  dbname, &db );
            ...
            rc = mco_trans_start(db, MCO_READ_ONLY, MCO_TRANS_FOREGROUND, &t);
            if ( MCO_S_OK == rc )
            {
                ...
                A_list_cursor( t, &c);
                ...
                rc = mco_cursor_close( t, &c );

                ...
            }
        }
        ...
    }

文件

• 头文件：mco.h
• 源文件：mcocsr.c
• 库：libmcolib.a