BOOL InitAtomTable(nSize)
This function initializes an atom hash table and sets its size to that specified by the nSize parameter. If this function is not called, the atom hash table size is set to 37 by default.
If used, this function should be called before any other atom-management function.
Parameter | Type/Description |
nSize | int Specifies the size (in table entries) of the atom hash table. This value should be a prime number. |
The return value specifies the outcome of the function. It is nonzero if the function is successful. Otherwise, it is zero.
If an application uses a large number of atoms, it can reduce the time required to add an atom to the atom table or to find an atom in the table by increasing the size of the table. However, this increases the amount of memory required to maintain the table.
The size of the global atom table cannot be changed from its default size of 37.