revert: revert the delete of std::stacktrace in rust panic.

- i revert previous changes because currently code have not been compiled in clang.

src/CMakeLists.txt

@@ -157,6 +157,15 @@ PUBLIC
     $<$<CXX_COMPILER_ID:MSVC>:/Zc:__cplusplus>
 )
 
+# Fix GCC std::stacktrace link error
+if (CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
+    if (CMAKE_CXX_COMPILER_VERSION VERSION_GREATER_EQUAL 14)
+        target_link_libraries(YYCCommonplace PRIVATE stdc++exp)
+    else ()
+        target_link_libraries(YYCCommonplace PRIVATE stdc++_libbacktrace)
+    endif ()
+endif ()
+
 # Install binary and headers
 install(TARGETS YYCCommonplace
     EXPORT YYCCommonplaceTargets

src/yycc/carton/ironpad.cpp

@@ -27,6 +27,7 @@
 #define REINTERPRET ::yycc::string::reinterpret
 #define WINFCT ::yycc::windows::winfct
 #define FOPEN ::yycc::patch::fopen
+
 using namespace std::literals::string_view_literals;
 
 namespace yycc::carton::ironpad {

src/yycc/patch/format.hpp

@@ -19,9 +19,6 @@
 
 namespace yycc::patch::format {
 
-    // TODO: order all use of std::format redirect to this function.
-    // TODO: all use of OP::printf should also switch to this function if possible.
-
     template<class... Args>
     std::string format(std::format_string<Args...> fmt, Args&&... args) {
         return std::vformat(fmt.get(), std::make_format_args(args...));

src/yycc/rust/panic.cpp

@@ -4,6 +4,7 @@
 #include <cstdlib>
 #include <iomanip>
 #include <iostream>
+#include <stacktrace>
 
 #define TERMCOLOR ::yycc::carton::termcolor
 
@@ -11,14 +12,7 @@ using namespace yycc::patch::stream;
 
 namespace yycc::rust::panic {
 
-    // TODO:
-    // I sadly remove the stacktrace feature for panic function.
-    // Because in GCC, it has link error (can be fixed by extra link option).
-    // In Clang, it even lack the whole header file.
-    // It seems that STL providers are not ready for this feature. So I decide remove it entirely.
-    // Once every STL probiders have ready for this, I will add it back.
-
-    void panic(const char* file, int line, const std::string_view& msg) {
+    void panic(const char* file, int line, const std::u8string_view& msg) {
         // Output message in stderr.
         auto& dst = std::cerr;
 
@@ -29,6 +23,9 @@ namespace yycc::rust::panic {
         dst << "program paniked at " << std::quoted(file) << ":Ln" << line << std::endl;
         // User custom message
         dst << "note: " << msg << std::endl;
+        // Stacktrace message if we support it.
+        dst << "stacktrace: " << std::endl;
+        dst << std::stacktrace::current() << std::endl;
         // Restore color
         dst << TERMCOLOR::reset();
 

src/yycc/rust/panic.hpp

@@ -1,4 +1,5 @@
 #pragma once
+#include "../patch/format.hpp"
 #include <string_view>
 #include <format>
 
@@ -22,19 +23,15 @@
  */
 namespace yycc::rust::panic {
 
-    /**
-     * @brief Immediately crashes the entire program like Rust's \c panic! macro.
-     * @details The macro parameter is the additional message to display.
-     */
-#define RS_PANIC(msg) ::yycc::rust::panic::panic(__FILE__, __LINE__, (msg))
-
     /**
      * @brief Immediately crashes the entire program like Rust's \c panic! macro.
      * @details
      * The macro parameters are the message to format and its arguments, following \c std::format syntax.
      * This macro essentially calls \c std::format internally.
+     * However, this format function is specially modified that it can accept UTF8 format string and UTF8 string argument.
+     * More preciously, it is "format" in \c yycc::patch::format namespace.
      */
-#define RS_PANICF(msg, ...) RS_PANIC(std::format(msg __VA_OPT__(,) __VA_ARGS__))
+#define RS_PANIC(msg, ...) ::yycc::rust::panic::panic(__FILE__, __LINE__, ::yycc::patch::format::format(msg __VA_OPT__(, ) __VA_ARGS__))
 
     /**
      * @brief Immediately crashes the entire program like Rust's \c panic! macro.
@@ -45,6 +42,6 @@ namespace yycc::rust::panic {
      * @param[in] line Line number in source file where panic occurred. Usually filled by macros.
      * @param[in] msg Message to display during panic.
      */
-    [[noreturn]] void panic(const char* file, int line, const std::string_view& msg);
+    [[noreturn]] void panic(const char* file, int line, const std::u8string_view& msg);
 
 } // namespace yycc::rust::panic