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
);
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 Mac OS 8.1 and later when Carbon 1.0.2 or later is present.


© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)