NAME

cp_multimap_set_mode, cp_multimap_unset_mode, cp_multimap_get_mode - manage multimap mode setting

SYNOPSIS

#include <cprops/multimap.h>

int cp_multimap_get_mode(cp_multimap *tree);
int cp_multimap_set_mode(cp_multimap *tree, int mode);
int cp_multimap_unset_mode(cp_multimap *tree, int mode);

DESCRIPTION

cp_multimap_get_mode returns the current map mode.

cp_multimap_set_mode and cp_multimap_unset_mode set or unset the requested mode bits respectively. Note that CP_COLLECTION_MODE_MULTIPLE_VALUES determines whether the default index for the given mapping is unique and may only be set at creation time.

RETURN VALUE

All functions return zero on success. cp_multimap_set_mode returns EINVAL if attempting to set COLLECTION_MODE_MULTIPLE_VALUES or attempting to set COLLECTION_MODE_NOSYNC during a transaction.
cp_multimap_unset_mode returns EINVAL if attempting to unset COLLECTION_MODE_MULTIPLE_VALUES.