# mco_db_free_pages
RT

> Return the count of available in-memory pages.

### Prototype

        MCO_RET mco_db_free_pages(	/*IN*/ mco_db_h h, /*OUT*/ uint4 * free_pages );

### Arguments

db | The database handle that was established by `mco_db_connect()`.
free_pages | The address of a `uint4` variable to receive the number of in-memory free pages.

### Description

> This function returns into `free_pages` the count of available in-memory pages in the database referenced by handle `db`.

### Return Codes

MCO_S_OK | The free page count was returned successfully.
MCO_E_INVALID_HANDLE | Database handle not opened.

### Example

        Application snippet:

        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;
            uint4 free_pages;
            ...

            if( (rc = mco_runtime_start()) != MCO_S_OK)
                exit(-1);

            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_db_free_pages(db, &free_pages);

            }
            ...
        }

### Files

Header file:
mco.h
Source file:
mcodb.c
Library:
libmcolib.a