Unreal Engine 5宏代码修正与结构体成员检测技术求助

一、核心问题说明 #

原FORVALUE宏采用运行时字符串查找判断结构体成员，不仅存在拼写错误漏检、性能损耗问题，且直接通过字符串拼接访问成员的写法在C++中不合法，必须改用编译期检测方案替代。

二、宏代码修正与实现 #

1. 编译期成员检测宏（DETECTED_MEMBER） #

通过SFINAE技术实现编译期判断结构体是否包含指定成员，彻底避免运行时检测的不可靠性：

#include <type_traits>

// 辅助模板：编译期检测结构体是否包含目标成员
template<typename T, typename = void>
struct HasMember : std::false_type {};

template<typename T>
struct HasMember<T, std::void_t<decltype(std::declval<T>().Field)>> : std::true_type {};

// 封装为宏，直接返回检测结果
#define DETECTED_MEMBER(StructType, FieldName) HasMember<StructType, std::void_t<decltype(std::declval<StructType>().FieldName)>>::value

2. FORVALUE宏修正 #

替换原错误逻辑，改用编译期检测+类型安全的成员访问：

#define FORVALUE(Struct, Field, Value) \
    static_assert(DETECTED_MEMBER(Struct, Field), "结构体" #Struct "不存在成员" #Field); \
    if constexpr (DETECTED_MEMBER(Struct, Field)) { \
        Value = Value.Field; \
    }

三、配套代码实现 #

1. 类型判断模板函数 #

用于判断变量是否为目标结构体类型：

template<typename T>
bool IsStructType(const UStruct* Struct)
{
    return Struct == T::StaticStruct();
}

2. 蓝图函数库UILbr实现 #

封装宏逻辑为蓝图可调用函数，处理int32数组读取需求：

UCLASS()
class YOURPROJECT_API UILbr : public UBlueprintFunctionLibrary
{
    GENERATED_BODY()

public:
    UFUNCTION(BlueprintCallable, Category = "Data Handling")
    static void ReadIdArray(const TArray<int32>& IdArray, UStruct* TargetStruct, FString FieldName, int32& OutValue);
    
    // 模板实现：处理具体结构体类型的成员读取
    template<typename T>
    static void ReadStructMember(const T& StructInstance, int32& OutValue)
    {
        T TempValue = StructInstance;
        FORVALUE(T, TargetField, TempValue); // 替换TargetField为实际成员名，或结合参数动态处理
        OutValue = static_cast<int32>(TempValue); // 需根据成员实际类型调整转换逻辑
    }
};

3. ISSI类型判断宏 #

#define ISSI(Var, Type) IsStructType<Type>(Var->GetClass()->GetDefaultObject()->GetStruct())

四、测试验证代码 #

验证宏的正确性：

// 测试用结构体
USTRUCT()
struct FTestStruct
{
    GENERATED_BODY()

    UPROPERTY()
    int32 TestId;
};

// 测试函数
void TestMacros()
{
    // 检测成员存在性
    bool bHasValidMember = DETECTED_MEMBER(FTestStruct, TestId);
    check(bHasValidMember == true);

    bool bHasInvalidMember = DETECTED_MEMBER(FTestStruct, InvalidField);
    check(bHasInvalidMember == false);

    // 测试FORVALUE宏的成员访问
    FTestStruct TestStruct;
    TestStruct.TestId = 123;
    FORVALUE(FTestStruct, TestId, TestStruct);
    check(TestStruct.TestId == 123);
}

五、关键修正要点 #

• 替换原运行时字符串查找为编译期SFINAE检测，编译阶段即可发现成员不存在的问题，避免运行时错误。
• 用if constexpr配合编译期检测确保只有成员存在时才编译访问代码，保证类型安全。

内容的提问来源于stack exchange，提问作者Dreia Ria