path: root/include/u8c/err.h

/*
	Copyright 2021 Gabriel Jensen

	This file is part of u8c.

	u8c is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

	u8c 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 Affero General Public License for more details.

	You should have received a copy of the GNU Affero General Public License along with u8c.

	If not, see <https://www.gnu.org/licenses/>.
*/
# if !defined(u8c_hdr_err)
# define u8c_hdr_err
# include <stdbool.h>
# include <stddef.h>
# include <uchar.h>
/* Enumerations: */
enum u8c_errtyp {
	u8c_errtyp_badalloc, /* Bad allocation */
	u8c_errtyp_badio,    /* Bad input or output */
	u8c_errtyp_stroor,   /* UTF-32 out of range */
	u8c_errtyp_u8oor,    /* UTF-8 out of range */
	u8c_errtyp_deferr,   /* Default error */
	u8c_errtyp_untermin, /* Unterminated input */
	u8c_errtyp_all,      /* All */
};
/* Type definitions: */
typedef void (* u8c_errhandltyp)(enum u8c_errtyp); /* Error handler type */
/* Structures: */
struct u8c_geterr_tuple {
	char32_t const * err;
	size_t           errsz;
	bool             stat;
};
struct u8c_regerrhandl_tuple {
	bool stat;
};
struct u8c_seterr_tuple {
	bool stat;
};
/* Functions: */
extern struct u8c_geterr_tuple      u8c_geterr(     void);                                                         /* Get error */
extern struct u8c_regerrhandl_tuple u8c_regerrhandl(enum u8c_errtyp typ,u8c_errhandltyp                 errhandl); /* Register error handler */
extern struct u8c_seterr_tuple      u8c_seterr(     enum u8c_errtyp typ,char32_t const * const restrict msg);      /* Set error */
/* Constants & Variables: */
/* Macros: */
# endif