四、foreach 函數(shù)
foreach函數(shù)和別的函數(shù)非常的不一樣。因?yàn)檫@個(gè)函數(shù)是用來做循環(huán)用的,Makefile中的foreach函數(shù)幾乎是仿照于Unix標(biāo)準(zhǔn)Shell(/bin/sh)中的for語句,或是C-Shell(/bin/csh)中的foreach語句而構(gòu)建的。它的語法是:
$(foreach <var>;,<list>;,<text>;)
這個(gè)函數(shù)的意思是,把參數(shù)<list>;中的單詞逐一取出放到參數(shù)<var>;所指定的變量中,然后再執(zhí)行<text>;所包含的表達(dá)式。每一次<text>;會返回一個(gè)字符串,循環(huán)過程中,<text>;的所返回的每個(gè)字符串會以空格分隔,最后當(dāng)整個(gè)循環(huán)結(jié)束時(shí),<text>;所返回的每個(gè)字符串所組成的整個(gè)字符串(以空格分隔)將會是foreach函數(shù)的返回值。
所以,<var>;最好是一個(gè)變量名,<list>;可以是一個(gè)表達(dá)式,而<text>;中一般會使用<var>;這個(gè)參數(shù)來依次枚舉<list>;中的單詞。舉個(gè)例子:
names := a b c d
files := $(foreach n,$(names),$(n).o)
上面的例子中,$(name)中的單詞會被挨個(gè)取出,并存到變量“n”中,“$(n).o”每次根據(jù)“$(n)”計(jì)算出一個(gè)值,這些值以空格分隔,最后作為foreach函數(shù)的返回,所以,$(files)的值是“a.o b.o c.o d.o”。
注意,foreach中的<var>;參數(shù)是一個(gè)臨時(shí)的局部變量,foreach函數(shù)執(zhí)行完后,參數(shù)<var>;的變量將不在作用,其作用域只在foreach函數(shù)當(dāng)中。
五、if 函數(shù)
if函數(shù)很像GNU的make所支持的條件語句——ifeq(參見前面所述的章節(jié)),if函數(shù)的語法是:
$(if <condition>;,<then-part>;)
或是
$(if <condition>;,<then-part>;,<else-part>;)
可見,if函數(shù)可以包含“else”部分,或是不含。即if函數(shù)的參數(shù)可以是兩個(gè),也可以是三個(gè)。<condition>;參數(shù)是if的表達(dá)式,如果其返回的為非空字符串,那么這個(gè)表達(dá)式就相當(dāng)于返回真,于是,<then-part>;會被計(jì)算,否則<else-part>;會被計(jì)算。
而if函數(shù)的返回值是,如果<condition>;為真(非空字符串),那個(gè)<then-part>;會是整個(gè)函數(shù)的返回值,如果<condition>;為假(空字符串),那么<else-part>;會是整個(gè)函數(shù)的返回值,此時(shí)如果<else-part>;沒有被定義,那么,整個(gè)函數(shù)返回空字串。
所以,<then-part>;和<else-part>;只會有一個(gè)被計(jì)算。
六、call函數(shù)
call函數(shù)是唯一一個(gè)可以用來創(chuàng)建新的參數(shù)化的函數(shù)。你可以寫一個(gè)非常復(fù)雜的表達(dá)式,這個(gè)表達(dá)式中,你可以定義許多參數(shù),然后你可以用call函數(shù)來向這個(gè)表達(dá)式傳遞參數(shù)。其語法是:
$(call <expression>;,<parm1>;,<parm2>;,<parm3>;...)
當(dāng)make執(zhí)行這個(gè)函數(shù)時(shí),<expression>;參數(shù)中的變量,如$(1),$(2),$(3)等,會被參數(shù)<parm1>;,<parm2>;,<parm3>;依次取代。而<expression>;的返回值就是call函數(shù)的返回值。例如:
reverse = $(1) $(2)
foo = $(call reverse,a,b)
那么,foo的值就是“a b”。當(dāng)然,參數(shù)的次序是可以自定義的,不一定是順序的,如:
reverse = $(2) $(1)
foo = $(call reverse,a,b)
此時(shí)的foo的值就是“b a”。
七、origin函數(shù)
origin函數(shù)不像其它的函數(shù),他并不操作變量的值,他只是告訴你你的這個(gè)變量是哪里來的?其語法是:
$(origin <variable>;)
注意,<variable>;是變量的名字,不應(yīng)該是引用。所以你最好不要在<variable>;中使用“$”字符。Origin函數(shù)會以其返回值來告訴你這個(gè)變量的“出生情況”,下面,是origin函數(shù)的返回值:
“undefined”
如果<variable>;從來沒有定義過,origin函數(shù)返回這個(gè)值“undefined”。
“default”
如果<variable>;是一個(gè)默認(rèn)的定義,比如“CC”這個(gè)變量,這種變量我們將在后面講述。
“environment”
如果<variable>;是一個(gè)環(huán)境變量,并且當(dāng)Makefile被執(zhí)行時(shí),“-e”參數(shù)沒有被打開。
“file”
如果<variable>;這個(gè)變量被定義在Makefile中。
“command line”
如果<variable>;這個(gè)變量是被命令行定義的。
“override”
如果<variable>;是被override指示符重新定義的。
“automatic”
如果<variable>;是一個(gè)命令運(yùn)行中的自動化變量。關(guān)于自動化變量將在后面講述。
這些信息對于我們編寫Makefile是非常有用的,例如,假設(shè)我們有一個(gè)Makefile其包了一個(gè)定義文件Make.def,在Make.def中定義了一個(gè)變量“bletch”,而我們的環(huán)境中也有一個(gè)環(huán)境變量“bletch”,此時(shí),我們想判斷一下,如果變量來源于環(huán)境,那么我們就把之重定義了,如果來源于Make.def或是命令行等非環(huán)境的,那么我們就不重新定義它。于是,在我們的Makefile中,我們可以這樣寫:
ifdef bletch
ifeq "$(origin bletch)" "environment"
bletch = barf, gag, etc.
endif
endif
當(dāng)然,你也許會說,使用override關(guān)鍵字不就可以重新定義環(huán)境中的變量了嗎?為什么需要使用這樣的步驟?是的,我們用override是可以達(dá)到這樣的效果,可是override過于粗暴,它同時(shí)會把從命令行定義的變量也覆蓋了,而我們只想重新定義環(huán)境傳來的,而不想重新定義命令行傳來的。
八、shell函數(shù)
shell函數(shù)也不像其它的函數(shù)。顧名思義,它的參數(shù)應(yīng)該就是操作系統(tǒng)Shell的命令。它和反引號“`”是相同的功能。這就是說,shell函數(shù)把執(zhí)行操作系統(tǒng)命令后的輸出作為函數(shù)返回。于是,我們可以用操作系統(tǒng)命令以及字符串處理命令awk,sed等等命令來生成一個(gè)變量,如:
contents := $(shell cat foo)
files := $(shell echo *.c)
注意,這個(gè)函數(shù)會新生成一個(gè)Shell程序來執(zhí)行命令,所以你要注意其運(yùn)行性能,如果你的Makefile中有一些比較復(fù)雜的規(guī)則,并大量使用了這個(gè)函數(shù),那么對于你的系統(tǒng)性能是有害的。特別是Makefile的隱晦的規(guī)則可能會讓你的shell函數(shù)執(zhí)行的次數(shù)比你想像的多得多。
九、控制make的函數(shù)
make提供了一些函數(shù)來控制make的運(yùn)行。通常,你需要檢測一些運(yùn)行Makefile時(shí)的運(yùn)行時(shí)信息,并且根據(jù)這些信息來決定,你是讓make繼續(xù)執(zhí)行,還是停止。
$(error <text ...>;)
產(chǎn)生一個(gè)致命的錯(cuò)誤,<text ...>;是錯(cuò)誤信息。注意,error函數(shù)不會在一被使用就會產(chǎn)生錯(cuò)誤信息,所以如果你把其定義在某個(gè)變量中,并在后續(xù)的腳本中使用這個(gè)變量,那么也是可以的。例如:
示例一:
ifdef ERROR_001
$(error error is $(ERROR_001))
endif
示例二:
ERR = $(error found an error!)
.PHONY: err
err: ; $(ERR)
示例一會在變量ERROR_001定義了后執(zhí)行時(shí)產(chǎn)生error調(diào)用,而示例二則在目錄err被執(zhí)行時(shí)才發(fā)生error調(diào)用。
$(warning <text ...>;)
這個(gè)函數(shù)很像error函數(shù),只是它并不會讓make退出,只是輸出一段警告信息,而make繼續(xù)執(zhí)行。
foreach函數(shù)和別的函數(shù)非常的不一樣。因?yàn)檫@個(gè)函數(shù)是用來做循環(huán)用的,Makefile中的foreach函數(shù)幾乎是仿照于Unix標(biāo)準(zhǔn)Shell(/bin/sh)中的for語句,或是C-Shell(/bin/csh)中的foreach語句而構(gòu)建的。它的語法是:
$(foreach <var>;,<list>;,<text>;)
這個(gè)函數(shù)的意思是,把參數(shù)<list>;中的單詞逐一取出放到參數(shù)<var>;所指定的變量中,然后再執(zhí)行<text>;所包含的表達(dá)式。每一次<text>;會返回一個(gè)字符串,循環(huán)過程中,<text>;的所返回的每個(gè)字符串會以空格分隔,最后當(dāng)整個(gè)循環(huán)結(jié)束時(shí),<text>;所返回的每個(gè)字符串所組成的整個(gè)字符串(以空格分隔)將會是foreach函數(shù)的返回值。
所以,<var>;最好是一個(gè)變量名,<list>;可以是一個(gè)表達(dá)式,而<text>;中一般會使用<var>;這個(gè)參數(shù)來依次枚舉<list>;中的單詞。舉個(gè)例子:
names := a b c d
files := $(foreach n,$(names),$(n).o)
上面的例子中,$(name)中的單詞會被挨個(gè)取出,并存到變量“n”中,“$(n).o”每次根據(jù)“$(n)”計(jì)算出一個(gè)值,這些值以空格分隔,最后作為foreach函數(shù)的返回,所以,$(files)的值是“a.o b.o c.o d.o”。
注意,foreach中的<var>;參數(shù)是一個(gè)臨時(shí)的局部變量,foreach函數(shù)執(zhí)行完后,參數(shù)<var>;的變量將不在作用,其作用域只在foreach函數(shù)當(dāng)中。
五、if 函數(shù)
if函數(shù)很像GNU的make所支持的條件語句——ifeq(參見前面所述的章節(jié)),if函數(shù)的語法是:
$(if <condition>;,<then-part>;)
或是
$(if <condition>;,<then-part>;,<else-part>;)
可見,if函數(shù)可以包含“else”部分,或是不含。即if函數(shù)的參數(shù)可以是兩個(gè),也可以是三個(gè)。<condition>;參數(shù)是if的表達(dá)式,如果其返回的為非空字符串,那么這個(gè)表達(dá)式就相當(dāng)于返回真,于是,<then-part>;會被計(jì)算,否則<else-part>;會被計(jì)算。
而if函數(shù)的返回值是,如果<condition>;為真(非空字符串),那個(gè)<then-part>;會是整個(gè)函數(shù)的返回值,如果<condition>;為假(空字符串),那么<else-part>;會是整個(gè)函數(shù)的返回值,此時(shí)如果<else-part>;沒有被定義,那么,整個(gè)函數(shù)返回空字串。
所以,<then-part>;和<else-part>;只會有一個(gè)被計(jì)算。
六、call函數(shù)
call函數(shù)是唯一一個(gè)可以用來創(chuàng)建新的參數(shù)化的函數(shù)。你可以寫一個(gè)非常復(fù)雜的表達(dá)式,這個(gè)表達(dá)式中,你可以定義許多參數(shù),然后你可以用call函數(shù)來向這個(gè)表達(dá)式傳遞參數(shù)。其語法是:
$(call <expression>;,<parm1>;,<parm2>;,<parm3>;...)
當(dāng)make執(zhí)行這個(gè)函數(shù)時(shí),<expression>;參數(shù)中的變量,如$(1),$(2),$(3)等,會被參數(shù)<parm1>;,<parm2>;,<parm3>;依次取代。而<expression>;的返回值就是call函數(shù)的返回值。例如:
reverse = $(1) $(2)
foo = $(call reverse,a,b)
那么,foo的值就是“a b”。當(dāng)然,參數(shù)的次序是可以自定義的,不一定是順序的,如:
reverse = $(2) $(1)
foo = $(call reverse,a,b)
此時(shí)的foo的值就是“b a”。
七、origin函數(shù)
origin函數(shù)不像其它的函數(shù),他并不操作變量的值,他只是告訴你你的這個(gè)變量是哪里來的?其語法是:
$(origin <variable>;)
注意,<variable>;是變量的名字,不應(yīng)該是引用。所以你最好不要在<variable>;中使用“$”字符。Origin函數(shù)會以其返回值來告訴你這個(gè)變量的“出生情況”,下面,是origin函數(shù)的返回值:
“undefined”
如果<variable>;從來沒有定義過,origin函數(shù)返回這個(gè)值“undefined”。
“default”
如果<variable>;是一個(gè)默認(rèn)的定義,比如“CC”這個(gè)變量,這種變量我們將在后面講述。
“environment”
如果<variable>;是一個(gè)環(huán)境變量,并且當(dāng)Makefile被執(zhí)行時(shí),“-e”參數(shù)沒有被打開。
“file”
如果<variable>;這個(gè)變量被定義在Makefile中。
“command line”
如果<variable>;這個(gè)變量是被命令行定義的。
“override”
如果<variable>;是被override指示符重新定義的。
“automatic”
如果<variable>;是一個(gè)命令運(yùn)行中的自動化變量。關(guān)于自動化變量將在后面講述。
這些信息對于我們編寫Makefile是非常有用的,例如,假設(shè)我們有一個(gè)Makefile其包了一個(gè)定義文件Make.def,在Make.def中定義了一個(gè)變量“bletch”,而我們的環(huán)境中也有一個(gè)環(huán)境變量“bletch”,此時(shí),我們想判斷一下,如果變量來源于環(huán)境,那么我們就把之重定義了,如果來源于Make.def或是命令行等非環(huán)境的,那么我們就不重新定義它。于是,在我們的Makefile中,我們可以這樣寫:
ifdef bletch
ifeq "$(origin bletch)" "environment"
bletch = barf, gag, etc.
endif
endif
當(dāng)然,你也許會說,使用override關(guān)鍵字不就可以重新定義環(huán)境中的變量了嗎?為什么需要使用這樣的步驟?是的,我們用override是可以達(dá)到這樣的效果,可是override過于粗暴,它同時(shí)會把從命令行定義的變量也覆蓋了,而我們只想重新定義環(huán)境傳來的,而不想重新定義命令行傳來的。
八、shell函數(shù)
shell函數(shù)也不像其它的函數(shù)。顧名思義,它的參數(shù)應(yīng)該就是操作系統(tǒng)Shell的命令。它和反引號“`”是相同的功能。這就是說,shell函數(shù)把執(zhí)行操作系統(tǒng)命令后的輸出作為函數(shù)返回。于是,我們可以用操作系統(tǒng)命令以及字符串處理命令awk,sed等等命令來生成一個(gè)變量,如:
contents := $(shell cat foo)
files := $(shell echo *.c)
注意,這個(gè)函數(shù)會新生成一個(gè)Shell程序來執(zhí)行命令,所以你要注意其運(yùn)行性能,如果你的Makefile中有一些比較復(fù)雜的規(guī)則,并大量使用了這個(gè)函數(shù),那么對于你的系統(tǒng)性能是有害的。特別是Makefile的隱晦的規(guī)則可能會讓你的shell函數(shù)執(zhí)行的次數(shù)比你想像的多得多。
九、控制make的函數(shù)
make提供了一些函數(shù)來控制make的運(yùn)行。通常,你需要檢測一些運(yùn)行Makefile時(shí)的運(yùn)行時(shí)信息,并且根據(jù)這些信息來決定,你是讓make繼續(xù)執(zhí)行,還是停止。
$(error <text ...>;)
產(chǎn)生一個(gè)致命的錯(cuò)誤,<text ...>;是錯(cuò)誤信息。注意,error函數(shù)不會在一被使用就會產(chǎn)生錯(cuò)誤信息,所以如果你把其定義在某個(gè)變量中,并在后續(xù)的腳本中使用這個(gè)變量,那么也是可以的。例如:
示例一:
ifdef ERROR_001
$(error error is $(ERROR_001))
endif
示例二:
ERR = $(error found an error!)
.PHONY: err
err: ; $(ERR)
示例一會在變量ERROR_001定義了后執(zhí)行時(shí)產(chǎn)生error調(diào)用,而示例二則在目錄err被執(zhí)行時(shí)才發(fā)生error調(diào)用。
$(warning <text ...>;)
這個(gè)函數(shù)很像error函數(shù),只是它并不會讓make退出,只是輸出一段警告信息,而make繼續(xù)執(zhí)行。