Add assertion failure handling facilities

[apcountryman]

Add assertion failure handling facilities.

• [x] configuration/analyze-clang-tidy/CMakeLists.txt (update)
• [x] configuration/buiild-all-development_environment-test-automated/CMakeLists.txt (update)
• [x] configuration/build-arm_cortex_m0plus-hardware/CMakeLists.txt (update)
• [x] configuration/build-microchip_megaavr0-hardware-atmega4809/CMakeLists.txt (update)
• [x] configuration/build-microchip_megaavr-hardware-atmega2560/CMakeLists.txt (update)
• [x] configuration/build-microchip_megaavr-hardware-atmega328p/CMakeLists.txt (update)
• [x] configuration/build-microchip_sam_d21da1-hardware-atsamd21g18a/CMakeLists.txt (update)
• [x] CMakeLists.txt (update)
  • [x] Add MICROLIBRARY_SUPPRESS_ASSERTION_FAILURE_LOCATION_INFORMATION general project configuration option
  • [x] Add MICROLIBRARY_SUPPRESS_ASSERTION_FAILURE_LOCATION_INFORMATION general project configuration option validation
  • [x] Add -ffile-prefix-map to compilation options
• [x] libraries/microlibrary/ANY/ANY/CMakeLists.txt (update)
  • [x] Define MICROLIBRARY_SUPPRESS_ASSERTION_FAILURE_LOCATION_INFORMATION to be 0/1 based on the value of MICROLIBRARY_SUPPRESS_ASSERTION_FAILURE_LOCATION_INFORMATION
• [x] libraries/microlibrary/ANY/ANY/include/microlibrary/assertion_failure.h/libraries/microlibrary/ANY/ANY/source/microlibrary/assertion_failure.cc (add)
  • [x] Add ::microlibrary::Assertion_Failure_Logger type alias
  • [x] Add ::microlibrary::Assertion_Failure_Logger_Pointer type alias
  • [x] Add ::microlibrary::register_assertion_failure_logger() function
  • [x] Add ::microlibrary::handle_assertion_failure() function
  • [x] Add ::microlibrary::trap_assertion_failure() function
• [x] docs/error_handling.md (update)
• [x] docs/usage.md (update)
• [x] The ::microlibrary::Assertion_Failure_Logger type alias should be an alias for void ( void * data, ROM::String file, int line, Error_Code const & error ) noexcept if MICROLIBRARY_SUPPRESS_ASSERTION_FAILURE_LOCATION_INFORMATION is false
• [x] The ::microlibrary::Assertion_Failure_Logger type alias should be an alias for void ( Error_Code const & error ) noexcept if MICROLIBRARY_SUPPRESS_ASSERTION_FAILURE_LOCATION_INFORMATION is true
• [x] The ::microlibrary::Assertion_Failure_Logger_Pointer type alias should be an alias for std::add_pointer_t<Assertion_Failure_Logger>
• [x] The ::microlibrary::register_assertion_failure_logger() function should have the following signature:

  void register_assertion_failure_logger( Assertion_Failure_Logger_Pointer assertion_failure_logger, void * data ) noexcept;

• [x] The ::microlibrary::handle_assertion_failure() function should have the following signature:

  [[noreturn]] handle_assertion_failure() noexcept;

• [x] The ::microlibrary::handle_assertion_failure() function should be defined as a weak alias for its default implementation
• [x] The ::microlibrary::trap_assertion_failure should have the following signature if MICROLIBRARY_SUPPRESS_ASSERTION_FAILURE_LOCATION_INFORMATION is false:

  [[noreturn]] void trap_assertion_failure( ROM::String file, int line, Error_Code const & error ) noexcept;

• [x] The ::microlibrary::trap_assertion_failure should have the following signature if MICROLIBRARY_SUPPRESS_ASSERTION_FAILURE_LOCATION_INFORMATION is true:

  [[noreturn]] void trap_assertion_failure( Error_Code const & error ) noexcept;

[apcountryman]

Abandoning in favor of a much simpler approach (#141).