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.221Versions 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.
