errors.c File Reference

#include "serene/rt/errors.h"
#include "serene/rt/context.h"
#include "serene/utils.h"

Include dependency graph for errors.c:

Go to the source code of this file.

Functions
srn_error_t *	srn_errors_make (const srn_context_t *ctx, srn_error_tag_t tag, const char *msg)
	Build an error in ctx's memory, tagged tag and carrying msg.
void *	srn_errors_fail (const srn_context_t *ctx, size_t size, size_t alignment, srn_error_tag_t tag, const char *msg)
	Allocate a size/alignment value in ctx, set its ERROR_HEADER (the first member, srn_error_t *maybe_error) to a fresh error, and return it.

Function Documentation

srn_errors_fail()

void * srn_errors_fail ( const srn_context_t * ctx, size_t size, size_t alignment, srn_error_tag_t tag, const char * msg )

nodiscard

Allocate a size/alignment value in ctx, set its ERROR_HEADER (the first member, srn_error_t *maybe_error) to a fresh error, and return it.

The result is a valid fallible value whose HAS_ERROR is true. Use the FAIL macro, which fills in size/alignment from the target type.

Definition at line 39 of file errors.c.

  {
  // The ERROR_HEADER convention guarantees `srn_error_t *maybe_error` is the
  // first member of any fallible T, so offset 0 of the value is that pointer.
  // Allocate the value and set it to a fresh error; the caller checks it with
  // HAS_ERROR and never reads the other fields of an errored value.
  void *value = srn_allocate(ctx, size, alignment);
  PANIC_IF_NULL(value);
  *(srn_error_t **)value = srn_errors_make(ctx, tag, msg);
  return value;
}

Here is the call graph for this function:

srn_errors_make()

srn_error_t * srn_errors_make	(	const srn_context_t *	ctx,
		srn_error_tag_t	tag,
		const char *	msg )

Build an error in ctx's memory, tagged tag and carrying msg.

Returns the error to attach to a value's maybe_error (or to inspect directly). The ERR macro below is the shorthand for the common call.

Definition at line 31 of file errors.c.

                                                                                             {
  srn_error_t *err = ALLOC(ctx, srn_error_t);
  PANIC_IF_NULL(err);
  err->tag = tag;
  err->msg = (char *)msg;
  return err;
}

Here is the caller graph for this function: