Macros

Macros. More...

Macros
#define	EXIT_MAX   255
	Maximum exit code value.
#define	EXIT_ABORT   EXIT_MAX
	Exit code value to indicate program was aborted due to invalid state (e.g.
#define	mt_print_cur_stacktrace(...)
	Prints the current stack trace with an optional message.
#define	mt_print_stacktrace(TRACE, ...)
	Prints a specific stack trace with an optional message.
#define	ensure(check, ...)
	Ensures that a check holds true, aborts the program if not true Will print error if the condition is false.
#define	unreachable(...)
	Marks code as unreachable.
#define	mtdefer   auto DEFER(__LINE__) = mtcore::defer_impl::DeferrerBuilder{} + [&]()
	Defer statement that will mtdefer execution until the scope is left, at which point the code will run Execution will happen regardless of whether there was an error.

Detailed Description

Macros.

Macro Definition Documentation

ensure

#define ensure	(		check,
			... )

Value:

  if (!(check)) {                                                                                                      \
    mt_print_cur_stacktrace("\nCONDITION FAILED!\n\t"                                                                  \
                            "CONDITION: %s\n\t"                                                                        \
                            "MESSAGE: %s\n\t"                                                                          \
                            "WHERE: %s:%d\n\t"                                                                         \
                            "ERRNO: "                                                                                  \
                            "%d\n\tERRNO DESC: %s\n",                                                                  \
                            #check, #__VA_ARGS__, __FILE__, __LINE__, errno, strerror(errno));                         \
    abort();                                                                                                           \
  }

Ensures that a check holds true, aborts the program if not true Will print error if the condition is false.

Parameters

check

The Check to ensure is true

Definition at line 216 of file core/mtcore/core.hpp.

#define ensure(check, ...)                                                                                             \
  if (!(check)) {                                                                                                      \
    mt_print_cur_stacktrace("\nCONDITION FAILED!\n\t"                                                                  \
                            "CONDITION: %s\n\t"                                                                        \
                            "MESSAGE: %s\n\t"                                                                          \
                            "WHERE: %s:%d\n\t"                                                                         \
                            "ERRNO: "                                                                                  \
                            "%d\n\tERRNO DESC: %s\n",                                                                  \
                            #check, #__VA_ARGS__, __FILE__, __LINE__, errno, strerror(errno));                         \
    abort();                                                                                                           \
  }

EXIT_ABORT

#define EXIT_ABORT   EXIT_MAX

Exit code value to indicate program was aborted due to invalid state (e.g.

failed ensure)

Definition at line 134 of file core/mtcore/core.hpp.

EXIT_MAX

#define EXIT_MAX   255

Maximum exit code value.

Definition at line 126 of file core/mtcore/core.hpp.

mt_print_cur_stacktrace

#define mt_print_cur_stacktrace

(

...

)

Value:

  (void) fprintf(stderr, __VA_ARGS__);                                                                                 \
  (void) fflush(stderr);                                                                                               \
  cpptrace::stacktrace::current(1).print(std::cerr);

Prints the current stack trace with an optional message.

Definition at line 146 of file core/mtcore/core.hpp.

#define mt_print_cur_stacktrace(...)                                                                                   \
  (void) fprintf(stderr, __VA_ARGS__);                                                                                 \
  (void) fflush(stderr);                                                                                               \
  cpptrace::stacktrace::current(1).print(std::cerr);

mt_print_stacktrace

#define mt_print_stacktrace	(		TRACE,
			... )

Value:

  (void) fprintf(stderr, __VA_ARGS__);                                                                                 \
  (void) fflush(stderr);                                                                                               \
  (TRACE).print(std::cerr);

Prints a specific stack trace with an optional message.

Definition at line 163 of file core/mtcore/core.hpp.

#define mt_print_stacktrace(TRACE, ...)                                                                                \
  (void) fprintf(stderr, __VA_ARGS__);                                                                                 \
  (void) fflush(stderr);                                                                                               \
  (TRACE).print(std::cerr);

mtdefer

#define mtdefer   auto DEFER(__LINE__) = mtcore::defer_impl::DeferrerBuilder{} + [&]()

Defer statement that will mtdefer execution until the scope is left, at which point the code will run Execution will happen regardless of whether there was an error.

Example Usage:

auto fd = fopen(...);
if (!fd) return -1;
mtdefer { fclose(fd); };

Definition at line 357 of file core/mtcore/core.hpp.

unreachable

#define unreachable

(

...

)

Value:

  mt_print_cur_stacktrace("\nUNREACHABLE!\n\t"                                                                         \
                          "MESSAGE: %s\n\t"                                                                            \
                          "WHERE: %s:%d\n\t"                                                                           \
                          "ERRNO: "                                                                                    \
                          "%d\n\tERRNO DESC: %s\n",                                                                    \
                          #__VA_ARGS__, __FILE__, __LINE__, errno, strerror(errno));                                   \
  __builtin_unreachable();                                                                                             \
  abort();

Marks code as unreachable.

If hit, will crash the program

Definition at line 246 of file core/mtcore/core.hpp.

#define unreachable(...)                                                                                               \
  mt_print_cur_stacktrace("\nUNREACHABLE!\n\t"                                                                         \
                          "MESSAGE: %s\n\t"                                                                            \
                          "WHERE: %s:%d\n\t"                                                                           \
                          "ERRNO: "                                                                                    \
                          "%d\n\tERRNO DESC: %s\n",                                                                    \
                          #__VA_ARGS__, __FILE__, __LINE__, errno, strerror(errno));                                   \
  __builtin_unreachable();                                                                                             \
  abort();