qmake 乱乱乱谈(三)

接前面的qmake 乱乱乱谈(一)以及qmake 乱乱乱谈(二)，本文看看qmake中的函数(Manual中有的就不重复了)。

函数分两种：

• 内置函数 (qmake Manual中列出的属于此类)

• 自定义函数 (通过defineReplace或defineTest定义)

函数还可以分两种(真不知道怎么叙述)：

• 返回值是布尔量的函数。(或者称为条件函数？)
  • 内置函数中的 system()、exists()等用作条件的函数
  • 内置函数中的 error()、return()、export()等不用做条件的函数
  • 使用defineTest()定义的函数
  • 函数调用时，前面不加 $$
• 以进行数据处理为目的的函数？返回值是处理结果。
  • 内置函数中的dirname()、join()等
  • 使用defineReplace()定义的函数
  • 函数调用时，前面加 $$

函数用法

加不加$$ ?

前面提到，两类函数中，

• 一类前面不加$$，比如下面的exists和message

exists( $(QTDIR)/lib/libqt-mt* ) {
       message( "Configuring for multi-threaded Qt..." )
       CONFIG += thread
}

• 另一类前面要加 $$,比如下面的 basename

 FILE = /etc/passwd
 FILENAME = $$basename(FILE) #passwd

可是有没有疑问？

疑问？

system 有两种用法：

• 不加 $$

system(ls /bin):HAS_BIN=FALSE

• 加 $$

UNAME = $$system(uname -s)

莫不是我们前面说的都是错的！！！

在看源码之前一直没搞清楚到底怎么回事。原来，有两个system函数，分别属于前面的两类。

• 前者，调用C语言的system函数，判断返回值是否为零

    case T_SYSTEM:
        if(args.count() < 1 || args.count() > 2) {
            fprintf(stderr, "%s:%d: system(exec) requires one argument.\n", parser.file.toLatin1().constData(),
                    parser.line_no);
            return false;
        }
        if(args.count() == 2) {
            const QString sarg = args[1];
            if (sarg.toLower() == "true" || sarg.toInt())
                warn_msg(WarnParser, "%s:%d: system()'s second argument is now hard-wired to false.\n",
                         parser.file.toLatin1().constData(), parser.line_no);
        }
        return system(args[0].toLatin1().constData()) == 0;

• 后者，调用linux下的popen()或windows下的_popen()函数。返回其标准输出！

    case E_SYSTEM: {
        if(args.count() < 1 || args.count() > 2) {
            fprintf(stderr, "%s:%d system(execut) requires one argument.\n",
                    parser.file.toLatin1().constData(), parser.line_no);
        } else {
            char buff[256];
            bool singleLine = true;
            if(args.count() > 1)
                singleLine = (args[1].toLower() == "true");
            QString output;
            FILE *proc = QT_POPEN(args[0].toLatin1(), "r");
            while(proc && !feof(proc)) {
                int read_in = int(fread(buff, 1, 255, proc));
                if(!read_in)
                    break;
                for(int i = 0; i < read_in; i++) {
                    if((singleLine && buff[i] == '\n') || buff[i] == '\t')
                        buff[i] = ' ';
                }
                buff[read_in] = '\0';
                output += buff;
            }
            ret += split_value_list(output);
            if(proc)
                QT_PCLOSE(proc);
        }
        break; }

自定义函数

看例子：定义的两个函数都是叫func1，但类型不同

• test.pro

defineReplace(func1){
  variable = $$1
  message(replace_func $$variable)
  return (variable)
}

defineTest(func1){
  variable = $$1
  message(test_func $$variable)
  return (true)
}

NAME = dbzhang800
func1($$NAME):message(success)
ABC = $$func1($$NAME)

• 运行qmake的结果如下：

Project MESSAGE: test_func dbzhang800
Project MESSAGE: success
Project MESSAGE: replace_func dbzhang800

例子

• 看一个比较常用的(Qt feature文件中提供的)自定义函数：qtLibraryTarget

defineReplace(qtLibraryTarget) {
   unset(LIBRARY_NAME)
   LIBRARY_NAME = $$1
   contains(TEMPLATE, .*lib):CONFIG(debug, debug|release) {
      !debug_and_release|build_pass {
          mac:RET = $$member(LIBRARY_NAME, 0)_debug
              else:win32:RET = $$member(LIBRARY_NAME, 0)d
      }
   }
   isEmpty(RET):RET = $$LIBRARY_NAME
   return($$RET)
}

为调试版的库文件添加_debug或d后缀！

例子

函数内的如何获取参数：

• 似乎 $$1 和 $$ARGS 完全等价

defineReplace(func1){
  message(\$\$1 $$1)
  message(\$\$ARGS $$ARGS)
  for(v, 1){
    message($$v)
  }
  for(v, ARGS){
     message($$v)
  }
  return ($$1)
}

NAME = dbzhang800 dbzhang801 dbzhang802
ABC = $$func1($$NAME)
#两个参数的要这么写(逗号不同于空格)，然后，用$$2获取第二个参数，$$ARGS获取全部
#ABCD = $$func1($$NAME, $$NAME)

• 结果

Project MESSAGE: $$1 dbzhang800 dbzhang801 dbzhang802
Project MESSAGE: $$ARGS dbzhang800 dbzhang801 dbzhang802
Project MESSAGE: dbzhang800
Project MESSAGE: dbzhang801
Project MESSAGE: dbzhang802
Project MESSAGE: dbzhang800
Project MESSAGE: dbzhang801
Project MESSAGE: dbzhang802

参考

• http://doc.qt.nokia.com/4.7/qmake-advanced-usage.html

• http://doc.qt.nokia.com/4.7/qmake-function-reference.html

• http://www.qtcentre.org/wiki/index.php?title=Undocumented_qmake