Carbon


LGetCell

Header: Lists.h Carbon status: Supported

Copies a cell’s data.

void LGetCell (
    void *dataPtr, 
    SInt16 *dataLen, 
    Cell theCell, 
    ListHandle lHandle
);
Parameter descriptions
dataPtr

A pointer to the location to which to copy the cell’s data.

dataLen

On input, a pointer to the maximum number of bytes to copy. On return, a pointer to the number of bytes actually copied.

theCell

The cell whose data is to be copied.

lHandle

The list containing the cell specified by the parameter theCell.

DISCUSSION

If the cell data is longer than dataLen, only dataLen bytes are copied and the dataLen parameter is unchanged. If the cell data is shorter than dataLen, then the function sets dataLen to the length in bytes of the cell’s data.

SPECIAL CONSIDERATIONS

This function is contained in a resource of resource type 'PACK'. Calling it could result in the loading of the package resource and the allocation of memory. Thus, your application should not call this function from within an interrupt, such as in a completion function or VBL task.

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)