mco_index_get_size

该函数返回索引的大小，即索引结构（树）中的键值数量。

此 API 与 mco_index_stat_get() 类似，但速度更快，它不执行任何计算，因此可以频繁使用。

    MCO_RET	mco_index_get_size(	
    	/*IN*/ mco_trans_h t,
        /*IN*/ uint2 index_number,
        /*OUT*/ mco_counter_t * size 
    );

参数

t

mco_trans_h

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

index_number

uint2 *

一个 2 字节的无符号整数，表示所需统计信息的索引。通常，首先通过调用 mco_index_stat_num() 获取索引的总数，然后从 0 迭代到总数减 1。

size

用于接收索引大小的 mco_counter_t 类型变量的地址。

MCO_S_OK

成功返回索引大小。

MCO_E_INVALID_HANDLE

数据库句柄未打开。

MCO_E_INDEXLIMIT

无效的索引号。

示例

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

     
    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;
        uint2 n_indexes;
        mco_counter_t size;
        int j;
         
        ...
        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 )
            {
                mco_index_stat_num( t, &n_indexes );
                 
                for ( j=0; j < n_indexes && MCO_S_OK == rc; j++ )
                {
                    rc = mco_index_get_size( t, j, &size );

                    if ( MCO_S_OK == rc  )
                    {
                        printf( "Index number %d size is %4d\n\t\t\t",
                                j, size);
                    }
                }
                ...
            }
        }
        ...
    }

文件

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