cp_multimap

Section: libcprops - cp_multimap (3)
Updated: OCT 2007
Index Return to Main Contents

NAME

cp_multimap_reindex - reposition an entry in a multimap after changing key field values

SYNOPSIS

int cp_multimap_reindex(cp_multimap *map, void *before, void *after);

DESCRIPTION

cp_multimap_reindex must be called to correctly reposition an entry when changing fields that affect entry placement with reference to map indices. This requires creating a new entry with the modified value. Reindexing removes the old entry from the map and inserts the new entry instead.

RETURN VALUE

cp_multimap_reindex return zero on success or non-zero on error. Possible error codes are CP_LOCK_FAILED on locking failure or CP_UNIQUE_INDEX_VIOLATION if the modified value can not be reconciled with existing index constraints.