Malloc

Description

Performs a malloc

usage

malloc size [,ptr] [,oom_msg_ptr] [,fail_value]

• malloc #$0100
• malloc (ptr)
• malloc value
• malloc AY

Note:

• if parameter 'ptr' is present, store resulting AY in ptr &ptr+1
• if parameter 'oom_msg_ptr' is present, emit string pointed by 'oom_msg_ptr' and return if AY is null (ie malloc error)
• 'malloc AY' waits size from AY

Output

A and Y contains the ptr. If A and Y are equal to 0 (NULL), the malloc had failed

Examples

Malloc with direct size

    .include "telestrat.inc"
    .include "../orix-sdk/macros/SDK_memory.mac"

    malloc #$100
    rts

Malloc with size in AY

    .include "telestrat.inc"
    .include "../orix-sdk/macros/SDK_memory.mac"

    lda     #<1000
    ldy     #>1000
    malloc AY
    rts

Call XMALLOC function