classname_fieldname_subseq

This function returns the sub-sequence specified by the positions range.

Prototype

 
    MCO_RET	classname_fieldname_subseq(	/*IN*/ classname *handle, 
                            mco_seq_iterator_h iterator,
                            mco_seq_no_t from,
                            mco_seq_no_t till, 
                            );
 

Arguments

handle A pointer to a classname handle
iterator The output iterator.

from

The beginning position number. 

till

The ending position number. 

Description

This function applies to sequence fields and returns a sub-sequence specified by a range of elements. The range is defined by the "from" and "to" position values.

The "from" value may be greater than "to", which enables iteration in reverse order.

Note: When using reverse iteration, the input sequence must be fetched directly from the database. The resulting iterator should be used solely to access elements.

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

Related Topics Link IconRelated Topics

Example