Functions
static DetlefSlice	detlef_slice (const void *data, size_t len)

static DetlefSlice	detlef_cstr (const char *text)

static DetlefNamed	detlef_named (DetlefSlice name, DetlefHandle handle)

static DetlefNamed	detlef_named_cstr (const char *name, DetlefHandle handle)

static DetlefStatus	detlef_execute_cstr (DetlefAccess access, const char source, DetlefHandle *result)

static DetlefStatus	detlef_value_string_cstr (DetlefAccess access, const char text, DetlefHandle *result)

static DetlefStatus	detlef_function_value_string_cstr (DetlefFunctionAccess access, const char text, DetlefHandle *result)

static DetlefStatus	detlef_register_function_cstr (DetlefAccess access, const char name, const DetlefNamed parameters, size_t count, const DetlefNamed variadic, DetlefFunctionCallback callback, void *data)

static DetlefStatus	detlef_register_control_cstr (DetlefAccess access, const char name, DetlefCallback callback, void *data)

static DetlefStatus	detlef_package_function_cstr (DetlefAccess access, DetlefHandle package, const char name, const DetlefNamed parameters, size_t count, const DetlefNamed variadic, DetlefFunctionCallback callback, void *data)

static DetlefStatus	detlef_package_control_cstr (DetlefAccess access, DetlefHandle package, const char name, DetlefCallback callback, void *data)

Detailed Description

Function Documentation

◆ detlef_cstr()

static DetlefSlice detlef_cstr ( const char * text )

inlinestatic

Borrow a NUL-terminated string, excluding its terminator. NULL means an empty slice. Use detlef_slice() for text containing embedded NUL bytes.

Parameters

text	Borrowed NUL-terminated UTF-8 text.

Returns: A borrowed byte slice. No allocation is made.

Definition at line 33 of file detlef_helpers.h.

◆ detlef_execute_cstr()

static DetlefStatus detlef_execute_cstr	(	DetlefAccess *	access,
		const char *	source,
		DetlefHandle *	result
	)

inlinestatic

Execute NUL-terminated source; return the ABI status and an owned result.

Parameters

	access	Borrowed live callback access. Must not be saved or freed.
	source	Borrowed NUL-terminated UTF-8 source.
[out]	result	Receives an owned handle on success. Must be released with the matching handle-release operation unless transferred as a callback result.

Returns: The underlying DETLEF_* status. Input handles are not consumed.

Definition at line 73 of file detlef_helpers.h.

◆ detlef_function_value_string_cstr()

static DetlefStatus detlef_function_value_string_cstr	(	DetlefFunctionAccess *	access,
		const char *	text,
		DetlefHandle *	result
	)

inlinestatic

Create an owned string value through limited Function access.

Parameters

	access	Borrowed live callback access. Must not be saved or freed.
	text	Borrowed NUL-terminated UTF-8 text.
[out]	result	Receives an owned handle on success. Must be released with the matching handle-release operation unless transferred as a callback result.

Returns: The underlying DETLEF_* status. Input handles are not consumed.

Definition at line 104 of file detlef_helpers.h.

◆ detlef_named()

static DetlefNamed detlef_named	(	DetlefSlice	name,
		DetlefHandle	handle
	)

inlinestatic

name is borrowed, handle is copied without retaining it. The consuming ABI call determines whether handle must be a type, TypeRef, or value.

Parameters

name	Borrowed UTF-8 name slice, copied without retaining its storage.
handle	Borrowed handle. Copying it does not retain or consume it.

Returns: A name/handle pair. Neither the name nor the handle is retained.

Definition at line 46 of file detlef_helpers.h.

◆ detlef_named_cstr()

static DetlefNamed detlef_named_cstr	(	const char *	name,
		DetlefHandle	handle
	)

inlinestatic

Borrow a NUL-terminated name and pair it with an unretained handle ID.

Parameters

name	Borrowed NUL-terminated name.
handle	Borrowed handle. Copying it does not retain or consume it.

Returns: A name/handle pair. Neither the name nor the handle is retained.

Definition at line 59 of file detlef_helpers.h.

◆ detlef_package_control_cstr()

static DetlefStatus detlef_package_control_cstr	(	DetlefAccess *	access,
		DetlefHandle	package,
		const char *	name,
		DetlefCallback	callback,
		void *	data
	)

inlinestatic

Add a Control to a package; callback code and data remain host-owned.

Parameters

access	Borrowed live callback access. Must not be saved or freed.
package	Borrowed package-builder handle. Not consumed.
name	Borrowed NUL-terminated name.
callback	Synchronous implementation. Its code and data must outlive registrations.
data	Caller-owned callback data, valid while the registration can run.

Returns: The underlying DETLEF_* status. Input handles are not consumed.

Definition at line 188 of file detlef_helpers.h.

◆ detlef_package_function_cstr()

static DetlefStatus detlef_package_function_cstr	(	DetlefAccess *	access,
		DetlefHandle	package,
		const char *	name,
		const DetlefNamed *	parameters,
		size_t	count,
		const DetlefNamed *	variadic,
		DetlefFunctionCallback	callback,
		void *	data
	)

inlinestatic

Package parameters use TypeRef handles rather than resolved types.

Parameters

access	Borrowed live callback access. Must not be saved or freed.
package	Borrowed package-builder handle. Not consumed.
name	Borrowed NUL-terminated name.
parameters	Borrowed parameter names paired with unresolved TypeRef handles. Handles are not consumed.
count	Number of parameters.
variadic	Optional borrowed variadic parameter; NULL means none.
callback	Synchronous implementation. Its code and data must outlive registrations.
data	Caller-owned callback data, valid while the registration can run.

Returns: The underlying DETLEF_* status. Input handles are not consumed.

Definition at line 167 of file detlef_helpers.h.

◆ detlef_register_control_cstr()

static DetlefStatus detlef_register_control_cstr	(	DetlefAccess *	access,
		const char *	name,
		DetlefCallback	callback,
		void *	data
	)

inlinestatic

Register a Control; callback code and data must outlive the registration.

Parameters

access	Borrowed live callback access. Must not be saved or freed.
name	Borrowed NUL-terminated name.
callback	Synchronous implementation. Its code and data must outlive registrations.
data	Caller-owned callback data, valid while the registration can run.

Returns: The underlying DETLEF_* status. Input handles are not consumed.

Definition at line 143 of file detlef_helpers.h.

◆ detlef_register_function_cstr()

static DetlefStatus detlef_register_function_cstr	(	DetlefAccess *	access,
		const char *	name,
		const DetlefNamed *	parameters,
		size_t	count,
		const DetlefNamed *	variadic,
		DetlefFunctionCallback	callback,
		void *	data
	)

inlinestatic

Parameters use resolved type handles. Callback code and data must outlive their registrations. Function access remains distinct from Control access.

Parameters

access	Borrowed live callback access. Must not be saved or freed.
name	Borrowed NUL-terminated name.
parameters	Borrowed parameter names paired with resolved type descriptors. Handles are not consumed.
count	Number of parameters.
variadic	Optional borrowed variadic parameter; NULL means none.
callback	Synchronous implementation. Its code and data must outlive registrations.
data	Caller-owned callback data, valid while the registration can run.

Returns: The underlying DETLEF_* status. Input handles are not consumed.

Definition at line 125 of file detlef_helpers.h.

◆ detlef_slice()

static DetlefSlice detlef_slice	(	const void *	data,
		size_t	len
	)

inlinestatic

Borrow exactly len bytes, including any embedded NUL bytes. The caller must keep data valid for the consuming call. UTF-8 validation happens in DETLEF.

Parameters

data	Borrowed byte storage, valid for len bytes.
len	Number of supplied bytes.

Returns: A borrowed byte slice. No allocation is made.

Definition at line 20 of file detlef_helpers.h.

◆ detlef_value_string_cstr()

static DetlefStatus detlef_value_string_cstr	(	DetlefAccess *	access,
		const char *	text,
		DetlefHandle *	result
	)

inlinestatic

Create an owned string value from NUL-terminated text.

Parameters

	access	Borrowed live callback access. Must not be saved or freed.
	text	Borrowed NUL-terminated UTF-8 text.
[out]	result	Receives an owned handle on success. Must be released with the matching handle-release operation unless transferred as a callback result.

Returns: The underlying DETLEF_* status. Input handles are not consumed.

Definition at line 89 of file detlef_helpers.h.

Functions

Detailed Description

Function Documentation

◆ detlef_cstr()

◆ detlef_execute_cstr()

◆ detlef_function_value_string_cstr()

◆ detlef_named()

◆ detlef_named_cstr()

◆ detlef_package_control_cstr()

◆ detlef_package_function_cstr()

◆ detlef_register_control_cstr()

◆ detlef_register_function_cstr()

◆ detlef_slice()

◆ detlef_value_string_cstr()