Availability:C-language interface function
atom_t PL_new_atom_mbchars(int
rep, size_t len, const char *s)This function generalizes PL_new_atom()
and PL_new_atom_nchars()
while allowing for multiple encodings. The rep argument is
one of
REP_ISO_LATIN_1, REP_UTF8 or REP_MB.
If
len is (size_t)-1, it is computed from s
using
strlen(). Raises an exception if s violates rep
and returns (atom_t)0. For other error conditions, see PL_new_atom().