add examples

Author: PacificViking

examples/CMakeLists.txt

@@ -0,0 +1,21 @@
+cmake_minimum_required(VERSION 3.23)
+
+project(ystdlib-examples)
+
+include("${CMAKE_SOURCE_DIR}/../build/deps/cmake-settings/settings.cmake" REQUIRED)
+
+if(NOT DEFINED ystdlib_ROOT)
+    set(ystdlib_ROOT "${CMAKE_SOURCE_DIR}/../build/build_install")
+endif()
+find_package(ystdlib REQUIRED)
+
+
+add_executable(main main.cpp)
+
+target_compile_features(main PRIVATE cxx_std_20)
+
+target_link_libraries(
+    main
+    PRIVATE
+        ystdlib::error_handling
+)

examples/main.cpp

@@ -0,0 +1,35 @@
+#include <string>
+#include <ystdlib/error_handling/ErrorCode.hpp>
+#include <cstdint>
+#include <iostream>
+
+#include <ystdlib/error_handling/ErrorCode.hpp>
+
+enum class BinaryErrorCodeEnum : uint8_t {
+    Success = 0,
+    Failure
+};
+
+using BinaryErrorCode = ystdlib::error_handling::ErrorCode<BinaryErrorCodeEnum>;
+
+using BinaryErrorCategory = ystdlib::error_handling::ErrorCategory<BinaryErrorCodeEnum>;
+
+constexpr std::string_view cBinaryTestErrorCategoryName{"Binary Error Code"};
+
+template <>
+auto BinaryErrorCategory::name() const noexcept -> char const* {
+    return cBinaryTestErrorCategoryName.data();
+}
+
+
+YSTDLIB_ERROR_HANDLING_MARK_AS_ERROR_CODE_ENUM(BinaryErrorCodeEnum);
+
+int main() {
+    // Test error codes within the same error category
+    BinaryErrorCode const success{BinaryErrorCodeEnum::Success};
+
+    BinaryErrorCode const failure{BinaryErrorCodeEnum::Failure};
+
+    std::cout << "test is good!" << std::endl;
+    return 0;
+}