diff options
Diffstat (limited to '')
| -rw-r--r-- | include/slibc-error.h | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/include/slibc-error.h b/include/slibc-error.h index 66d1e50..7e1bca2 100644 --- a/include/slibc-error.h +++ b/include/slibc-error.h @@ -77,6 +77,8 @@ * ``` * * This is a slibc extension. + * + * @since Always. */ #define FAILABLE_CALL(expression) \ ({ typeof(expression) __slibc_r = (expression); *__slibc_error_line() = __LINE__; __slibc_r; }) @@ -123,6 +125,8 @@ * that was the line that failed, if `condition` * evaluates to non-zero. * @return 1 if `condition` evaluates to non-zero, 0 otherwise. + * + * @since Always. */ #define FAILURE_CHECK(condition, offset) \ ((condition) ? (*__slibc_error_line() = (__LINE__ - (offset)), 1) : 0) @@ -168,6 +172,8 @@ * to describe what action failed. If the first argument is * `NULL`, this is not printed and only the location of the * error and `errno` is used to describe the error. + * + * @since Always. */ #define PRINT_FAILURE(...) \ (PRINT_CUSTOM_FAILURE(errno, NULL, __VA_ARGS__)) @@ -191,6 +197,8 @@ * to describe what action failed. If the first argument is * `NULL`, this is not printed and only the location of the * error and `error_string` is used to describe the error. + * + * @since Always. */ #define PRINT_CUSTOM_FAILURE(error_code, error_string, ...) \ (slibc_perror(NULL, __FILE__, *__slibc_error_line(), __func__, &(error_code), error_string, __VA_ARGS__)) @@ -198,6 +206,8 @@ /** * Helper function to keep track of the line of origin, in a * thread-safe manner, without requiring new revisions of C. + * + * @since Always. */ int* __slibc_error_line(void) __GCC_ONLY(__attribute__((__const__))); /* TODO not implemented */ @@ -222,6 +232,8 @@ int* __slibc_error_line(void) __GCC_ONLY(__attribute__((__const__))); /* TODO no * @param format Formatting-string for a description of the action that failed. `NULL` if * no description other than the location and `error_string` should be printed. * @param ... Formatting-arguments for `format`. + * + * @since Always. */ void slibc_perror(const char*, const char*, int, const char*, int*, const char*, const char*, ...) __GCC_ONLY(__attribute__((__nonnull__(2, 4), __format__(__slibc_printf__, 7, 8)))); |