ToC path:

classname_fieldname_insert_nullable

This function inserts the supplied values, including nulls, into the sequence.

Prototype

 
    MCO_RET	classname_fieldname_insert_nullable(	/*IN*/ classname *handle, 
                            /*IN*/ mco_seq_no_t pos,
                            /*IN*/ TYPE *values, 
                            /*IN*/ mco_size_t n_items,
                            /*IN*/ mco_bitmap_word_t const * nulls );

Arguments

handle	A pointer to a classname handle
pos	The position number (zero-based) where values are to be inserted
values	A pointer to the values to be inserted into the sequence
n_items	The number of elements to be inserted from `values` to the sequence
nulls	An array of `mco_bitmap_word_t` (defined as an 8-byte unsigned integer), where each set bit marks a null element in the sequence. The position of the bit corresponds to the position of the null element in the sequence. Given that `mco_bitmap_word_t` is 8 bytes (64 bits), the `nulls` array must contain at least `((n_items + 63) / 64)` elements

Description

This function applies to sequence fields. The supplied values are inserted into the sequence at position pos.

Return Codes

MCO_S_OK	The value was put successfully
MCO_E_ACCESS	The transaction that the class handle is scoped to is `MCO_READ_ONLY`

Example

 
    Quote quote;
    float open_buf[BUF_SIZE];
    mco_bitmap_word_t null_bitmap[(BUF_SIZE + 63) / 64];
     
    /* Reset NULL bitmap */
    memset(null_bitmap, 0x00, sizeof(null_bitmap));
     
    /* Locate the quote object and initialize the "quote" handle... */
     
    /* Fill the open_buf with BUF_SIZE values... */
    /* ... */
     
    /* Mark the first element as null by setting the first bit */
    null_bitmap[0] |= 0x01;
     
    /* Mark the third element as null by setting the third bit */
    null_bitmap[0] |= 0x04;
     
    /* Insert the "open_buf" array's contents into the "open" sequence
    of the quote at position 0, and set the NULL bitmap */
    Quote_open_insert_nullable(&quote, 0, open_buf, BUF_SIZE, null_bitmap);