mco_class_save

将整个类保存到外部文件。

此函数用于将整个数据库类的内容以流式传输的方式保存到永久存储中。当与 mco_class_load() 函数结合使用时，应用程序能够保存并选择性地加载类数据。

请注意，此操作会隐式启动一个事务，因此无需提供事务句柄。

mco_class_save() 和 mco_class_load() 的组合与 mco_db_save() 和 mco_db_load() 兼容。这意味着应用程序可以使用 mco_db_save() 保存整个数据库的映像，并在之后从完整映像中加载（或重新加载）特定类的数据。或者，也可以使用 mco_class_save() 仅保存单个类的数据，然后通过 mco_db_load() 使用该映像创建数据库。

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

    MCO_RET	mco_class_save( 
    	/*IN*/ uint2 class_code,
        /*IN*/ void * stream_handle,
        /*IN*/ mco_stream_write output_stream_writer,
        /*IN*/ mco_db_h db
    );

参数

class_code

uint2

整数类代码（来自生成的头文件）。

stream_handle

void *

输出流的句柄。

output_stream_writer

mco_stream_write

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

db

mco_db_h

数据库句柄。

MCO_S_OK

已成功保存数据库镜像。

MCO_E_NOINSTANCE

指定的数据库未打开。

MCO_E_WRITE_STREAM

写入输出流时出错。

示例

    /*  应用程序代码片段 */
        
     
    const char * dbname = "SimpleDb";
     
    /* 具有原型 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;
        FILE * fbak;
        uint2 my_class_code = 1;
        ...
         
        if( (rc = mco_runtime_start()) != MCO_S_OK)
            exit(-1);
             
        rc = mco_db_open_dev( dbname, simpledb_get_dictionary(), &dev, 1, &db_params );
        if ( MCO_S_OK != rc )
        {
            rc = mco_db_connect(dbname, &db);
            ...
             
            /* 备份数据库 */
            fbak = fopen( "myclass.bak", "wb" );
            if ( fbak == 0 ) 
            {
                printf( "\n\t Can't open output file for streaming\n");
            }
            else 
            { 
                rc = mco_class_save( my_class_code, (void *)fbak, file_writer, db );
        
                fclose( fbak );
                sample_rc_check( "\t Save class", rc );
            }
            ...
        }
    }

文件

头文件：mco.h
源文件：mcosericmn.c
库：libmcoseri.a