aboutsummaryrefslogtreecommitdiffstats
path: root/libhaiku.h
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2021-03-01 02:12:47 +0100
committerMattias Andrée <maandree@kth.se>2021-03-01 02:12:58 +0100
commiteebadeb4b4ee60dc768afd3036e3a29833ccb51e (patch)
treee20184a304c0ba1160477b644504fbb2e8146319 /libhaiku.h
parentfix build (diff)
downloadlibhaiku-eebadeb4b4ee60dc768afd3036e3a29833ccb51e.tar.gz
libhaiku-eebadeb4b4ee60dc768afd3036e3a29833ccb51e.tar.bz2
libhaiku-eebadeb4b4ee60dc768afd3036e3a29833ccb51e.tar.xz
misc + change license + changed behaviour of libhaiku_perror
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'libhaiku.h')
-rw-r--r--libhaiku.h47
1 files changed, 47 insertions, 0 deletions
diff --git a/libhaiku.h b/libhaiku.h
new file mode 100644
index 0000000..b00523f
--- /dev/null
+++ b/libhaiku.h
@@ -0,0 +1,47 @@
+/* See LICENSE file for copyright and license details. */
+#ifndef LIBHAIKU_H
+#define LIBHAIKU_H
+
+#include <errno.h>
+
+/**
+ * Get a random generic poetic error message
+ *
+ * @return A random generic poetic error message
+ */
+const char *libhaiku_generic(void);
+
+/**
+ * Get a poetic error message
+ *
+ * @param errnum `errno` value that the error message shall be selected for
+ * @param genericp Unless `NULL`, will be set to 1 if the function didn't have
+ * any haikus specific the the specified error, and had to
+ * return a generic haiku, and to 0 otherwise
+ * @return A poetic error message
+ */
+const char *libhaiku_strerror(int, int *);
+
+/**
+ * Print a poetic error message
+ *
+ * @param prefix Unless `NULL` or empty, each line will be prefixed
+ * by the specified string followed by a colon and a space
+ * @param errnum `errno` value that the error message shall be selected for;
+ * if negative, a generic error message is printed
+ */
+void libhaiku_perror2(const char *, int);
+
+/**
+ * Print a poetic error message
+ *
+ * @param prefix Unless `NULL` or empty, each line will be prefixed
+ * by the specified string followed by a colon and a space
+ */
+inline void
+libhaiku_perror(const char *_libhaiku_prefix)
+{
+ libhaiku_perror2(_libhaiku_prefix, errno);
+}
+
+#endif