Carbon


AECountItems

Header: AEDataModel.h Carbon status: Supported

Counts the number of descriptor records in a descriptor list.

OSErr AECountItems (
    const AEDescList *theAEDescList, 
    SInt32 *theCount
);
Parameter descriptions
theAEDescList

A pointer to the descriptor list to count.

theCount

A pointer to a count variable. On return, the number of descriptor records in the specified descriptor list.

function result

A result code.

DISCUSSION

Your application typically counts the descriptor records in a descriptor list when it is extracting data from an Apple event. You can use the functions in “Getting Items From Descriptor Lists” to get an individual record from a descriptor list or to iterate through the records.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)