Troubleshooting:Qt LINK2001 及moc
本文介绍一个Qt程序出现的链接错误及解决方法,顺便学习下Qt的moc机制。
环境:Qt Creator + VS2008
只写一个hello_notepad.cpp文件,在Qt Creator中编译运行。
源代码如下:
1 #include <QtGui> 2 3 class Notepad : public QWidget 4 { 5 Q_OBJECT 6 7 public: 8 Notepad(); 9 10 private slots: 11 void quit(); 12 13 private: 14 QTextEdit *textEdit; 15 QPushButton *quitButton; 16 }; 17 18 Notepad::Notepad() 19 { 20 textEdit = new QTextEdit; 21 quitButton = new QPushButton(tr("Quit")); 22 23 connect(quitButton, SIGNAL(clicked()), this, SLOT(quit())); 24 25 QVBoxLayout *layout = new QVBoxLayout; 26 layout->addWidget(textEdit); 27 layout->addWidget(quitButton); 28 29 setLayout(layout); 30 31 setWindowTitle(tr("Notepad")); 32 } 33 34 void Notepad::quit() 35 { 36 QMessageBox messageBox; 37 messageBox.setWindowTitle(tr("Notepad")); 38 messageBox.setText(tr("Do you really want to quit?")); 39 messageBox.setStandardButtons(QMessageBox::Yes | QMessageBox::No); 40 messageBox.setDefaultButton(QMessageBox::No); 41 if(messageBox.exec() == QMessageBox::Yes) 42 qApp->quit(); 43 } 44 45 int main(int argv, char **args) 46 { 47 QApplication app(argv, args); 48 Notepad notepad; 49 notepad.show(); 50 51 return app.exec(); 52 } 53 54 #include "hello_notepad.moc"
编译链接时出现如下错误:
原因:链接时无法找到对应的moc文件。如果用到信号槽,但类的定义没有放在.h文件中, qmake不会自动调moc, 你就需要写#include "hello_notepad.moc" 告诉qmake有文件需要。
解决方法:在hello_notepad.cpp文件末尾加入#include "hello_notepad.moc"
最后的运行结果:
moc是QT的预编译器,用来处理代码中的slot,signal,emit,Q_OBJECT等。moc文件是对应的处理代码,也就是Q_OBJECT宏的实现部分,在官方帮助文档“Meta-Object System”中有详细说明。而MOC文件的工作方式在官方帮助文档“Using the Meta-Object Compiler (moc)”中有详细说明。
Qt 不是使用的“标准的” C++ 语言,而是对其进行了一定程度的“扩展”。这里我们从Qt新增加的关键字就可以看出来:signals、slots 或者 emit。所以有人会觉得 Qt 的程序编译速度慢,这主要是因为在 Qt 将源代码交给标准 C++ 编译器,如 gcc 之前,需要事先将这些扩展的语法去除掉。完成这一操作的就是 moc。
moc 全称是 Meta-Object Compiler,也就是“元对象编译器”。Qt 程序在交由标准编译器编译之前,先要使用 moc 分析 C++ 源文件。如果它发现在一个头文件中包含了宏 Q_OBJECT,则会生成另外一个 C++ 源文件。这个源文件中包含了 Q_OBJECT 宏的实现代码。这个新的文件名字将会是原文件名前面加上 moc_ 构成。这个新的文件同样将进入编译系统,最终被链接到二进制代码中去。因此我们可以知道,这个新的文件不是“替换”掉旧的文件,而是与原文件一起参与编译。另外,我们还可以看出一点,moc 的执行是在预处理器之前。因为预处理器执行之后,Q_OBJECT 宏就不存在了。既然每个源文件都需要 moc 去处理,那么我们在什么时候调用了它呢?实际上,如果你使用 qmake 的话,这一步调用会在生成的 makefile 中展现出来。从本质上来说,qmake 不过是一个 makefile 生成器,因此,最终执行还是通过 make 完成的。
【参考文献】
moc 元对象编译器介绍 http://news.ccidnet.com/art/32855/20100726/2128903_1.html