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().