| Layer | AS_Layer |
| Object | ASAtom |
ASAtom objects are hashed tokens that Acrobat uses in place of strings to optimize performance (it is much faster to compare ASAtom objects than strings). ASAtom methods convert between strings and ASAtom objects.
| Define | ||
|---|---|---|
| ASAtomNull | ||
| Typedef | ||
|---|---|---|
| ASAtom | ||
| Method | ||
|---|---|---|
|
ASBool ASAtomExistsForString(const char* nameStr, ASAtom* atom)
Tests whether an ASAtom exists for the specified string.
|
||
|
ASAtom ASAtomFromString(const char* nameStr)
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.
|
||
|
const char* ASAtomGetString(ASAtom atm)
Gets the string associated with the specified ASAtom.
|
||
| ASAtomNull |
| Product availability: All |
| Platform availability: All |
#define ASAtomNull ASMAXUns32
| File: CoreExpT.h |
| Line: 131 |
| ASAtom |
| Product availability: All |
| Platform availability: All |
typedef ASUns32 ASAtom;
| File: CoreExpT.h |
| Line: 130 |
| ASAtomExistsForString | () |
| Product availability: All |
| Platform availability: All |
Tests whether an ASAtom exists for the specified string.
Parameters
nameStr — | The string to test. |
|
atom — | (Filled by the method, may be |
|
See Also
Since
| File: CorProcs.h |
| Line: 132 |
| ASAtomFromString | () |
| Product availability: All |
| Platform availability: All |
ASAtom ASAtomFromString(const char* nameStr)
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.
Parameters
nameStr — | The string for which an ASAtom is created. |
The ASAtom corresponding to |
See Also
Since
| File: CorProcs.h |
| Line: 116 |
| ASAtomGetString | () |
| Product availability: All |
| Platform availability: All |
const char* ASAtomGetString(ASAtom atm)
Gets the string associated with the specified ASAtom.
Parameters
atm — | The ASAtom whose string is obtained. |
The string corresponding to |
See Also
Since
| File: CorProcs.h |
| Line: 144 |