root.c File Reference

VM opcode snippet for retrieving the root node of an XML document. More...

Go to the source code of this file.

Functions
	free_value (drop)
	push_value (vm, make_int(0))

Variables
case	OP_XML_ROOT
	break

Detailed Description

VM opcode snippet for retrieving the root node of an XML document.

Included by vm.c; implements OP_XML_ROOT.

Opcode: OP_XML_ROOT

• Stack effect: pop (int doc_handle) → push (int node_handle | 0)
• Behavior: For a valid document handle, obtains the document's root element and returns a positive node handle. If the document is invalid or has no root element, 0 is pushed.
• Gating: If FUN_WITH_XML2 is disabled, the input is discarded and 0 is pushed.

Notes

• Returned node handles are managed by the XML node registry. They must be released by corresponding XML VM opcodes to avoid leaks.

Example // stack: [ doc_handle ] OP_XML_ROOT // → [ node_handle ] or [ 0 ]

Definition in file root.c.

Function Documentation

free_value()

free_value

(

drop

)

push_value()

push_value	(	vm	,
		make_int(0)	)

Variable Documentation

break

break

Definition at line 50 of file root.c.

OP_XML_ROOT

case OP_XML_ROOT

Definition at line 33 of file root.c.