add_global_atom

template <class character>
atom add_global_atom(const character* string)

This function template adds a character string to the global atom table and returns its atom.

Parameters

const character* string

A pointer to the string to be added to the atom table.

Return

atom

If the function fails, zero is returned; otherwise, the atom for the string is returned.

Notes

For comments on case sensitivity and string versus integer atoms, see the notes for the function add_atom.