#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.