# 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

## Example