Important: The information in this document is obsolete and should not be used for new development.
LGetCell
You can use theLGetCell
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
TheLGetCell
procedure copies up todataLen
bytes of the data of the cell specified bytheCell
to the memory location pointed to bydataPtr
. If the cell data is longer thandataLen
, onlydataLen
bytes are copied and thedataLen
parameter is unchanged. If the cell data is shorter thandataLen
, thenLGetCell
setsdataLen
to the length in bytes of the cell's data.SPECIAL CONSIDERATIONS
You should not call theLGetCell
procedure from within an interrupt, such as in a completion routine or VBL task.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theLGetCell
procedure are
Trap macro Selector _Pack0 $0038