Documents the C Interface.

CInterface/Core.h

@@ -1,13 +1,16 @@
 #include "Core.hpp"
 #include "../src/SignalHandling.hpp"
 
+/// @file
+
 std::string ExceptionHandler::_ArbutilsLastException = "";
+/// @brief Returns a null-terminated C string to the last exception found.
 export const char* Arbutils_C_GetLastException() { return ExceptionHandler::GetLastException(); }
 
 #if !WINDOWS
 static ArbUt::SignalHandling sh;
+/// @brief Sets a callback to a function to run when a signal occurs.
 export void Arbutils_C_SetSignalCallback(void (*callback)(const char*)) { sh.SetCallback(callback); }
-export void Arbutils_C_RaiseSignal() { raise(SIGSEGV); }
 #else
 export void Arbutils_C_SetSignalCallback(void (*)(const char*)) {  }
 export void Arbutils_C_RaiseSignal() { raise(SIGSEGV); }

CInterface/Core.hpp

@@ -8,14 +8,21 @@
 
 #define ArbutilsException 3;
 
+/// @brief Handler class for storing C++ exceptions, and passing them over a C interface.
 class ExceptionHandler {
     static std::string _ArbutilsLastException;
 
 public:
+    /// @brief Stores the last found exception. Overrides previously last found exception.
+    /// @param e The last found exception as Arbutils exception.
     static void SetLastException(const ArbUt::Exception& e) {
         _ArbutilsLastException = std::string(e.what()) + "\n" + e.GetStacktrace();
     }
+    /// @brief Stores the last found exception. Overrides previously last found exception.
+    /// @param e The last found exception as std exception.
     static void SetLastException(const std::exception& e) { _ArbutilsLastException = std::string(e.what()); }
+    /// @brief Returns the last found exception as null-terminated C string.
+    /// @return A null-terminated c string detailing the last found exception.
     static const char* GetLastException() { return _ArbutilsLastException.c_str(); }
 };
 

CInterface/Random.h

@@ -1,25 +1,38 @@
 #include "../src/Random.hpp"
 #include "Core.hpp"
 
+/// @file
+
+/// @brief Constructs a random class.
 export ArbUt::Random* Arbutils_Random_Construct() { return new ArbUt::Random(); }
+/// @brief Constructs a random class with a specific seed.
 export ArbUt::Random* Arbutils_Random_ConstructWithSeed(uint_fast32_t seed) { return new ArbUt::Random(seed); }
 
+/// @brief Call the destructor on a random object.
 export void Arbutils_Random_Destruct(ArbUt::Random* p) { delete p; }
 
+/// @brief Returns a random float between 0.0 and 1.0 using a random object.
 export float Arbutils_Random_GetFloat(ArbUt::Random* p) { return p->GetFloat(); }
+/// @brief Returns a random double between 0.0 and 1.0 using a random object.
 export double Arbutils_Random_GetDouble(ArbUt::Random* p) { return p->GetDouble(); }
+/// @brief Returns a random a random 32 bit integer using a random object.
 export int32_t Arbutils_Random_Get(ArbUt::Random* p) { return p->Get(); }
+/// @brief Gets a random 32 bit integer with a given max. Returns a status code where 0 is Ok, and passes the output to the out parameter.
 export uint8_t Arbutils_Random_GetWithMax(ArbUt::Random* p, int32_t max, int32_t& out) { Try(out = p->Get(max);) }
+/// @brief Gets a random 32 bit integer with a given min and max. Returns a status code where 0 is Ok, and passes the output to the out parameter.
 export uint8_t Arbutils_Random_GetInLimits(ArbUt::Random* p, int32_t min, int32_t max, int32_t& out) {
     Try(out = p->Get(min, max);)
 }
-
+/// @brief Returns a random a random 32 bit unsigned integer using a random object.
 export uint32_t Arbutils_Random_GetUnsigned(ArbUt::Random* p) { return p->GetUnsigned(); }
+/// @brief Gets a random 32 bit unsigned integer with a given max. Returns a status code where 0 is Ok, and passes the output to the out parameter.
 export uint8_t Arbutils_Random_GetUnsignedWithMax(ArbUt::Random* p, uint32_t max, uint32_t& out) {
     Try(out = p->GetUnsigned(max);)
 }
+/// @brief Gets a random 32 bit unsigned integer with a given min and max. Returns a status code where 0 is Ok, and passes the output to the out parameter.
 export uint8_t Arbutils_Random_GetUnsignedInLimits(ArbUt::Random* p, uint32_t min, uint32_t max, uint32_t& out) {
     Try(out = p->GetUnsigned(min, max);)
 }
 
+/// @brief Returns the seed of the random object.
 export uint_fast32_t Arbutils_Random_GetSeed(ArbUt::Random* p) { return p->GetSeed(); }