#define ASAtomNull ASMAXUns32
#define ASAtomNull ASMAXUns16
typedef ASUns32 ASAtom;
typedef ASUns16 ASAtom;
ASBool ASAtomExistsForString(const char *nameStr, ASAtom *atom);
nameStr | The string to test.
|
atom |
Gets the ASAtom for the specified string. You can also use this method to create an ASAtom, since it creates one for the string if one does not already exist.
If an ASAtom already exists for nameStr, the existing ASAtom is returned. Thus, ASAtom objects may be compared for equality of the underlying string.
Because ASAtom objects cannot be deleted, they are useful for strings that are used many times in an Acrobat viewer session, but are not recommended for strings that have a short lifetime. For the same reason, it is not a good idea to create large numbers of ASAtom objects.
ASAtom ASAtomFromString(const char *nameStr);
nameStr | The string for which an ASAtom is created.
|
nameStr. const char *ASAtomGetString(ASAtom atm);
atm | The ASAtom whose string is obtained.
|
atom. It returns an empty string if atom == ASAtomNull, or NULL if the atom has not been defined.