Availability:C-language interface function
int 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, FALSE on a resource error (leaving a resource
error exception in the environment),
-1 if some key or the tag is invalid and -2
if there are duplicate keys.