err.c File Reference

The raised-error type: a structured error value the language owns. More...

#include "x-obj.h"
#include "x-type.h"
#include "x-eval-layout.h"
#include "x-type/err.h"

Functions
x_obj_t *	x_type_err_struct (x_obj_t *p_base, x_obj_t *p_obj)
x_obj_t *	x_type_err_register (x_obj_t *p_base, x_obj_t *p_args)

Variables
x_satom_t	x_type_err_name
x_satom_t	x_type_err_struct_prim

Detailed Description

The raised-error type: a structured error value the language owns.

Author

Jon Ruttan (jonru.nosp@m.ttan.nosp@m.@gmai.nosp@m.l.co.nosp@m.m)

Copyright

2026 Jon Ruttan @license MIT No Attribution (MIT-0)

Function Documentation

x_type_err_register()

x_obj_t * x_type_err_register	(	x_obj_t *	p_base,
		x_obj_t *	p_args
	)

Register or retrieve the ERR type on the base context.

Parameters

p_base	x_obj_t* – Base (execution context)
p_args	x_obj_t* – Unused

Returns

x_obj_t* – Registered type object

x_type_err_struct()

x_obj_t * x_type_err_struct	(	x_obj_t *	p_base,
		x_obj_t *	p_obj
	)

Build the ERR type descriptor.

Name only. No make handler: an ERR is not constructed from x-lang – the base owns the single instance and the raise path fills it. No write or display handler either: those stacks are the language's extension point and boot empty on purpose, so an ERR renders as the bounded #<obj:ERR> form until x-lang's err-io.x pushes the prose.

Parameters

p_base	x_obj_t* – Base (execution context)
p_obj	x_obj_t* – Unused

Returns

x_obj_t* – Type descriptor pair list

Variable Documentation

x_type_err_name

x_satom_t x_type_err_name

Initial value:

=
        x_obj_set(x_type_atom_obj, X_OBJ_FLAG_NONE, { .s = (x_char_t *)X_TYPE_ERR_NAME })

x_type_err_struct_prim

x_satom_t x_type_err_struct_prim

Initial value:

=
        x_obj_set(x_type_atom_obj, X_OBJ_FLAG_NONE, { (x_obj_t *)&x_type_err_struct })