Library Version 12.1.6.0

move_to
Prev | Chapter 15. Db_map_base_iterator | Next

## move_to

### Function Details

    int move_to(const kdt &k,
        int flag=DB_SET) const

Iterator movement function.

Move this iterator to the specified key k, by default moves exactly to k, and update cached data element, you can also specify DB_SET_RANGE, to move to the biggest key smaller than k. The btree/hash key comparison routine determines which key is bigger. When the iterator is on a multiple container, move_to will move itself to the first key/data pair of the identical keys.

#### Parameters

##### k

The target key value to move to.

##### flag

Flags available: DB_SET(default) or DB_SET_RANGE. DB_SET will move this iterator exactly at k; DB_SET_RANGE moves this iterator to k or the smallest key greater than k. If fail to find such a key, this iterator will become invalid.

#### Return Value

0 if succeed; non-0 otherwise, and this iterator becomes invalid. Call db_strerror with the return value to get the error message.

### Class

db_map_base_iterator

Prev | Up | Next
close_cursor | Home | set_bulk_buffer