qmake language 关键字 true false host_build option return next break ever forever LITERAL_HASH

丘上人

已于 2022-12-04 16:46:14 修改

阅读量504

点赞数

分类专栏： qt 文章标签： qt qmake

于 2022-09-26 23:26:14 首次发布

本文链接：https://blog.csdn.net/qiushangren/article/details/127061839

版权

qt 专栏收录该内容

69 篇文章 11 订阅

订阅专栏

使用qt版本 5.12.0

简介

qmake language中true和false与C/C++中true false是有区别的！qmake language中true和false都有两重意思，作为非判断语句的条件时，他们就是字符串；作为判断语句的条件时，true和false才会被qmake做关键字解释，true会被解析成C++中的bool类型的true，false会被解析成C++中bool类型的false。

语法相关的关键字

1、qmake的C++源码为qmake language定义的内置函数：qmake language 内置函数自定义函数
2、ever、forever、else、for、return、next、break用于条件语句和循环语句：qmake language
3、option、host_build，两者需要结合使用：option(host_build)。host_build其作用的地方在bool QMakeEvaluator::loadSpec()中，用于决定是生成QMAKE_SPEC（host主机）指定的架构的build还是QMAKE_XSPEC（target目标机）指定的架构的build。设置host_build为true，则生成QMAKE_SPEC指定的架构的build。
host_build是与true、 false关键字一样的关键字，也具有两重意思，区别在作为判断语句的条件时qmake根据配置情况会将host_build解析成C++的bool类型的true或false，不是作为判断条件时会被当成字符串。严格来说，qmake language中没有bool类型。只是qmake进行解析时将qmake language的关键字true固定解析成C++的bool的true，将qmake language的关键字false固定解析成C++中bool的false。而对于host_build，qmake会根据具体的配置将其解析成C++的true或false。
案例：

tt=true
true=ttt         #将字符串ttt赋予给名字为true的变量。
ttv=$$tt         #$$tt的值为字符串true，将字符串true传递给ttv。注意这里的操作不叫bool类型变量值传递。因为没有bool类型变量的概念。
ttv=host_build   #将字符串host_build赋予给变量ttv
ttv1=$$host_build#将名字为host_build的变量的值赋予给ttv1，因为没有定义host_build的变量，所以host_build的值为空。  


message($$tt)    #输出true  在qmake language中true应该只视为关键字，而不应该理解为常规意义的
message($$true)  #输出：Project MESSAGE: ttt
message($$ttv)   #输出host_build  host_build与true false是同等级的关键字，因为不是条件语句，在此host_build只是字符串
message($$ttv1)   #输出为空

host_build{message(here1)}  #输出here1  qmake解析判定条件时会计算判定条件，并将判定条件解析成C++的bool，host_build在被qmake解析时被解析成C++的bool类型。
else{message(here2)}

$$tt{message(here1)}    #$$tt就是关键字true，在此true作为条件语句，会被解析成C++的bool类型的true。输出here1
else{message(here2)}

$$ttv{message(here1)}   #$$ttv就是关键字host_build。在此true作为条件语句，会被解析成C++的bool类型。具体值qmake根据具体配置进行赋予。输出here1
else{message(here2)}

option、host_build的处理逻辑：

4、build_pass，一个特殊的CONFIG属性，qmake在build的阶段会主动加入CONFIG中

build_pass:message(here1)   #build_pass特殊变量，语句的意思表示冒号后面的代码块只执行一遍。

qmake内置变量

qmake内置变量，也就是qmake C++源码直接为qmake language初始化的变量和qmake language写的配置文件中定义的变量。
1、特殊处理的内置变量：_LINE_(当前行号)、_FILE_(当前文件名)、LITERAL_HASH(字符#)、LITERAL_DOLLAR(字符$)、LITERAL_WHITESPACE(制表符tab键)，相当于qmake language的预处理

var=aaaa
message($var)     #单个$在qmake中就被当做普通字符处理。两个$$符才会被当做取值符号处理。
message($$var)
message($$variablenotexist)
message($variablenotexist)
message(aa$${_LINE_}bb)
message(aa$${_FILE_}bb)
message(aa$${LITERAL_HASH}bb)
message(aa$${LITERAL_DOLLAR}bb)
message(aa$${LITERAL_WHITESPACE}bb)
#输出：
#Project MESSAGE: $var
#Project MESSAGE: aaaa
#Project MESSAGE: 
#Project MESSAGE: $variablenotexist
#Project MESSAGE: aa31bb
#Project MESSAGE: aaE:/workspace/QtWork/testEmpty/testEmpty.probb
#Project MESSAGE: aa#bb
#Project MESSAGE: aa$bb
#Project MESSAGE: aa	bb

qmake 对pro文件的预处理的C++源码：

//E:\workspace\QtWork\qmake\library\qmakeparser.cpp
bool QMakeParser::resolveVariable(ushort *xprPtr, int tlen, int needSep, ushort **ptr,
                                  ushort **buf, QString *xprBuff,
                                  ushort **tokPtr, QString *tokBuff,
                                  const ushort *cur, const QStringRef &in)
{
    QString out;
    m_tmp.setRawData((const QChar *)xprPtr, tlen);
    if (m_tmp == statics.strLINE) {
        out.setNum(m_lineNo);
    } else if (m_tmp == statics.strFILE) {
        out = m_proFile->fileName();
        // The string is typically longer than the variable reference, so we need
        // to ensure that there is enough space in the output buffer - as unlikely
        // as an overflow is to actually happen in practice.
        int need = (in.length() - (cur - (const ushort *)in.constData()) + 2) * 5 + out.length();
        int tused = *tokPtr - (ushort *)tokBuff->constData();
        int xused;
        int total;
        bool ptrFinal = xprPtr >= (ushort *)tokBuff->constData()
                && xprPtr < (ushort *)tokBuff->constData() + tokBuff->capacity();
        if (ptrFinal) {
            xused = xprPtr - (ushort *)tokBuff->constData();
            total = xused + need;
        } else {
            xused = xprPtr - *buf;
            total = tused + xused + need;
        }
        if (tokBuff->capacity() < total) {
            tokBuff->reserve(total);
            *tokPtr = (ushort *)tokBuff->constData() + tused;
            xprBuff->reserve(total);
            *buf = (ushort *)xprBuff->constData();
            xprPtr = (ptrFinal ? (ushort *)tokBuff->constData() : *buf) + xused;
        }
    } else if (m_tmp == statics.strLITERAL_HASH) {
        out = QLatin1String("#");
    } else if (m_tmp == statics.strLITERAL_DOLLAR) {
        out = QLatin1String("$");
    } else if (m_tmp == statics.strLITERAL_WHITESPACE) {
        out = QLatin1String("\t");
    } else {
        return false;
    }
    xprPtr -= 2; // Was set up for variable reference
    xprPtr[-2] = TokLiteral | needSep;
    xprPtr[-1] = out.length();
    memcpy(xprPtr, out.constData(), out.length() * 2);
    *ptr = xprPtr + out.length();
    return true;
}

2、ARGS、ARGC、1、2、.... 用于函数参数：qmake language 内置函数自定义函数
3、qmake帮助手册中对通用内置变量介绍，这包括qmake源码端定义的变量和部分用qmake language写的配置文件中定义的变量：Qt 5.12->qmake Manual->Variables，手册中介绍的是部分的，但是不全。

qmake内置函数

1、defineTest、defineReplace用于定义函数：qmake language 内置函数自定义函数
2、bypassNesting，qmake内部为qmake language定义的特殊函数：bypassNesting()
3、内部定义的test函数和replace函数：qmake language 内置函数自定义函数
qmake帮助手册对内置函数介绍位置：
Qt 5.12->qmake Manual->Test Functions
Qt 5.12->qmake Manual->Replace Functions

杂谈

qmake源码列举的部分关键字，注意，这里不是关键字的定义，有的关键字并没有明确的给出定义，在解析的时候直接匹配解析了。

//QrInstallDir\Qt5.12.0\5.12.0\Src\qtbase\qmake\library\qmakeevaluator.cpp
void QMakeEvaluator::initStatics()
{
    if (!statics.field_sep.isNull())
        return;

    statics.field_sep = QLatin1String(" ");
    statics.strtrue = QLatin1String("true");
    statics.strfalse = QLatin1String("false");
    statics.strCONFIG = ProKey("CONFIG");
    statics.strARGS = ProKey("ARGS");
    statics.strARGC = ProKey("ARGC");
    statics.strDot = QLatin1String(".");
    statics.strDotDot = QLatin1String("..");
    statics.strever = QLatin1String("ever");
    statics.strforever = QLatin1String("forever");
    statics.strhost_build = QLatin1String("host_build");  //host_build关键字。
    statics.strTEMPLATE = ProKey("TEMPLATE");
    statics.strQMAKE_PLATFORM = ProKey("QMAKE_PLATFORM");
    statics.strQMAKE_DIR_SEP = ProKey("QMAKE_DIR_SEP");
    statics.strQMAKESPEC = ProKey("QMAKESPEC");
#ifdef PROEVALUATOR_FULL
    statics.strREQUIRES = ProKey("REQUIRES");
#endif
.....
}


//QtInstallDir\Qt5.12.0\5.12.0\Src\qtbase\qmake\library\qmakeparser.cpp
void QMakeParser::initialize()
{
    if (!statics.strelse.isNull())
        return;

    statics.strelse = QLatin1String("else");
    statics.strfor = QLatin1String("for");
    statics.strdefineTest = QLatin1String("defineTest");
    statics.strdefineReplace = QLatin1String("defineReplace");
    statics.strbypassNesting = QLatin1String("bypassNesting");
    statics.stroption = QLatin1String("option");
    statics.strreturn = QLatin1String("return");
    statics.strnext = QLatin1String("next");
    statics.strbreak = QLatin1String("break");
    statics.strhost_build = QLatin1String("host_build");
    statics.strLINE = QLatin1String("_LINE_");
    statics.strFILE = QLatin1String("_FILE_");
    statics.strLITERAL_HASH = QLatin1String("LITERAL_HASH");
    statics.strLITERAL_DOLLAR = QLatin1String("LITERAL_DOLLAR");
    statics.strLITERAL_WHITESPACE = QLatin1String("LITERAL_WHITESPACE");
}

//QtInstallDir\Qt5.12.0\5.12.0\Src\qtbase\qmake\library\proitems.h
class QMAKE_EXPORT ProFile
{
.....
    bool isHostBuild() const { return m_hostBuild; }
    void setHostBuild(bool host_build) { m_hostBuild = host_build; }
.....
}

qmake 源码中为qmake language定义内置变量的方式就是直接往qmake language的堆栈中压入变量，下面是qmake为qmake language定义内置变量TARGET、_PRO_FILE_、_PRO_FILE_PWD_、OUT_PWD的方式：

void QMakeEvaluator::setupProject()
{
    setTemplate();
    ProValueMap &vars = m_valuemapStack.top();
    int proFile = currentFileId();
    vars[ProKey("TARGET")] << ProString(QFileInfo(currentFileName()).baseName()).setSource(proFile);
    vars[ProKey("_PRO_FILE_")] << ProString(currentFileName()).setSource(proFile);
    vars[ProKey("_PRO_FILE_PWD_")] << ProString(currentDirectory()).setSource(proFile);
    vars[ProKey("OUT_PWD")] << ProString(m_outputDir).setSource(proFile);
}