diff options
author | Mattias Andrée <maandree@kth.se> | 2022-07-21 17:24:10 +0200 |
---|---|---|
committer | Mattias Andrée <maandree@kth.se> | 2022-07-21 17:24:10 +0200 |
commit | 8602df60ad189c73464bbf6b6918b538da43a22e (patch) | |
tree | 10c108bf8ae4df13210d6c7bd3b2f393b6b9f612 /libgamma-error.cc | |
parent | update dist (diff) | |
download | libgammamm-8602df60ad189c73464bbf6b6918b538da43a22e.tar.gz libgammamm-8602df60ad189c73464bbf6b6918b538da43a22e.tar.bz2 libgammamm-8602df60ad189c73464bbf6b6918b538da43a22e.tar.xz |
Change license, improve makefile, remove dist/
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'libgamma-error.cc')
-rw-r--r-- | libgamma-error.cc | 134 |
1 files changed, 134 insertions, 0 deletions
diff --git a/libgamma-error.cc b/libgamma-error.cc new file mode 100644 index 0000000..db66bbe --- /dev/null +++ b/libgamma-error.cc @@ -0,0 +1,134 @@ +/* See LICENSE file for copyright and license details. */ +#include "libgamma-error.hh" + +#include <iostream> +#include <cstring> + + +namespace libgamma +{ + /** + * Prints an error to stderr in a `perror` fashion, + * however this function will not translate the `libgamma` + * errors into human-readable strings, it will simply + * print the name of the error. If the value `error_code` + * is the value of `LIBGAMMA_ERRNO_SET`, `perror` will be + * used to print the current error stored in `errno`. + * If `error_code` is non-negative (an `errno` value`), that + * value will be stored in `errno` and `perror` will be + * used to print it. Additionally, if the `error_code` is + * the value of `LIBGAMMA_DEVICE_REQUIRE_GROUP` the + * required group will be printed with its numerical value + * and, if known, its name. + * + * @param name The text to add at the beginning. + * @param value The error code, may be an `errno` value. + */ + void perror(const std::string name, int error_code) + { + libgamma_perror(name.c_str(), error_code); + } + + /** + * Returns the name of the definition associated with a `nullptr` error code. + * + * @param value The error code. + * @return The name of the definition associated with the error code, + * `nullptr` if the error code does not exist. + */ + std::string* name_of_error(int value) + { + const char* cstr = libgamma_name_of_error(value); + if (cstr == nullptr) + return nullptr; + return new std::string(cstr); + } + + /** + * Return the value of a `libgamma` error definition refered to by name. + * + * @param name The name of the definition associated with the error code. + * @return The error code, zero if the name is `nullptr` + * or does not refer to a `libgamma` error. + */ + int value_of_error(const std::string* name) + { + const char* cstr = nullptr; + if (name != nullptr) + cstr = name->c_str(); + return libgamma_value_of_error(cstr); + } + + +#ifdef __GNUC__ +# pragma GCC diagnostic push +# pragma GCC diagnostic ignored "-Wshadow" +#endif + + /** + * Constructor. + * + * @param error_code The error code. + */ + LibgammaException::LibgammaException(int error_code) throw() : + error_code(error_code) + { + /* Do nothing. */ + } + + /** + * Destructor. + */ + LibgammaException::~LibgammaException() throw() + { + /* Do nothing. */ + } + + /** + * Get the error as a string. + */ + const char* LibgammaException::what() const throw() + { + if (this->error_code < 0) + return libgamma_name_of_error(this->error_code); + else + return strerror(this->error_code); + } + +#ifdef __GNUC__ +# pragma GCC diagnostic pop +#endif + + + /** + * Create an exception from an error code + * that may come from `errno.h` or be a + * `libgamma` error code. + * + * @param error_code The error code. + * @return The error object. + */ + LibgammaException create_error(int error_code) + { + if (error_code == LIBGAMMA_ERRNO_SET) + error_code = errno; + return LibgammaException(error_code); + } + + + /** + * Group that the user needs to be a member of if + * `LIBGAMMA_DEVICE_REQUIRE_GROUP` is returned. + */ + GroupGid group_gid; + + /** + * Group that the user needs to be a member of if + * `LIBGAMMA_DEVICE_REQUIRE_GROUP` is returned, + * `nullptr` if the name of the group + * `libgamma::group_gid` cannot be determined. + */ + GroupName group_name; + +} + |