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