mco_db_xml_export

将数据库映像保存到外部文件。

此函数将数据库数据导出到输出流。运行时会调用应用程序定义的处理程序来管理输出流。应用程序负责以适合流式传输二进制数据的模式打开输出流，并确保目标位置有足够的空间来容纳数据库。索引不会被流式传输；在重新加载数据库时将重新构建索引。

有关详细信息，请参阅控制结构流式写入器。

    MCO_RET	mco_db_xml_export(	
    	/*IN*/ mco_trans_h t,
		/*IN*/ void * stream_handle,
		/*IN*/ mco_stream_write output_stream_writer 
   );

参数

t

mco_trans_h

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

stream_handle

void *

输出流的句柄。

output_stream_writer

mco_stream_write

运行时调用的用于格式化输出的处理函数。

返回

MCO_S_OK

已成功关闭数据库。

MCO_E_WRITE_STREAM

写入输出流错误。

示例

    /*  应用程序代码片段 */
        
     
    const char * dbname = "SimpleDb";
     
    /* Stream writer with prototype mco_stream_write */
    mco_size_sig_t file_writer( void *stream_handle /* FILE *  */, const void *from, mco_size_t nbytes )
    {
        FILE *f = (FILE *)stream_handle;
        mco_size_sig_t nbs;
        nbs = fwrite( from, 1, nbytes, f );
        return nbs;
    }
     
    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;
        FILE * f;
         
        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);
            ...
             
            /* Export database */
            f = fopen( "db.xml", "wb" );
            if ( f == 0 ) 
            {
                printf( "\n\t Can't open output file for streaming\n");
            }
            else 
            { 
                rc = mco_trans_start(db, MCO_READ_ONLY, MCO_TRANS_FOREGROUND, &t);
                if ( MCO_S_OK == rc ) 
                {
                    rc = mco_db_xml_export( t, f, file_writer );
        
                    mco_trans_rollback( t );
                    fclose( f );
                    ...
                }
            }
            ...
        }
    }

文件

• 头文件：mcoxml.h
• 源文件：mcoxser.c
• 库：libmcolib.a