Q_DECLARE_METATYPE與qRegisterMetaType

轉載：https://blog.csdn.net/zb872676223/article/details/38778125

基本理解

• Q_DECLARE_METATYPE
  • 如果要使自定義類型或其他非QMetaType內置類型在QVaiant中使用，必須使用該宏。
  • 該類型必須有公有的構造、析構、複製構造函數
• qRegisterMetaType 必須使用該函數的兩種情況
  • 如果非QMetaType內置類型要在 Qt 的屬性系統中使用
  • 如果非QMetaType內置類型要在 queued 信號與槽中使用

二者關係

• 二者的代碼
  • Q_DECLARE_METATYPE 展開後是一個特化後的類 QMetaTypeId
  • qRegisterMetaType 將某類型註冊中MetaType系統中
• 二者的聯繫
  • QMetaTypeId的類中的成員包含對qRegisterMetaType的調用
  • 我們知道類中的成員函數並不一定會被調用(即：該宏並不確保類型被註冊到MetaType)。
  • 通過qRegisterMetaType可以確保類型被註冊
• 兩個qRegisterMetaType 的聯繫
  • 無參的qRegisterMetaType函數會通過該成員調用帶參數的qRegisterMetaType()

源碼

這兩個東西真難理清，不妨看看源碼吧。

Q_DECLARE_METATYPE

代碼來源：src/corelib/kernel/qmetatype.h

#define Q_DECLARE_METATYPE(TYPE)                                        \
    QT_BEGIN_NAMESPACE                                                  \
    template <>                                                         \
    struct QMetaTypeId< TYPE >                                          \
    {                                                                   \
        enum { Defined = 1 };                                           \
        static int qt_metatype_id()                                     \
            {                                                           \
                static QBasicAtomicInt metatype_id = Q_BASIC_ATOMIC_INITIALIZER(0); \
                if (!metatype_id)                                       \
                    metatype_id = qRegisterMetaType< TYPE >(#TYPE);     \
                return metatype_id;                                     \
            }                                                           \
    };                                                                  \
    QT_END_NAMESPACE

• 宏展開是一個在Qt的命名空間中的一個類模板的特化 QMetaTypeId
• 該類含一個enum和一個返回QMetaType的id的成員函數

qRegisterMetaType(const char *typeName)

代碼來源：src/corelib/kernel/qmetatype.h

template <typename T>
int qRegisterMetaType(const char *typeName)
{
    typedef void*(*ConstructPtr)(const T*);
    ConstructPtr cptr = qMetaTypeConstructHelper<T>;
    typedef void(*DeletePtr)(T*);
    DeletePtr dptr = qMetaTypeDeleteHelper<T>;

    return QMetaType::registerType(typeName, reinterpret_cast<QMetaType::Destructor>(dptr),
                                   reinterpret_cast<QMetaType::Constructor>(cptr));
}

• 該函數的核心就是調用了registerType 函數
• 兩個Helper模板函數分別對構造和析構函數進行封裝

registerType

registerType

int QMetaType::registerType(const char *typeName, Destructor destructor, Constructor constructor)

函數功能：

• 根據類型名查找其MetaType類型，如果已存在，則直接返回;否則創建後返回。
• 創建一個QCustomTypeInfo對象
  • 該對象包含要類型的構造、析構信息，已經規範化後的類型名
  • 該對象存入一個全局的QVector中

qRegisterMetaType()

看manual，可以知道，qRegisterMetaType 還有一個無參的重載函數。

template <typename T>
inline int qRegisterMetaType()
{
    return qMetaTypeId(static_cast<T *>(0));
}

• 函數看起來和帶參數的那個似乎區別很大。
• 手冊中告訴我們，執行這個的時候，模板參數T必須用 Q_DECLARE_METATYPE() 聲明過，能猜到原因嗎？注意看前面 Q_DECLARE_METATYPE() 代碼
• 類中的成員函數qt_metatype_id中包含對qRegisterMetaType(typeName)的調用，這兒就是輾轉調用了這個帶參數的qRegisterMetaType函數

unregisterType(const char *typeName)

函數的作用是取消自己先前註冊的某個metatype類型。

前面提到註冊信息在一個全局的 QVector中，當取消註冊的時候是怎麼樣的呢？直接刪除Vector中相應的項麼？源碼告訴我們，不是的。

實際是查找到相應的項，清空該項的內容。

for (int v = 0; v < ct->count(); ++v)
{
	if (ct->at(v).typeName == typeName)
	{
		QCustomTypeInfo &inf = (*ct)[v];
		inf.typeName.clear();
		inf.constr = 0;
		inf.destr = 0;
		inf.alias = -1;
	}
}