c('PL_put_dict')

Availability:C-language interface function

bool PL_put_dict(term_t -h, atom_t tag, size_t len, const atom_t *keys, term_t values)

Create a dict from a tag and vector of atom-value pairs and put the result in h. The dict's key is set by tag, which may be 0 to leave the tag unbound. The keys vector is a vector of atoms of at least len long. The values is a term vector allocated using PL_new_term_refs() of at least len long. This function returns true on success. On failure it returns false and leaves an exception in the environment. This is either a resource exception or a duplicate_key(Key) exception.^{223Versions up to 10.1.2
returned -1 if the tag or one of the keys was
invalid and -2 if there are duplicate keys. Later versions terminate
with a fatal ABI error if tag or one of the keys
is invalid and raises a normal Prolog exception on duplicate keys.}