Acro Support Layer

Tests whether an ASAtom exists for the specified string.

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

Gets the string associated with the specified ASAtom.

For each key/value pair ina copy of the key/value pair will be placed into, possibly overwriting any identically named key/value pair in. If the value being copied is a pointer with an associated, the pointer and its type string, but not the data it points to, will be copied and an internal reference count will be incremented.

Destroys the cabinet and all its key/value pairs. This method raises an exception if the cabinet is the value for some key in another cabinet.

Finds any empty cabinets in, removes their corresponding keys, and destroys them.

Retrieves the binary object stored underinand removes the key from. The client assumes ownership of the object and is responsible for deallocating any resources associated with it.

Retrieves the ASCab stored underinand removes the key from. The client assumes ownership of the ASCab returned and is responsible for destroying it.

Retrieves the ASPathName stored underinand removes the key from. Bothandwill beifwas not found, there was no valid ASPathName stored under the key, or if the ASPathName does not point to an existing file. It is the client's responsibility to release the memory associated with the ASPathName using ASFileSysReleasePath(). @since

Retrieves the pointer stored underinand removes the key from. Ifis set to, the client assumes ownership of the data referenced by the pointer and is responsible for deallocating any resources associated with it.

Retrieves the string stored underinand removes the key from. The client assumes ownership of the string and is responsible for deallocating any resources associated with it.

Retrieves the ASText object stored underinand removes the key from. The client assumes ownership of the ASText object and is responsible for deallocating it using ASTextDestroy().

Creates a new ASCab and populates it with copies of the key/value pairs in. It is equivalent to.

Enumerates all the keys in the cabinet. Keys consisting solely of digits are enumerated first, in numeric order (assuming they are not padded with zeros at the front, which will confuse matters). Non-numeric keys are then enumerated inorder. It is safe to add, delete, and modify items induring the enumeration. Items that are added during the enumeration will not be enumerated. Modified items that have been enumerated already will not be enumerated again. Deleted items that have not yet been enumerated will not be enumerated. This willany exceptions thrown by.

Compares two cabinets and verifies that they have a matching set of keys and that all key values are equal as reported by ASCabValueEqual().

Builds a cabinet based on a constant array of ASCabDescriptor records (see). The first entry in each descriptor specifies the name of the key; subsequent fields contain the value. The entry list must end with a descriptor containingfor the key name. Seefor more info.

Returns the ASAtom value stored underin.

Returns the binary object stored underin.

Returns a copy of the binary object stored underin. It is the client's responsibility to release the memory associated with the object using ASfree().

Returns the ASBool value stored underin.

Returns the ASCab stored underin.

Returns thevalue stored underin. If the value stored underis of type kASValueInteger, this value will be cast to aand returned to the client.

Returns the ASInt32 value stored underin.

Returns the ASInt64 value stored underin.

Returns a copy of ASPathName stored underin. It is the client's responsibility to release the ASPathName using ASFileSysReleasePath(). Bothandwill beifwas not found, there was no valid ASPathName stored under the key, or ifdoes not point to an existing file.

Obtains the resource deallocation callback associated with the pointer stored underin. When the reference count of the pointer falls to zero, the callback is called to free the resources associated with the object it references.

Returns the pointer value stored underin.

Returns a string representation of the data type referenced by the pointer stored underin.

Returns the string stored underin.

Returns a copy of the string stored underin. It is the client's responsibility to release the memory allocated for the string using ASfree().

Returns the ASText object stored underin.

Returns the type of value stored underin.

Returns the ASUns32 value stored underin.

Returns the ASUns64 value stored underin.

Returnsifis present in.

Removes all keys fromand destroys all values they point to.

Munges the keys and the corresponding values inbased on the keys inand the munge action. Note thatis never altered, butis.

Creates a new, empty cabinet.

Returns the number of key/value pairs in.

Stores an ASAtom value inunder.

Stores a binary object inunder. The ASCab assumes ownership of the binary object, so the client should not attempt to free the memory associated with it. The binary object must have been allocated using ASmalloc().

Stores an ASBool value in theCab under theKey.

Stores an ASCab inunder. If the cabinet is already a value for some other ASCab, ASCabPutCab() will raise an exception, since any cabinet can be contained by at most one other cabinet.assumes ownership of the cabinet, so the client must not destroy it.

Stores avalue inunder.

Stores an ASInt32 value inunder.

Stores an ASInt64 value inunder.

Stores a value with a type of kASValueNull inunder.cabinet entries are used as placeholders or to removed other cabinet entries during an ASCabMunge operation.

Stores an ASPathName inunder.assumes ownership of the ASPathName, so the client need not call ASFileSysReleasePath().

Stores a pointer inunder. See the ASCab description for more information.

Stores a string inunder. A string consists of some number of bytes followed by a single(zero) byte. The string must have been allocated using ASmalloc().assumes ownership of the string, so the client should not attempt to free the memory associated with it.

Stores an ASText object inunder.assumes ownership of the object, so the client should not attempt to free the memory associated with it.

Stores the ASUns32 value underin.

Stores an ASUns64 value inunder.

Reads a previously written cabinet from a stream.

Removesentry from, destroying the associated value.

Renames a key withinwhile preserving the value associated with it. If there is already a key equal toin, its value will be destroyed and replaced with the value of oldKeyName. Any attempt to move the item from one sub-cabinet to another will cause ASCabRename() to raise an exception. For example,will raise an exception. If this routine raises an exception,will be untouched.

Compares two cabinet values and returnsonly if they are equal (meaning that they have the same type and value). Cabinets are compared using ASCabEqual(). ASText values are compared by using ASTextCmp() and testing for a return value of(zero). Strings and binary values must have the same lengths and byte-for-byte contents. Booleans, atoms, doubles, and integers must have equal values. Pointer values must point to the same location in memory but may have differentand type strings.

Writesout to a stream. The caller retains ownership of the cabinet. The stream will not be closed or flushed.

Enumerates all the keys in the constant cabinet. Keys consisting solely of digits are enumerated first, in numeric order (assuming they are not padded with zeros at the front, which will confuse matters). Non-numeric keys are then enumerated inorder. The callback procedure must not add, delete, or modify items induring the enumeration. It willany exceptions thrown by.

A constant that specifies the various types of values in ASCab objects. ASCab objects can be used to store arbitrary key/value pairs. The keys are always-terminated strings containing only low ASCII alphanumeric characters.

Used when enumerating the values inside a cabinet.

A deallocation callback that can be associated with a pointer in an ASCab. When the reference count of the pointer falls to zero, this callback is called to free the resources associated with the object the pointer references.

Used when enumerating the values inside a constant cabinet. The callback procedure must not add, delete, or modify items induring the enumeration.

ASCab objects () can be used to store arbitrary key/value pairs. The keys are always-terminated strings containing only low ASCII alphanumeric characters and spaces (ASCII character). Key names cannot begin or end with a space. Every time you place a non-scalar value inside a cabinet, you are handing that value to the ASCab implementation to manage. Putting a value in a cabinet is always a handoff operation. For example, if you create an ASText object and add it as a value in an ASCab, the ASText object is no longer managed by you; it is managed by the ASCab. The ASCab will destroy the ASText object when its associated key is removed or the key's value is overwritten. Pointer values are a special case discussed in more detail below. The routine naming convention is as follows: Name Description Getroutines return a value. These objects are owned by the ASCab and should not be destroyed by the caller of. GetCopyroutines make a copy of the data; theclient owns the resulting information and can modify it at will; it is also responsible for destroying it. Detachroutines work the same way asroutines, but the key is removed from the ASCab without destroying the associated value that is passed back to the client of. The client is responsible for destroying the returned object. Normally, pointers are treated the same way as scalars; the ASCab passes the pointer value back and forth but does not manage the data to which it points. This all changes if the pointer has an associated. If theis set, the ASCab will reference count the pointer to track how many times the pointer is referenced from any ASCab. For example, the reference count will be bumped up whenever the pointer is copied via ASCabCopy() or added to another ASCab via ASCabPutPointer(), and will destroy the data associated with the pointer when the reference count goes to. The data is destroyed by calling the. Detaching a pointer removes one reference to the pointer without ever destroying the information to which it points. ASCabDetachPointer() returns a separate value indicating whether the pointer can safely be destroyed by the client or is still referred to by other key/value pairs inside any ASCab objects (for example, whether the reference count went to zero when the pointer was detached from the ASCab). Any of the ASCab API's can take a compound name: a string consisting of multiple keys separated by the colon (:) character. For example,can be such a compound name. The implementation will burrow down through such a compound string until it reaches the most deeply nested cabinet. Also, any of theroutines can take akey name. If the key name is, the routine creates a new numeric key name. If the cabinet is empty, the first generated key name will beand subsequent names will increase in ascending order. This is useful when treating an ASCab as a bag of unnamed items, or when adding an ordered list of items to an empty ASCab.

Cabinet keys are-terminated C strings. This constant declares the maximum length of one component of that string. The characters in the key string must all be low ASCII alphanumeric characters, such as,,. You can burrow through multiple levels of a cabinet heirarchy by passing in a string of individual key names separated by colons. For example,is equivalent to. Similarly,will create an integer key namedinside thecabinet inside theCab, creating thekey and cabinet if necessary.

Adds two calendar time spans, storing the result in another calendar time span object. Because the values in a calendar time span are not absolute (for example, a leap year has a different number of days), they are resolved with respect to the base date before the addition is done. The result is broken down into years, months, and so on, in the highest denomination possible. For example, a difference of 13 months is reported as 1 year and 1 month.

Compares two calendar time spans with respect to a base date. Because the values in a calendar time span are not absolute (for example, a leap year has a different number of days), they are resolved with respect to the base date before the comparison is made.

Calculates the difference between calendar time span objects and stores the result in the provided ASCalendarTimeSpan object. Ifis less than, the result is negative. Because the values in a calendar time span are not absolute (for example, a leap year has a different number of days), they are resolved with respect to the base date before the addition is done. The result is broken down into years, months, and so on, in the highest denomination possible. For example, a difference of 13 months is reported as 1 year and 1 month.

Deprecated as of Acrobat 8.0. Creates a callback that allows the Acrobat viewer to call a function in a plug-in. All plug-in functions that are called by the Acrobat viewer must be converted to callbacks before being passed to the viewer. Whenever possible, plug-ins should not call ASCallbackCreate() directly, but should use the macros ASCallbackCreateProto(), ASCallbackCreateNotification(), and ASCallbackCreateReplacement(). These macros (which eventually call ASCallbackCreate()) have two advantages: They allow compilers to perform type checking, eliminating one extremely common source of plug-in bugs. They handleautomatically. Plug-ins must use ASCallbackCreate() directly, for example, when calling a Mac toolbox routine that expects a. If you call ASCallbackCreate() directly, you are actually invoking the ASCallbackCreate() macro, not this HFT routine. The ASCallbackCreate() macro takes only one parameter, the, and passes that information into this underlying HFT routine as the second argument. The first argument is always set to, which should be the extension identifier of your plug-in.

Deprecated as of Acrobat 8.0. Destroys a callback.

A callback for ASCryptStm. This closes a security stream.

A callback for ASCryptStm. This flushes a dirty buffer if necessary.

A callback for ASCryptStm. This puts an end-of-file (EOF) marker to a security stream.

A callback for ASCryptStm. This resets a security stream, discarding any buffered data. It is called only during encryption (when writing to the stream, not when reading).

A callback for ASCryptStm. This is called bywhen the buffer is empty. It is called only during decryption (when reading from the stream, not when writing).

A callback for ASCryptStm. This is called bywhen the buffer is full. It is called only during encryption (when writing to the stream, not when reading).

A callback for ASCryptStm. It goes back one character in the input stream, undoing a characteroperation. It is called only during decryption (when reading from the stream, not when writing).

An ASStm object cover used for a cryptographic filter's stream callbacks.

Adds a calendar time span to a date. It modifies the date by the length of time provided in the ASCalendarTimeSpan object. There is some ambiguity in a calendar time span; to add an exact time span (for example, 2592000 seconds rather than one month), use ASDateAddTimeSpan().

Adds a time span (an exact number of seconds) to a date. It modifies the date by the length of time provided in the ASTimeSpan object.

Calculates the difference between two ASDate objects and stores the result in the provided ASCalendarTimeSpan object. The result is broken down into years, months, and so on, in the highest denomination possible. For example, a difference of 13 months is reported as 1 year and 1 month.

Reinitializes a date object to the newly-allocated state, as returned by ASDateNew().

Tests whether one date is earlier or later than another.

Copies date and time data from one date object to another.

Releases and destroys a date object.

Creates a new date object containing the same data as an existing date object.

Calculates the exact difference in seconds between two date objects and stores the result in the provided ASTimeSpan object. Ifis earlier than, the result is negative.

Creates a time record that represents the local time represented by the date object. The resulting local time might not account for daylight savings time correctly if the date object has been modified by adding or substracting a time span or calendar time span. It raises an exception if there is not enough memory.

Creates a time string from a date object according to a specified format. If time zone information is available in the date object, the string contains the local time along with the time zone adjustment, if that is supported by the requested format. It raises an exception if there is not enough memory. It is the client's responsibility to release the memory associated with the returned string using ASfree().

Creates a time record that represents the UTC time represented by the date object. It raises an exception if there is not enough memory.

Creates a date object. The newly allocated object reflects the epoch time: Jan 1 1970 00:00:00 UTC. Raises an exception if there is not enough memory for the operation.

Sets a date object's local time offset according to the operating system's current time zone information. Different operating systems handle daylight savings differently. This method causes the date object to always use the same daylight savings time offset that the operating system is currently using, even if the date object is modified.

Initializes a date object from a time record. It raises an exception if the time structure represents an invalid time, such as January 32nd 1999 or Feb 29th 2001. It assumes that the parameters for the day and month in the time record are-based.

Initializes a date object from a time string. It raises an exception if there is not enough memory, if the format is unrecognized, or if the time string is not formatted according to the supplied format.

Sets a date object to the current local time, using the time zone information from the operating system.

Sets a date object to the current UTC time with no time zone information.

Subtracts a calendar time span from a date. It modifies the date by the length of time provided in the ASCalendarTimeSpan object. There is some ambiguity in a calendar time span; to subtract an exact time span (for example, 2592000 seconds rather than one month), use ASDateSubtractTimeSpan().

Subtracts a time span (an exact number of seconds) from a date. It modifies the date by the length of time provided in the ASTimeSpan object.

An opaque object holding information for a particular date and time. All ASDate objects are guaranteed to give accurate representation of UTC time, unadjusted for leap seconds. This is due to the fact that the introduction of leap seconds to the international calendar does not happen according to a well-defined rule. ASDate objects are not guaranteed to represent local time accurately. To be exact, in Mac OS and UNIX, ASDate cannot always determine the prevailing daylight saving rule for the operating system's time zone. See ASDateGetCurrentLocalTime() for further explanation.

Multiplies two matrices.