Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: More Macintosh Toolbox /

Chapter 4 - List Manager / List Manager Reference

List Manager Routines / Accessing and Manipulating Cell Data

LGetCell
You can use the LGetCell procedure to copy a cell's data.
PROCEDURE LGetCell (dataPtr: Ptr; VAR dataLen: Integer; 
                    theCell: Cell; lHandle: ListHandle);
dataPtr
A pointer to the location to which to copy the cell's data.
dataLen
On entry, specifies the maximum number of bytes to copy. On exit, indicates 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.

DESCRIPTION
The LGetCell procedure copies up to dataLen bytes of the data of the cell specified by theCell to the memory location pointed to by dataPtr. 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 LGetCell sets dataLen to the length in bytes of the cell's data.

SPECIAL CONSIDERATIONS
You should not call the LGetCell procedure from within an interrupt, such as in a completion routine or VBL task.

ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for the LGetCell procedure are
Trap macro Selector
_Pack0 $0038