mcowrap.h

extremeDB s sample code,useful for you

MCO_RET   mco_w_v_nchars_e_put2        ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 el_size, const nchar_t * src, uint2 srcsz, int2 indexaware);

MCO_RET   mco_w_v_nstring_size_put2    ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 length );
MCO_RET   mco_w_v_nstring_e_get_len2   ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 * retlen );
MCO_RET   mco_w_v_nstring_e_get2       ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, nchar_t *dest, uint2 destsz, uint2 * retlen);
MCO_RET   mco_w_v_nstring_e_put2       ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, const nchar_t *src, uint2 srcsz, int2 indexaware);

#ifdef MCO_CFG_WCHAR_SUPPORT
MCO_RET   mco_w_v_wchars_size_put2     ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 length, uint2 elsize);
MCO_RET   mco_w_v_wchars_e_get2        ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 el_size, wchar_t *dest, uint2 destsz);
MCO_RET   mco_w_v_wchars_e_put2        ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 el_size, const wchar_t * src, uint2 srcsz, int2 indexaware);

MCO_RET   mco_w_v_wstring_size_put2    ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 length );
MCO_RET   mco_w_v_wstring_e_get_len2   ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 * retlen );
MCO_RET   mco_w_v_wstring_e_get2       ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, wchar_t *dest, uint2 destsz, uint2 * retlen);
MCO_RET   mco_w_v_wstring_e_put2       ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, const wchar_t *src, uint2 srcsz, int2 indexaware);
#endif

MCO_RET   mco_w_va_struct_e_put2      ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, 
                                        mco_objhandle_h ret, uint2 index, 
                                        uint2 s_u_aligned_sz, uint2 s_c_aligned_sz,
                                        int2 indexaware, uint2 len);
MCO_RET   mco_w_va_struct_e_get2      ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, 
                                        mco_objhandle_h ret, uint2 index, 
                                        uint2 s_u_aligned_sz, uint2 s_c_aligned_sz,
                                        uint2 len);

MCO_RET   mco_w_va_chars_e_get2       ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 el_size, char *dest, uint2 destsz, uint2 len);
MCO_RET   mco_w_va_chars_e_put2       ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 el_size, const char * src, uint2 srcsz, int2 indexaware, uint2 len);

MCO_RET   mco_w_va_nchars_e_get2       ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 el_size, nchar_t *dest, uint2 destsz, uint2 len);
MCO_RET   mco_w_va_nchars_e_put2       ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 el_size, const nchar_t * src, uint2 srcsz, int2 indexaware, uint2 len);

#ifdef MCO_CFG_WCHAR_SUPPORT
MCO_RET   mco_w_va_wchars_e_get2       ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 el_size, wchar_t *dest, uint2 destsz, uint2 len);
MCO_RET   mco_w_va_wchars_e_put2       ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 el_size, const wchar_t * src, uint2 srcsz, int2 indexaware, uint2 len);
#endif

MCO_RET   mco_w_va_simple_e_get2      ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 elsize, void *dest, uint2 len);
MCO_RET   mco_w_va_simple_e_getrange2 ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 startindex, uint2 elsize, uint2 numof_els, void * dest, uint2 len, short is_enum);
MCO_RET   mco_w_va_simple_e_put2      ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 elsize, int2 indexaware, const void * src, uint2 len);
MCO_RET   mco_w_va_simple_e_putrange2 ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 startindex, uint2 elsize, uint2 numof_els, int2 indexaware, const void * pfrom, uint2 len, short is_enum);

MCO_RET   mco_w_va_string_e_get_len2  ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 * retlen, uint2 len);
MCO_RET   mco_w_va_string_e_get2      ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, char *dest, uint2 destsz, uint2 * retlen, uint2 len);
MCO_RET   mco_w_va_string_e_put2      ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, const char *src, uint2 srcsz, int2 indexaware, uint2 len);

MCO_RET   mco_w_va_nstring_e_get_len2  ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 * retlen, uint2 len);
MCO_RET   mco_w_va_nstring_e_get2      ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, nchar_t *dest, uint2 destsz, uint2 * retlen, uint2 len);
MCO_RET   mco_w_va_nstring_e_put2      ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, const nchar_t *src, uint2 srcsz, int2 indexaware, uint2 len);

#ifdef MCO_CFG_WCHAR_SUPPORT
MCO_RET   mco_w_va_wstring_e_get_len2  ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, uint2 * retlen, uint2 len);
MCO_RET   mco_w_va_wstring_e_get2      ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, wchar_t *dest, uint2 destsz, uint2 * retlen, uint2 len);
MCO_RET   mco_w_va_wstring_e_put2      ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 index, const wchar_t *src, uint2 srcsz, int2 indexaware, uint2 len);
#endif

MCO_RET   mco_w_tree_find             ( mco_trans_h t, mco_cursor_h c, MCO_OPCODE op, mco_external_key_h ek ); 

MCO_RET   mco_w_b1_put                ( mco_objhandle_h obj, mco_obj_offset fld_offset, int2 indexaware, uint1 val );
MCO_RET   mco_w_b1_put2               ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, int2 indexaware, uint1 val );
MCO_RET   mco_w_b1_put_ev             ( mco_objhandle_h obj, mco_obj_offset fld_offset, int2 indexaware, uint1 val, uint2 ev_id );
MCO_RET   mco_w_b1_put_ev2            ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, int2 indexaware, uint1 val, uint2 ev_id);
MCO_RET   mco_w_b1_get                ( mco_objhandle_h obj, mco_obj_offset fld_offset, void *p ); 
MCO_RET   mco_w_b1_get2               ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, void *p ); 

MCO_RET   mco_w_b2_put                ( mco_objhandle_h obj, mco_obj_offset fld_offset, int2 indexaware, uint2 val );
MCO_RET   mco_w_b2_put2               ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, int2 indexaware, uint2 val );
MCO_RET   mco_w_b2_put_ev             ( mco_objhandle_h obj, mco_obj_offset fld_offset, int2 indexaware, uint2 val, uint2 ev_id  );
MCO_RET   mco_w_b2_put_ev2            ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, int2 indexaware, uint2 val, uint2 ev_id );
MCO_RET   mco_w_b2_get                ( mco_objhandle_h obj, mco_obj_offset fld_offset, void *p ); 
MCO_RET   mco_w_b2_get2               ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, void *p ); 

MCO_RET   mco_w_b4_put                ( mco_objhandle_h obj, mco_obj_offset fld_offset, int2 indexaware, uint4 val );
MCO_RET   mco_w_b4_put2               ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, int2 indexaware, uint4 val );
MCO_RET   mco_w_b4_put_ev             ( mco_objhandle_h obj, mco_obj_offset fld_offset, int2 indexaware, uint4 val, uint2 ev_id );
MCO_RET   mco_w_b4_put_ev2            ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, int2 indexaware, uint4 val, uint2 ev_id );
MCO_RET   mco_w_b4_get                ( mco_objhandle_h obj, mco_obj_offset fld_offset, void *p ); 
MCO_RET   mco_w_b4_get2               ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, void *p ); 

MCO_RET   mco_w_b8_put                ( mco_objhandle_h obj, mco_obj_offset fld_offset, int2 indexaware, const void *p );
MCO_RET   mco_w_b8_put2               ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, int2 indexaware, const void *p );
MCO_RET   mco_w_b8_put_ev             ( mco_objhandle_h obj, mco_obj_offset fld_offset, int2 indexaware, const void *p, uint2 ev_id );
MCO_RET   mco_w_b8_put_ev2            ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, int2 indexaware, const void *p, uint2 ev_id );
MCO_RET   mco_w_b8_get                ( mco_objhandle_h obj, mco_obj_offset fld_offset, void *p ); 
MCO_RET   mco_w_b8_get2               ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, void *p ); 

MCO_RET   mco_w_chars_put             ( mco_objhandle_h obj, mco_obj_offset fld_offset, const char * src, uint2 src_size, uint2 fldsize, int2 indexaware );
MCO_RET   mco_w_chars_put2            ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const char * src, uint2 src_size, uint2 fldsize, int2 indexaware );
MCO_RET   mco_w_chars_put_ev          ( mco_objhandle_h obj, mco_obj_offset fld_offset, const char * src, uint2 src_size, uint2 fldsize, int2 indexaware, uint2 ev_id );
MCO_RET   mco_w_chars_put_ev2         ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const char * src, uint2 src_size, uint2 fldsize, int2 indexaware, uint2 ev_id );
MCO_RET   mco_w_chars_get             ( mco_objhandle_h obj, mco_obj_offset fld_offset, char * dest, uint2 dest_size, uint2 fldsize );
MCO_RET   mco_w_chars_get2            ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, char * dest, uint2 dest_size, uint2 fldsize );

MCO_RET   mco_w_string_get2           ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, char * dest, uint2 dest_size, uint2 * retlen );
MCO_RET   mco_w_string_len2           ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 * ret );
MCO_RET   mco_w_string_put2           ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const char * src, uint2 nbytes, int2 indexaware );
MCO_RET   mco_w_string_put_ev2        ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const char * src, uint2 nbytes, int2 indexaware, uint2 ev_id );

MCO_RET   mco_w_nchars_put             ( mco_objhandle_h obj, mco_obj_offset fld_offset, const nchar_t * src, uint2 src_size, uint2 fldsize, int2 indexaware );
MCO_RET   mco_w_nchars_put2            ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const nchar_t * src, uint2 src_size, uint2 fldsize, int2 indexaware );
MCO_RET   mco_w_nchars_put_ev          ( mco_objhandle_h obj, mco_obj_offset fld_offset, const nchar_t * src, uint2 src_size, uint2 fldsize, int2 indexaware, uint2 ev_id );
MCO_RET   mco_w_nchars_put_ev2         ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const nchar_t * src, uint2 src_size, uint2 fldsize, int2 indexaware, uint2 ev_id );
MCO_RET   mco_w_nchars_get             ( mco_objhandle_h obj, mco_obj_offset fld_offset, nchar_t * dest, uint2 dest_size, uint2 fldsize );
MCO_RET   mco_w_nchars_get2            ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, nchar_t * dest, uint2 dest_size, uint2 fldsize );

MCO_RET   mco_w_nstring_get2           ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, nchar_t * dest, uint2 dest_size, uint2 * retlen );
MCO_RET   mco_w_nstring_len2           ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 * ret );
MCO_RET   mco_w_nstring_put2           ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const nchar_t * src, uint2 nbytes, int2 indexaware );
MCO_RET   mco_w_nstring_put_ev2        ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const nchar_t * src, uint2 nbytes, int2 indexaware, uint2 ev_id );

#ifdef MCO_CFG_WCHAR_SUPPORT
MCO_RET   mco_w_wchars_put             ( mco_objhandle_h obj, mco_obj_offset fld_offset, const wchar_t * src, uint2 src_size, uint2 fldsize, int2 indexaware );
MCO_RET   mco_w_wchars_put2            ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const wchar_t * src, uint2 src_size, uint2 fldsize, int2 indexaware );
MCO_RET   mco_w_wchars_put_ev          ( mco_objhandle_h obj, mco_obj_offset fld_offset, const wchar_t * src, uint2 src_size, uint2 fldsize, int2 indexaware, uint2 ev_id );
MCO_RET   mco_w_wchars_put_ev2         ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const wchar_t * src, uint2 src_size, uint2 fldsize, int2 indexaware, uint2 ev_id );
MCO_RET   mco_w_wchars_get             ( mco_objhandle_h obj, mco_obj_offset fld_offset, wchar_t * dest, uint2 dest_size, uint2 fldsize );
MCO_RET   mco_w_wchars_get2            ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, wchar_t * dest, uint2 dest_size, uint2 fldsize );

MCO_RET   mco_w_wstring_get2           ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, wchar_t * dest, uint2 dest_size, uint2 * retlen );
MCO_RET   mco_w_wstring_len2           ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint2 * ret );
MCO_RET   mco_w_wstring_put2           ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const wchar_t * src, uint2 nbytes, int2 indexaware );
MCO_RET   mco_w_wstring_put_ev2        ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const wchar_t * src, uint2 nbytes, int2 indexaware, uint2 ev_id );
#endif

MCO_RET   mco_w_struct_get2           ( mco_objhandle_h obj, mco_objhandle_h ret, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset );
MCO_RET   mco_w_struct_put2           ( mco_objhandle_h obj, mco_objhandle_h ret, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, int2 indexaware );

MCO_RET   mco_w_blob_get2             ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint4 startOffset, char * dest, uint4 dest_size, uint4 * retlen );
MCO_RET   mco_w_blob_len2             ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, uint4 *result );
MCO_RET   mco_w_blob_put2             ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const char * src, uint4 nbytes );
MCO_RET   mco_w_blob_append2          ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, const char * src, uint4 nbytes );

MCO_RET   mco_w_optional_get2         ( mco_objhandle_h obj, mco_objhandle_h ret, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset );
MCO_RET   mco_w_optional_put2         ( mco_objhandle_h obj, mco_objhandle_h ret, int struct_num,
                                        mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset, 
                                        uint2 struct_u_size, uint2 struct_c_size, uint2 u_align, uint2 c_align);
MCO_RET   mco_w_optional_erase2       ( mco_objhandle_h obj, mco_obj_offset fld_u_offset, mco_obj_offset fld_c_offset );

MCO_RET   mco_w_voluntary_drop        ( mco_trans_h t, uint2 index_code);
MCO_RET   mco_w_voluntary_create      ( mco_trans_h t, uint2 index_code);

MCO_RET   mco_w_compact               ( mco_objhandle_h obj, uint2 class_code, int struct_num, uint4 * pages_released ); 

typedef MCO_RET (*mco_generic_ev_handler)(mco_trans_h t, mco_objhandle_h obj, MCO_EVENT_TYPE et, void *param); 
MCO_RET   mco_ev_h_register           ( mco_trans_h t, mco_generic_ev_handler h, uint2 event_id, void * param, uint2 before_upd);
MCO_RET   mco_ev_h_unregister         ( mco_trans_h t, mco_generic_ev_handler h, uint2 event_id);

MCO_RET   mco_w_xml_get_object        ( mco_objhandle_h obj, void * stream_handle, mco_stream_write o_stream, uint2 class_code );
MCO_RET   mco_w_xml_put_object        ( mco_objhandle_h obj, const char * xml, uint2 class_code );
MCO_RET   mco_w_xml_create_object     ( mco_trans_h t, const char * xml, mco_objhandle_h obj, uint2 class_code );
MCO_RET   mco_w_xml_schema            ( mco_trans_h t, void * stream_handle, mco_stream_write o_stream, uint2 class_code );

MCO_RET   mco_autoid_cursor          ( mco_trans_h t, void* h, mco_cursor_h c );
MCO_RET mco_autoid_cursor_next(
                  mco_trans_h t,
                  mco_cursor_h c0
                  );

/**\fn
\return returns MCO_YES if the handles point to the same object */
mco_bool   mco_objects_eq             ( OBJH1(p1), OBJH1(p2) );

/* Pattern match */

uint4 mco_w_pattern_size ( uint2 index_no,  mco_external_field_h fields);

MCO_RET mco_w_pattern_search ( mco_trans_h transaction, uint2 index_no, void *pattern_mem,
			     uint4 memsize, mco_objhandle_h obj, mco_external_field_h fields);
 
MCO_RET mco_w_pattern_next  ( mco_trans_h transaction, uint2 index_no, void *pattern_mem,
			    mco_objhandle_h obj, uint2 is_first_search);
 
void mco_get_default_pattern_policy ( mco_pattern_policy_t * p );
MCO_RET mco_get_pattern_policy ( mco_trans_h t, mco_pattern_policy_t * p );
MCO_RET mco_set_pattern_policy ( mco_trans_h t, const mco_pattern_policy_t * p );

#ifdef __cplusplus
}
#endif

#endif