diff options
| -rw-r--r-- | include/err.h | 119 | ||||
| -rw-r--r-- | include/iso646.h | 2 | ||||
| -rw-r--r-- | src/err.c | 142 |
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); +} + |