add err.h + add _SLIBC_SUPPRESS_WARNINGS

Signed-off-by: Mattias Andrée <maandree@operamail.com>

3 files changed, 263 insertions, 0 deletions

diff --git a/include/err.h b/include/err.h
new file mode 100644
index 0000000..9eb01f3
--- /dev/null
+++ b/include/err.h
@@ -0,0 +1,119 @@
+/**
+ * slibc — Yet another C library
+ * Copyright © 2015  Mattias Andrée (maandree@member.fsf.org)
+ * 
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+#ifndef _ERR_H
+#define _ERR_H
+#include <slibc/version.h>
+
+#ifndef _SLIBC_SUPPRESS_WARNINGS
+# warning "Please consider not using <err.h>."
+#endif
+
+
+#include <slibc/features.h>
+#include <stdarg.h>
+
+
+
+/**
+ * Print a warning to stderr, followed by a description
+ * of the value of `errno`.
+ * 
+ * @param  format  Formatting-string for the warning.
+ * @param  ...     Formatting-arguments.
+ */
+void warn(const char* format, ...)
+  __GCC_ONLY(__attribute__((format(printf, 1, 2))));
+
+/**
+ * Print a warning to stderr, followed by a description
+ * of the value of `errno`.
+ * 
+ * @param  format  Formatting-string for the warning.
+ * @param  args    Formatting-arguments.
+ */
+void vwarn(const char* format, va_list args)
+  __GCC_ONLY(__attribute__((format(printf, 1, 2))));
+
+/**
+ * Print a warning to stderr, but do not print a
+ * description of the value of `errno`.
+ * 
+ * @param  format  Formatting-string for the warning.
+ * @param  ...     Formatting-arguments.
+ */
+void warnx(const char* format, ...)
+  __GCC_ONLY(__attribute__((format(printf, 1, 2))));
+
+/**
+ * Print a warning to stderr, but do not print a
+ * description of the value of `errno`.
+ * 
+ * @param  format  Formatting-string for the warning.
+ * @param  args    Formatting-arguments.
+ */
+void vwarnx(const char* format, va_list args)
+  __GCC_ONLY(__attribute__((format(printf, 1, 2))));
+
+/**
+ * Print an error message to stderr, followed by a
+ * description of the value of `errno`. Then exit the process.
+ * 
+ * @parma  status  The exit status the process should have.
+ * @param  format  Formatting-string for the warning.
+ * @param  ...     Formatting-arguments.
+ */
+void err(int status, const char* format, ...)
+  __noreturn __GCC_ONLY(__attribute__((format(printf, 2, 3))));
+
+/**
+ * Print an error message to stderr, followed by a
+ * description of the value of `errno`. Then exit the process.
+ * 
+ * @parma  status  The exit status the process should have.
+ * @param  format  Formatting-string for the warning.
+ * @param  args    Formatting-arguments.
+ */
+void verr(int status, const char* format, va_list args)
+  __noreturn __GCC_ONLY(__attribute__((format(printf, 2, 3))));
+
+/**
+ * Print an error message to stderr, but do not print a
+ * description of the value of `errno`. Then exit the process.
+ * 
+ * @parma  status  The exit status the process should have.
+ * @param  format  Formatting-string for the warning.
+ * @param  ...     Formatting-arguments.
+ */
+void errx(int status, const char* format, ...)
+  __noreturn __GCC_ONLY(__attribute__((format(printf, 2, 3))));
+
+/**
+ * Print an error message to stderr, but do not print a
+ * description of the value of `errno`. Then exit the process.
+ * 
+ * @parma  status  The exit status the process should have.
+ * @param  format  Formatting-string for the warning.
+ * @param  args    Formatting-arguments.
+ */
+void verrx(int status, const char* format, va_list args)
+  __noreturn __GCC_ONLY(__attribute__((format(printf, 2, 3))));
+
+
+
+#endif
+
diff --git a/include/iso646.h b/include/iso646.h
index 20d2b5a..557b0a8 100644
--- a/include/iso646.h
+++ b/include/iso646.h
@@ -19,7 +19,9 @@
 #define _ISO646_H
 #include <slibc/version.h>
 
+#ifndef _SLIBC_SUPPRESS_WARNINGS
 # warning "Please consider not using <iso646.h>, is really not good for readability."
+#endif
 
 
 
diff --git a/src/err.c b/src/err.c
new file mode 100644
index 0000000..c0e2e3f
--- /dev/null
+++ b/src/err.c
@@ -0,0 +1,142 @@
+/**
+ * slibc — Yet another C library
+ * Copyright © 2015  Mattias Andrée (maandree@member.fsf.org)
+ * 
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+#include <err.h>
+#include <error.h>
+#include <errno.h>
+
+
+
+/**
+ * Print a warning to stderr, followed by a description
+ * of the value of `errno`.
+ * 
+ * @param  format  Formatting-string for the warning.
+ * @param  ...     Formatting-arguments.
+ */
+void warn(const char* format, ...)
+{
+  va_list args;
+  va_start(args, format);
+  vwarn(format, args);
+  va_end(args);
+}
+
+
+/**
+ * Print a warning to stderr, followed by a description
+ * of the value of `errno`.
+ * 
+ * @param  format  Formatting-string for the warning.
+ * @param  args    Formatting-arguments.
+ */
+void vwarn(const char* format, va_list args)
+{
+  verror(0, errno, format, args);
+}
+
+
+/**
+ * Print a warning to stderr, but do not print a
+ * description of the value of `errno`.
+ * 
+ * @param  format  Formatting-string for the warning.
+ * @param  ...     Formatting-arguments.
+ */
+void warnx(const char* format, ...)
+{
+  va_list args;
+  va_start(args, format);
+  vwarnx(format, args);
+  va_end(args);
+}
+
+
+/**
+ * Print a warning to stderr, but do not print a
+ * description of the value of `errno`.
+ * 
+ * @param  format  Formatting-string for the warning.
+ * @param  args    Formatting-arguments.
+ */
+void vwarnx(const char* format, va_list args)
+{
+  verror(0, 0, format, args);
+}
+
+
+/**
+ * Print an error message to stderr, followed by a
+ * description of the value of `errno`. Then exit the process.
+ * 
+ * @parma  status  The exit status the process should have.
+ * @param  format  Formatting-string for the warning.
+ * @param  ...     Formatting-arguments.
+ */
+void err(int status, const char* format, ...)
+{
+  va_list args;
+  va_start(args, format);
+  verr(status, format, args);
+  va_end(args);
+}
+
+
+/**
+ * Print an error message to stderr, followed by a
+ * description of the value of `errno`. Then exit the process.
+ * 
+ * @parma  status  The exit status the process should have.
+ * @param  format  Formatting-string for the warning.
+ * @param  args    Formatting-arguments.
+ */
+void verr(int status, const char* format, va_list args)
+{
+  verror(status, errno, format, args);
+}
+
+
+/**
+ * Print an error message to stderr, but do not print a
+ * description of the value of `errno`. Then exit the process.
+ * 
+ * @parma  status  The exit status the process should have.
+ * @param  format  Formatting-string for the warning.
+ * @param  ...     Formatting-arguments.
+ */
+void errx(int status, const char* format, ...)
+{
+  va_list args;
+  va_start(args, format);
+  verrx(status, format, args);
+  va_end(args);
+}
+
+
+/**
+ * Print an error message to stderr, but do not print a
+ * description of the value of `errno`. Then exit the process.
+ * 
+ * @parma  status  The exit status the process should have.
+ * @param  format  Formatting-string for the warning.
+ * @param  args    Formatting-arguments.
+ */
+void verrx(int status, const char* format, va_list args)
+{
+  verror(status, 0, format, args);
+}
+