- static bool connect(const QObject *sender, const char *signal,
- const QObject *receiver, const char *member, Qt::ConnectionType =
- #ifdef qdoc
- Qt::AutoConnection
- #else
- #ifdef QT3_SUPPORT
- Qt::AutoCompatConnection
- #else
- Qt::AutoConnection
- #endif
- #endif
- );
- inline bool connect(const QObject *sender, const char *signal,
- const char *member, Qt::ConnectionType type =
- #ifdef qdoc
- Qt::AutoConnection
- #else
- #ifdef QT3_SUPPORT
- Qt::AutoCompatConnection
- #else
- Qt::AutoConnection
- #endif
- #endif
- ) const;
其中第二個connect的實現其實只有一句話:
- { return connect(asender, asignal, this, amember, atype); }
所以對於connect函數的學習其實就是研究第一個connect函數。
我們在使用connect函數的時候一般是這樣調用的:
- connect(sender,SIGNAL(signal()),receiver,SLOT(slot()));
這里用到了兩個宏:SIGNAL() 和SLOT();通過connect聲明可以知道這兩個宏最后倒是得到一個const char*類型。
在qobjectdefs.h中可以看到SIGNAL() 和SLOT()的宏定義:
- #ifndef QT_NO_DEBUG
- # define QLOCATION "\0"__FILE__":"QTOSTRING(__LINE__)
- # define METHOD(a) qFlagLocation("0"#a QLOCATION)
- # define SLOT(a) qFlagLocation("1"#a QLOCATION)
- # define SIGNAL(a) qFlagLocation("2"#a QLOCATION)
- #else
- # define METHOD(a) "0"#a
- # define SLOT(a) "1"#a
- # define SIGNAL(a) "2"#a
- #endif
所以這兩個宏的作用就是把函數名轉換為字符串並且在前面加上標識符。
比如:SIGNAL(read())展開后就是"2read()";同理SLOT(read())展開后就是"1read()"。
- connect(sender,SIGNAL(signal()),receiver,SLOT(slot()));
- 實際上就是connect(sender,“2signal()”,receiver,“1slot())”;
搞明白了實際的參數就可以來看connect的真正實現過程了,在QObject.cpp文件中可以找到connect的實現代碼。
- bool QObject::connect(const QObject *sender, const char *signal,
- const QObject *receiver, const char *method,
- Qt::ConnectionType type)
- {
- {
- const void *cbdata[] = { sender, signal, receiver, method, &type };
- if (QInternal::activateCallbacks(QInternal::ConnectCallback, (void **) cbdata))
- return true;
- }
- if (sender == 0 || receiver == 0 || signal == 0 || method == 0) {
- qWarning("QObject::connect: Cannot connect %s::%s to %s::%s",
- sender ? sender->metaObject()->className() : "(null)",
- (signal && *signal) ? signal+1 : "(null)",
- receiver ? receiver->metaObject()->className() : "(null)",
- (method && *method) ? method+1 : "(null)");
- return false;
- }
- QByteArray tmp_signal_name;
- if (!check_signal_macro(sender, signal, "connect", "bind"))
- return false;
- const QMetaObject *smeta = sender->metaObject();
- const char *signal_arg = signal;
- ++signal; //skip code
- int signal_index = smeta->indexOfSignal(signal);
- if (signal_index < 0) {
- // check for normalized signatures
- tmp_signal_name = QMetaObject::normalizedSignature(signal - 1);
- signal = tmp_signal_name.constData() + 1;
- signal_index = smeta->indexOfSignal(signal);
- if (signal_index < 0) {
- err_method_notfound(sender, signal_arg, "connect");
- err_info_about_objects("connect", sender, receiver);
- return false;
- }
- }
- QByteArray tmp_method_name;
- int membcode = extract_code(method);
- if (!check_method_code(membcode, receiver, method, "connect"))
- return false;
- const char *method_arg = method;
- ++method; // skip code
- const QMetaObject *rmeta = receiver->metaObject();
- int method_index = -1;
- switch (membcode) {
- case QSLOT_CODE:
- method_index = rmeta->indexOfSlot(method);
- break;
- case QSIGNAL_CODE:
- method_index = rmeta->indexOfSignal(method);
- break;
- }
- if (method_index < 0) {
- // check for normalized methods
- tmp_method_name = QMetaObject::normalizedSignature(method);
- method = tmp_method_name.constData();
- switch (membcode) {
- case QSLOT_CODE:
- method_index = rmeta->indexOfSlot(method);
- break;
- case QSIGNAL_CODE:
- method_index = rmeta->indexOfSignal(method);
- break;
- }
- }
- if (method_index < 0) {
- err_method_notfound(receiver, method_arg, "connect");
- err_info_about_objects("connect", sender, receiver);
- return false;
- }
- if (!QMetaObject::checkConnectArgs(signal, method)) {
- qWarning("QObject::connect: Incompatible sender/receiver arguments"
- "\n %s::%s --> %s::%s",
- sender->metaObject()->className(), signal,
- receiver->metaObject()->className(), method);
- return false;
- }
- int *types = 0;
- if ((type == Qt::QueuedConnection || type == Qt::BlockingQueuedConnection)
- && !(types = queuedConnectionTypes(smeta->method(signal_index).parameterTypes())))
- return false;
- QMetaObject::connect(sender, signal_index, receiver, method_index, type, types);
- const_cast<QObject*>(sender)->connectNotify(signal - 1);
- return true;
- }
上面是去除了debug代碼的connect實現。
- const void *cbdata[] = { sender, signal, receiver, method, &type };
- if (QInternal::activateCallbacks(QInternal::ConnectCallback, (void **) cbdata))
- return true;
判斷連接是否已經建立。
QInternal::ConnectCallback在qglobal.cpp中實現。
- bool QInternal::activateCallbacks(Callback cb, void **parameters)
- {
- Q_ASSERT_X(cb >= 0, "QInternal::activateCallback()", "Callback id must be a valid id");
- QInternal_CallBackTable *cbt = global_callback_table();
- if (cbt && cb < cbt->callbacks.size()) {
- QList<qInternalCallback> callbacks = cbt->callbacks[cb];
- bool ret = false;
- for (int i=0; i<callbacks.size(); ++i)
- ret |= (callbacks.at(i))(parameters);
- return ret;
- }
- return false;
- }
QInternal_CallBackTable 定義為(qglobal.cpp)
- struct QInternal_CallBackTable {
- QVector<QList<qInternalCallback> > callbacks;
- };
qInternalCallback定義為(qnamespace.h)
- typedef bool (*qInternalCallback)(void **);這是一個函數指針 返回值是bool,只有一個參數為void**。這個指針在調用registerCallback加入列表。
- if (!check_signal_macro(sender, signal, "connect", "bind"))
- return false;
判斷signal是否合法。
在QObject.cpp文件中可以找到check_signal_macro的實現
- static bool check_signal_macro(const QObject *sender, const char *signal,
- const char *func, const char *op)
- {
- int sigcode = extract_code(signal);
- if (sigcode != QSIGNAL_CODE) {
- if (sigcode == QSLOT_CODE)
- qWarning("Object::%s: Attempt to %s non-signal %s::%s",
- func, op, sender->metaObject()->className(), signal+1);
- else
- qWarning("Object::%s: Use the SIGNAL macro to %s %s::%s",
- func, op, sender->metaObject()->className(), signal);
- return false;
- }
- return true;
- }
extract的實現也在QObject中,它就是去字符串第一個字符,並且只取低2位的值。
- static int extract_code(const char *member)
- {
- // extract code, ensure QMETHOD_CODE <= code <= QSIGNAL_CODE
- return (((int)(*member) - '0') & 0x3);
- }
這里又有兩個宏:QSIGNAL_CODE 和QSLOT_CODE。它們也是在qobjectdefs.h文件中定義的。
- #ifdef QT3_SUPPORT
- #define METHOD_CODE 0 // member type codes
- #define SLOT_CODE 1
- #define SIGNAL_CODE 2
- #endif
這個定義與之前的SIGNAL和SLOT的定義是對應的。
- const QMetaObject *smeta = sender->metaObject();
- const char *signal_arg = signal;
- ++signal; //skip code
- int signal_index = smeta->indexOfSignal(signal);
- if (signal_index < 0) {
- // check for normalized signatures
- tmp_signal_name = QMetaObject::normalizedSignature(signal - 1);
- signal = tmp_signal_name.constData() + 1;
- signal_index = smeta->indexOfSignal(signal);
- if (signal_index < 0) {
- err_method_notfound(sender, signal_arg, "connect");
- err_info_about_objects("connect", sender, receiver);
- return false;
- }
- }
獲取signal的索引。
metaObject()是在moc_name.cpp文件中生成的。
- return QObject::d_ptr->metaObject ? QObject::d_ptr->metaObject : &staticMetaObject;
其中staticMetaObject也是在moc文件中定義的
- const QMetaObject MainWindow::staticMetaObject = {
- { &QMainWindow::staticMetaObject, qt_meta_stringdata_MainWindow,
- qt_meta_data_MainWindow, 0 }
- };
qt_meta_stringdata_MainWindow(具體名字和類名有關)就是staticconstchar[]類型。它記錄了全部的signals和slots等的函數名、返回值和參數表的信息。
qt_meta_data_MainWindow(具體名字和類名有關)是staticconstuint[]類型。它記錄了每一個函數的函數名、返回值和參數表在qt_meta_stringdata_MainWindow中的索引。同時它還記錄了每一個函數的類型具體在qmetaobject.cpp文件中定義。
- enum MethodFlags {
- AccessPrivate = 0x00,
- AccessProtected = 0x01,
- AccessPublic = 0x02,
- AccessMask = 0x03, //mask
- MethodMethod = 0x00,
- MethodSignal = 0x04,
- MethodSlot = 0x08,
- MethodConstructor = 0x0c,
- MethodTypeMask = 0x0c,
- MethodCompatibility = 0x10,
- MethodCloned = 0x20,
- MethodScriptable = 0x40
- };
indexOfSignal(signal);的實現在qmetaobject.cpp中。其主要作用是利用qt_meta_stringdata_MainWindow 和qt_meta_data_MainWindow查找已經定義了的signal並返回索引。
- QByteArray tmp_method_name;
- int membcode = extract_code(method);
- if (!check_method_code(membcode, receiver, method, "connect"))
- return false;
- const char *method_arg = method;
- ++method; // skip code
- const QMetaObject *rmeta = receiver->metaObject();
- int method_index = -1;
- switch (membcode) {
- case QSLOT_CODE:
- method_index = rmeta->indexOfSlot(method);
- break;
- case QSIGNAL_CODE:
- method_index = rmeta->indexOfSignal(method);
- break;
- }
- if (method_index < 0) {
- // check for normalized methods
- tmp_method_name = QMetaObject::normalizedSignature(method);
- method = tmp_method_name.constData();
- switch (membcode) {
- case QSLOT_CODE:
- method_index = rmeta->indexOfSlot(method);
- break;
- case QSIGNAL_CODE:
- method_index = rmeta->indexOfSignal(method);
- break;
- }
- }
- if (method_index < 0) {
- err_method_notfound(receiver, method_arg, "connect");
- err_info_about_objects("connect", sender, receiver);
- return false;
- }
校驗method並且查找它的索引。過程與signal類似。
- if (!QMetaObject::checkConnectArgs(signal, method)) {
- qWarning("QObject::connect: Incompatible sender/receiver arguments"
- "\n %s::%s --> %s::%s",
- sender->metaObject()->className(), signal,
- receiver->metaObject()->className(), method);
- return false;
- }
判斷signal和method是否兼容,checkConnectArgs函數的在qmetaObject.cpp文件中實現。這個函數校驗了signal和method的參數。當兩者的參數一致或method參數比signal參數少(method與signal前幾個參數一致)的時候返回true,其它返回false。
- int *types = 0;
- if ((type == Qt::QueuedConnection || type == Qt::BlockingQueuedConnection)
- && !(types = queuedConnectionTypes(smeta->method(signal_index).parameterTypes())))
- return false;
如果是以發消息的方式執行method就需要對參數類型進行判斷。queuedConnectionTypes在QObject.cpp實現。實際上是在QMetatype.cpp中定義了一個
static conststruct { constchar * typeName;int type;} types[];在這里記錄了全部類型和名稱如({"void",QMetaType::Void});Void在Qmetatype.h中定義。
- QMetaObject::connect(sender, signal_index, receiver, method_index, type, types);
調用QMetaObject的connect函數,再次不詳細寫出。
- const_cast<QObject*>(sender)->connectNotify(signal - 1);
最后調用虛函數connectNotify表示connect已經執行完成。