This function returns the sub-sequence specified by the positions range.
MCO_RET classname_fieldname_subseq( /*IN*/ classname *handle, mco_seq_iterator_h iterator, mco_seq_no_t from, mco_seq_no_t till, );
| handle | A pointer to a classname handle |
| iterator | The output iterator. |
|
from |
The beginning position number. |
|
till |
The ending position number. |
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.
| MCO_S_OK | The value was put successfully |
| MCO_E_ACCESS | The transaction that the class handle is scoped to is MCO_READ_ONLY |