error.h File Reference

Error handling. More...

#include <string>
#include <cstdint>
#include <source_location>

Include dependency graph for error.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	ERRPRAEFIX   "leo"
	Praefix for error messages of second pass.

Enumerations
enum	OpError : std::uint8_t {   _invalid , success , invalidexit , rangecheck ,   stackunderflow , typecheck , unmatchedmark , dictstackunderflow ,   undefinedresult , undefined , invalidfileaccess , undefinedfilename ,   ioerror }
	Operator error code enum. More...
enum	InError : std::uint8_t { cmdline , parsererror , semantics , internal }
	Interpreter error code enum. More...

Functions
void	opErrExit (OpError p_err, const std::string &p_details="", const std::source_location p_location=std::source_location::current())
	Write operator error message to interpreter out file and exit( EC_OPERATOR ).
void	inErrExit (InError p_err, const std::string &p_details="", const std::source_location p_location=std::source_location::current())
	Write interpreter error message to interpreter out file and exit( EC_INTERPRETER / EC_CMDLINE ).
void	panicExit (const char *p_msg1, const char *p_msg2=nullptr)
	Panic exit( EC_PANIC ).

Detailed Description

Error handling.

Copyright

  Leonardus, a minimalist stack-based programming system.
  Copyright (C) 2025  Andreas Muckenschnabel
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program.
If not, see https://www.gnu.org/licenses/.

Enumeration Type Documentation

InError

enum InError : std::uint8_t

Interpreter error code enum.

Enumerator
cmdline	command line usage error
parsererror	explicit or implicit error from pass 1
semantics	infinite nesting of arrays; infinite loop loading values from dictionary;
internal	float formating; context not initialized; counter less than zero; non dictionary object on dictionary stack

OpError

enum OpError : std::uint8_t

Operator error code enum.

Enumerator
_invalid	Represents: initialized but never changed.
success	No operator error.
invalidexit	operator error invalidexit
rangecheck	operator error rangecheck
stackunderflow	operator error stackunderflow
typecheck	operator error typecheck
unmatchedmark	operator error unmatchedmark
dictstackunderflow	operator error dictstackunderflow
undefinedresult	operator error undefinedresult
undefined	operator error undefined
invalidfileaccess	operator error invalidfileaccess
undefinedfilename	operator error undefinedfilename
ioerror	operator error ioerror

Function Documentation

inErrExit()

void inErrExit	(	InError	p_err,
		const std::string &	p_details = "",
		const std::source_location	p_location = std::source_location::current()
	)

Write interpreter error message to interpreter out file and exit( EC_INTERPRETER / EC_CMDLINE ).

Parameters

[in]	p_err	Interpreter error code.
[in]	p_details	Details to add in message output.
[in]	p_location	A paramter to hold std::source_location::current(). Never set explicitly.

opErrExit()

void opErrExit	(	OpError	p_err,
		const std::string &	p_details = "",
		const std::source_location	p_location = std::source_location::current()
	)

Write operator error message to interpreter out file and exit( EC_OPERATOR ).

Parameters

[in]	p_err	Operator error code.
[in]	p_details	Details to add in message output.
[in]	p_location	A paramter to hold std::source_location::current(). Never set explicitly.

panicExit()

void panicExit	(	const char *	p_msg1,
		const char *	p_msg2 = nullptr
	)

Panic exit( EC_PANIC ).

Parameters

[in]	p_msg1	First message.
[in]	p_msg2	Second message. Defaults to nullptr.