c('PL_new_atom_mbchars')

Documentation
- Reference manual
  - Foreign Language Interface
    - The Foreign Include File
      - Atoms and functors
        
        PL_new_atom()
        
        PL_new_atom_mbchars()
        
        PL_atom_mbchars()
        
        PL_atom_chars()
        
        PL_atom_index()
        
        PL_atom_from_index()
        
        PL_new_functor()
        
        PL_functor_name()
        
        PL_functor_arity()
        
        Atoms and atom garbage collection
- Packages

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