Enhance doc for checked_cast and assert type requirements

Author: Flamefire

libs/common/include/commonDefines.h

@@ -5,6 +5,7 @@
 #pragma once
 
 #include "RTTR_Assert.h"
+#include <type_traits>
 
 /// Call a member function trough an object and a member function pointer
 #define CALL_MEMBER_FN(object, ptrToMember) ((object).*(ptrToMember))
@@ -24,17 +25,22 @@ inline T absDiff(T a, T b)
     return (a > b) ? a - b : b - a;
 }
 
-/// Same as static_cast<T> but assert that it actually can be casted via dynamic_cast
+/// Same as static_cast<T> but assert the correct dynamic type (in debug mode)
+/// Use like: checkedCast<Derived*>(basePtr)
 template<typename T, typename T_Src>
 inline T checkedCast(T_Src* src)
 {
+    static_assert(std::is_pointer_v<T>, "T must be a pointer type");
     RTTR_Assert(!src || dynamic_cast<T>(src));
     return static_cast<T>(src);
 }
 
+/// Same as static_cast<T&> but assert the correct dynamic type (in debug mode)
+/// Use like: checkedCast<Derived>(baseRef)
 template<typename T, typename T_Src>
 inline T& checkedCast(T_Src& src)
 {
+    static_assert(std::is_class_v<T>, "T must be a plain type");
     RTTR_Assert(dynamic_cast<T*>(&src));
     return static_cast<T&>(src);
 }