aboutsummaryrefslogtreecommitdiffstats
path: root/libgamma-error.hh
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2022-07-21 18:11:44 +0200
committerMattias Andrée <maandree@kth.se>2022-07-21 18:11:44 +0200
commit1fdaa473e0b54d2d8819da0a477dbaeed913e76f (patch)
tree1a7476ada7525420ac2542187aa8a95036fc63f1 /libgamma-error.hh
parentChange license, improve makefile, remove dist/ (diff)
downloadlibgammamm-1fdaa473e0b54d2d8819da0a477dbaeed913e76f.tar.gz
libgammamm-1fdaa473e0b54d2d8819da0a477dbaeed913e76f.tar.bz2
libgammamm-1fdaa473e0b54d2d8819da0a477dbaeed913e76f.tar.xz
Change style1.0.2
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to '')
-rw-r--r--libgamma-error.hh304
1 files changed, 149 insertions, 155 deletions
diff --git a/libgamma-error.hh b/libgamma-error.hh
index 5f65e86..ec252c7 100644
--- a/libgamma-error.hh
+++ b/libgamma-error.hh
@@ -2,176 +2,170 @@
#ifndef LIBGAMMA_ERROR_HH
#define LIBGAMMA_ERROR_HH
-
-#include <string>
#include <exception>
+#include <string>
#include "libgamma-native.hh"
-#ifndef __GNUC__
-# define __attribute__(X) /* emtpy */
+#if defined(__GNUC__)
+# define LIBGAMMAMM_PURE__ __attribute__((__pure__))
+#else
+# define LIBGAMMAMM_PURE__
#endif
-#ifndef __WIN32__
-# define libgamma_gid_t gid_t
+#if !defined(__WIN32__)
+# define libgamma_gid_t gid_t
#else
-# define libgamma_gid_t short
+# define libgamma_gid_t short
#endif
-
namespace libgamma
{
- /**
- * Class for `group_gid`.
- */
- class GroupGid;
-
- /**
- * Class for `group_name`.
- */
- class GroupName;
-
-
- /**
- * 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);
-
- /**
- * 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);
-
- /**
- * 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) __attribute__((pure));
-
-
- /**
- * Class for `group_gid`.
- */
- class GroupGid
- {
- public:
- const GroupGid& operator =(const libgamma_gid_t& value) const
- {
- libgamma_group_gid = value;
- return *this;
- }
-
- operator libgamma_gid_t() const
- {
- return libgamma_group_gid;
- }
- };
-
- /**
- * Group that the user needs to be a member of if
- * `LIBGAMMA_DEVICE_REQUIRE_GROUP` is returned.
- */
- extern GroupGid group_gid;
-
-
- /**
- * Class for `group_name`.
- */
- class GroupName
- {
- public:
- const GroupName& operator =(const char* value) const
- {
- libgamma_group_name = value;
- return *this;
- }
-
- operator const char*() const
- {
- return libgamma_group_name;
- }
- };
-
- /**
- * 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.
- */
- extern GroupName group_name;
-
-
- /**
- * Libgamma exception class.
- */
- class LibgammaException : public std::exception
- {
- public:
- /**
- * Constructor.
- *
- * @param error_code The error code.
- */
- LibgammaException(int error_code) throw();
-
- /**
- * Destructor.
- */
- virtual ~LibgammaException() throw();
-
- /**
- * Get the error as a string.
- */
- virtual const char* what() const throw();
-
- /**
- * The error code.
- */
- int error_code;
-
- };
-
-
- /**
- * 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);
-
-}
+ /**
+ * Class for `group_gid`
+ */
+ class GroupGid;
+ /**
+ * Class for `group_name`
+ */
+ class GroupName;
-#ifndef __GNUC__
-# undef __attribute__
-#endif
-#endif
+ /**
+ * 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);
+
+ /**
+ * 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);
+
+ /**
+ * 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
+ */
+ LIBGAMMAMM_PURE__ int value_of_error(const std::string *name);
+
+
+ /**
+ * Class for `group_gid`
+ */
+ class GroupGid
+ {
+ public:
+ const GroupGid &
+ operator =(const libgamma_gid_t &value) const
+ {
+ libgamma_group_gid = value;
+ return *this;
+ }
+
+ operator libgamma_gid_t() const
+ {
+ return libgamma_group_gid;
+ }
+ };
+
+ /**
+ * Group that the user needs to be a member of if
+ * `LIBGAMMA_DEVICE_REQUIRE_GROUP` is returned
+ */
+ extern GroupGid group_gid;
+
+ /**
+ * Class for `group_name`
+ */
+ class GroupName
+ {
+ public:
+ const GroupName &
+ operator =(const char *value) const
+ {
+ libgamma_group_name = value;
+ return *this;
+ }
+
+ operator const char *() const
+ {
+ return libgamma_group_name;
+ }
+ };
+
+ /**
+ * 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
+ */
+ extern GroupName group_name;
+
+
+ /**
+ * Libgamma exception class
+ */
+ class LibgammaException : public std::exception
+ {
+ public:
+ /**
+ * Constructor
+ *
+ * @param error_code The error code
+ */
+ LibgammaException(int error_code) throw();
+
+ /**
+ * Destructor
+ */
+ virtual ~LibgammaException() throw();
+
+ /**
+ * Get the error as a string
+ */
+ virtual const char *what() const throw();
+
+ /**
+ * The error code
+ */
+ int error_code;
+ };
+
+
+ /**
+ * 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);
+}
+
+#endif