hello_args_return.c File Reference

Implements the OP_RUST_HELLO_ARGS_RETURN opcode (conditional build). More...

Go to the source code of this file.

Functions
	free_value (vmsg)
	vm_raise_error (vm, "RUST_HELLO_ARGS_RETURN requires FUN_WITH_RUST=ON at build time")
	push_value (vm, make_nil())

Variables
case	OP_RUST_HELLO_ARGS_RETURN
	break

Detailed Description

Implements the OP_RUST_HELLO_ARGS_RETURN opcode (conditional build).

Demonstrates round-tripping a string value through Rust. Pops a value, converts it to a C string, passes it to Rust, and pushes back the string returned by Rust. If Rust returns NULL or Rust support is disabled, Nil is pushed.

Definition in file hello_args_return.c.

Function Documentation

free_value()

free_value

(

vmsg

)

push_value()

push_value	(	vm	,
		make_nil()	)

vm_raise_error()

vm_raise_error

(

vm

)

Variable Documentation

break

break

Definition at line 66 of file hello_args_return.c.

OP_RUST_HELLO_ARGS_RETURN

case OP_RUST_HELLO_ARGS_RETURN

OP_RUST_HELLO_ARGS_RETURN: (msg:any) -> string | Nil

Behavior (FUN_WITH_RUST=ON):

• Pops one value from the stack and converts it to a newly allocated C string via value_to_string_alloc().
• Calls fun_rust_echo_string(msg) which returns an owned C string pointer that must be released via fun_rust_string_free().
• Pushes the returned string as VAL_STRING on success; pushes Nil if Rust returns NULL.

Behavior (FUN_WITH_RUST=OFF):

• Pops and frees one value to preserve stack discipline.
• Raises a runtime error indicating missing Rust support.
• Pushes Nil.

Definition at line 36 of file hello_args_return.c.