free.c File Reference

VM opcode snippet for releasing an INI handle (OP_INI_FREE). More...

Go to the source code of this file.

Detailed Description

VM opcode snippet for releasing an INI handle (OP_INI_FREE).

This file is included into the main VM dispatch switch in vm.c. It is only compiled when FUN_WITH_INI is enabled and iniparser headers are available.

Opcode: OP_INI_FREE Stack: [handle:int] -> [ok:int]

Behavior

• Pops an integer handle referring to an INI dictionary previously returned by OP_INI_LOAD.
• Attempts to close the underlying dictionary and free the registry slot.
• Pushes 1 on success, 0 if the handle was invalid or already freed.

Errors

• No VM error is thrown for invalid handles; the opcode simply returns 0.

See also

• ini_alloc_handle(), ini_free_handle() in src/vm/ini/handles.c

Definition in file free.c.