GNU make的函數(shù)提供了處理文件名、變量、文本和命令的方法。使用函數(shù)我們的Makefile可以書(shū)寫(xiě)的更加靈活和健壯??梢栽谛枰牡胤降卣{(diào)用函數(shù)來(lái)處理指定的文本(需要處理的文本作為函數(shù)的參數(shù)),函數(shù)的在調(diào)用它的地方被替換為它的處理結(jié)果。函數(shù)調(diào)用(引用)的展開(kāi)和變量引用的展開(kāi)方式相同。
GNU make函數(shù)的調(diào)用格式類(lèi)似于變量的引用,以“$”開(kāi)始表示一個(gè)引用。語(yǔ)法格式如下:
$(FUNCTION ARGUMENTS)
或者:
${FUNCTION ARGUMENTS}
對(duì)于函數(shù)調(diào)用的格式有以下幾點(diǎn)說(shuō)明:
1. 調(diào)用語(yǔ)法格式中“FUNCTION”是需要調(diào)用的函數(shù)名,它應(yīng)該是make內(nèi)嵌的函數(shù)名。對(duì)于用戶(hù)自己的函數(shù)需要通過(guò)make的“call”函數(shù)來(lái)間接調(diào)用。
2. “ARGUMENTS”是函數(shù)的參數(shù),參數(shù)和函數(shù)名之間使用若干個(gè)空格或者[tab]字符分割(建議使用一個(gè)空格,這樣不僅使在書(shū)寫(xiě)上比較直觀,更重要的是當(dāng)你不能確定是否可以使用[Tab]的時(shí)候,避免不必要的麻煩);如果存在多個(gè)參數(shù)時(shí),參數(shù)之間使用逗號(hào)“,”分開(kāi)。
3. 以“$”開(kāi)頭,使用成對(duì)的圓括號(hào)或花括號(hào)把函數(shù)名和參數(shù)括起(在Makefile中,圓括號(hào)和花括號(hào)在任何地方必須成對(duì)出現(xiàn))。參數(shù)中存在變量或者函數(shù)的引用時(shí),對(duì)它們所使用的分界符(圓括號(hào)或者花括號(hào))建議和引用函數(shù)的相同,不使用兩種不同的括號(hào)。推薦在變量引用和函數(shù)引用中統(tǒng)一使用圓括號(hào);這樣在使用“vim”編輯器書(shū)寫(xiě)Makefile時(shí),使用圓括它可以亮度顯式make的內(nèi)嵌函數(shù)名,避免函數(shù)名的拼寫(xiě)錯(cuò)誤。在Makefile中應(yīng)該這樣來(lái)書(shū)寫(xiě)“$(sort $(x))”;而不是“$(sort ${x})”和其它幾種。
4. 函數(shù)處理參數(shù)時(shí),參數(shù)中如果存在對(duì)其它變量或者函數(shù)的引用,首先對(duì)這些引用進(jìn)行展開(kāi)得到參數(shù)的實(shí)際內(nèi)容。而后才對(duì)它們進(jìn)行處理。參數(shù)的展開(kāi)順序是按照參數(shù)的先后順序來(lái)進(jìn)行的。
5. 書(shū)寫(xiě)時(shí),函數(shù)的參數(shù)不能出現(xiàn)逗號(hào)“,”和空格。這是因?yàn)槎禾?hào)被作為多個(gè)參數(shù)的分隔符,前導(dǎo)空格會(huì)被忽略。在實(shí)際書(shū)寫(xiě)Makefile時(shí),當(dāng)有逗號(hào)或者空格作為函數(shù)的參數(shù)時(shí),需要把它們賦值給一個(gè)變量,在函數(shù)的參數(shù)中引用這個(gè)變量來(lái)實(shí)現(xiàn)。我們來(lái)看一個(gè)這樣的例子:
comma:= ,
empty:=
space:= $(empty) $(empty)
foo:= a b c
bar:= $(subst $(space),$(comma),$(foo))
這樣我們就實(shí)現(xiàn)了“bar”的值是“a,b,c”。
以下是GNU make內(nèi)嵌的文本(字符串)處理函數(shù)。
函數(shù)名稱(chēng):字符串替換函數(shù)—subst。
函數(shù)功能:把字串“TEXT”中的“FROM”字符替換為“TO”。
返回值:替換后的新字符串。
示例:
$(subst ee,EE,feet on the street)
替換“feet on the street”中的“ee”為“EE”,結(jié)果得到字符串“fEEt on the strEEt”。
函數(shù)名稱(chēng):模式替換函數(shù)—patsubst。
函數(shù)功能:搜索“TEXT”中以空格分開(kāi)的單詞,將否符合模式“TATTERN”替換為“REPLACEMENT”。參數(shù)“PATTERN”中可以使用模式通配符“%”來(lái)代表一個(gè)單詞中的若干字符。如果參數(shù)“REPLACEMENT”中也包含一個(gè)“%”,那么“REPLACEMENT”中的“%”將是“TATTERN”中的那個(gè)“%”所代表的字符串。在“TATTERN”和“REPLACEMENT”中,只有第一個(gè)“%”被作為模式字符來(lái)處理,之后出現(xiàn)的不再作模式字符(作為一個(gè)字符)。在參數(shù)中如果需要將第一個(gè)出現(xiàn)的“%”作為字符本身而不作為模式字符時(shí),可使用反斜杠“\”進(jìn)行轉(zhuǎn)義處理(轉(zhuǎn)義處理的機(jī)制和使用靜態(tài)模式的轉(zhuǎn)義一致,具體可參考 5.12.1 靜態(tài)模式規(guī)則的語(yǔ)法 一小節(jié))。
返回值:替換后的新字符串。
函數(shù)說(shuō)明:參數(shù)“TEXT”單詞之間的多個(gè)空格在處理時(shí)被合并為一個(gè)空格,并忽略前導(dǎo)和結(jié)尾空格。
示例:
$(patsubst %.c,%.o,x.c.c bar.c)
把字串“x.c.c bar.c”中以.c結(jié)尾的單詞替換成以.o結(jié)尾的字符。函數(shù)的返回結(jié)果是“x.c.o bar.o”
本文的第六章在 變量的高級(jí)用法的第一小節(jié) 中曾經(jīng)討論過(guò)變量的替換引用,它是一個(gè)簡(jiǎn)化版的“patsubst”函數(shù)在變量引用過(guò)程的實(shí)現(xiàn)。變量替換引用中:
$(VAR:PATTERN=REPLACEMENT)
就相當(dāng)于:
$(patsubst PATTERN,REPLACEMENT,$(VAR))
而另外一種更為簡(jiǎn)單的替換字符后綴的實(shí)現(xiàn):
$(VAR:SUFFIX=REPLACEMENT)
它等于:
$(patsubst %SUFFIX,%REPLACEMENT,$(VAR))
例如我們存在一個(gè)代表所有.o文件的變量。定義為“objects = foo.o bar.o baz.o”。為了得到這些.o文件所對(duì)應(yīng)的.c源文件。我們可以使用以下兩種方式的任意一個(gè):
$(objects:.o=.c)
$(patsubst %.o,%.c,$(objects))
函數(shù)名稱(chēng):去空格函數(shù)—strip。
函數(shù)功能:去掉字串(若干單詞,使用若干空字符分割)“STRINT”開(kāi)頭和結(jié)尾的空字符,并將其中多個(gè)連續(xù)空字符合并為一個(gè)空字符。
返回值:無(wú)前導(dǎo)和結(jié)尾空字符、使用單一空格分割的多單詞字符串。
函數(shù)說(shuō)明:空字符包括空格、[Tab]等不可顯示字符。
示例:
STR = a b c
LOSTR = $(strip $(STR))
結(jié)果是“a b c”。
“strip”函數(shù)經(jīng)常用在條件判斷語(yǔ)句的表達(dá)式中,確保表達(dá)式比較的可靠和健壯!
函數(shù)名稱(chēng):查找字符串函數(shù)—findstring。
函數(shù)功能:搜索字串“IN”,查找“FIND”字串。
返回值:如果在“IN”之中存在“FIND”,則返回“FIND”,否則返回空。
函數(shù)說(shuō)明:字串“IN”之中可以包含空格、[Tab]。搜索需要是嚴(yán)格的文本匹配。
示例:
$(findstring a,a b c)
$(findstring a,b c)
第一個(gè)函數(shù)結(jié)果是字“a”;第二個(gè)值為空字符。
函數(shù)名稱(chēng):過(guò)濾函數(shù)—filter。
函數(shù)功能:過(guò)濾掉字串“TEXT”中所有不符合模式“PATTERN”的單詞,保留所有符合此模式的單詞??梢允褂枚鄠€(gè)模式。模式中一般需要包含模式字符“%”。存在多個(gè)模式時(shí),模式表達(dá)式之間使用空格分割。
返回值:空格分割的“TEXT”字串中所有符合模式“PATTERN”的字串。
函數(shù)說(shuō)明:“filter”函數(shù)可以用來(lái)去除一個(gè)變量中的某些字符串,我們下邊的例子中就是用到了此函數(shù)。
示例:
sources := foo.c bar.c baz.s ugh.h
foo: $(sources)
cc $(filter %.c %.s,$(sources)) -o foo
使用“$(filter %.c %.s,$(sources))”的返回值給cc來(lái)編譯生成目標(biāo)“foo”,函數(shù)返回值為“foo.c bar.c baz.s”。
函數(shù)名稱(chēng):反過(guò)濾函數(shù)—filter-out。
函數(shù)功能:和“filter”函數(shù)實(shí)現(xiàn)的功能相反。過(guò)濾掉字串“TEXT”中所有符合模式“PATTERN”的單詞,保留所有不符合此模式的單詞。可以有多個(gè)模式。存在多個(gè)模式時(shí),模式表達(dá)式之間使用空格分割。。
返回值:空格分割的“TEXT”字串中所有不符合模式“PATTERN”的字串。
函數(shù)說(shuō)明:“filter-out”函數(shù)也可以用來(lái)去除一個(gè)變量中的某些字符串,(實(shí)現(xiàn)和“filter”函數(shù)相反)。
示例:
objects=main1.o foo.o main2.o bar.o
mains=main1.o main2.o
$(filter-out $(mains),$(objects))
實(shí)現(xiàn)了去除變量“objects”中“mains”定義的字串(文件名)功能。它的返回值為“foo.o bar.o”。
函數(shù)名稱(chēng):排序函數(shù)—sort。
函數(shù)功能:給字串“LIST”中的單詞以首字母為準(zhǔn)進(jìn)行排序(升序),并取掉重復(fù)的單詞。
返回值:空格分割的沒(méi)有重復(fù)單詞的字串。
函數(shù)說(shuō)明:兩個(gè)功能,排序和去字串中的重復(fù)單詞??梢詥为?dú)使用其中一個(gè)功能。
示例:
$(sort foo bar lose foo)
返回值為:“bar foo lose” 。
函數(shù)名稱(chēng):取單詞函數(shù)—word。
函數(shù)功能:取字串“TEXT”中第“N”個(gè)單詞(“N”的值從1開(kāi)始)。
返回值:返回字串“TEXT”中第“N”個(gè)單詞。
函數(shù)說(shuō)明:如果“N”值大于字串“TEXT”中單詞的數(shù)目,返回空字符串。如果“N”為0,出錯(cuò)!
示例:
$(word 2, foo bar baz)
返回值為“bar”。
函數(shù)名稱(chēng):取字串函數(shù)—wordlist。
函數(shù)功能:從字串“TEXT”中取出從“S”開(kāi)始到“E”的單詞串。“S”和“E”表示單詞在字串中位置的數(shù)字。
返回值:字串“TEXT”中從第“S”到“E”(包括“E”)的單詞字串。
函數(shù)說(shuō)明:“S”和“E”都是從1開(kāi)始的數(shù)字。
當(dāng)“S”比“TEXT”中的字?jǐn)?shù)大時(shí),返回空。如果“E”大于“TEXT”字?jǐn)?shù),返回從“S”開(kāi)始,到“TEXT”結(jié)束的單詞串。如果“S”大于“E”,返回空。
示例:
$(wordlist 2, 3, foo bar baz)
返回值為:“bar baz”。
函數(shù)名稱(chēng):統(tǒng)計(jì)單詞數(shù)目函數(shù)—words。
函數(shù)功能:字算字串“TEXT”中單詞的數(shù)目。
返回值:“TEXT”字串中的單詞數(shù)。
示例:
$(words, foo bar)
返回值是“2”。所以字串“TEXT”的最后一個(gè)單詞就是:$(word $(words TEXT),TEXT)。
函數(shù)名稱(chēng):取首單詞函數(shù)—firstword。
函數(shù)功能:取字串“NAMES…”中的第一個(gè)單詞。
返回值:字串“NAMES…”的第一個(gè)單詞。
函數(shù)說(shuō)明:“NAMES”被認(rèn)為是使用空格分割的多個(gè)單詞(名字)的序列。函數(shù)忽略“NAMES…”中除第一個(gè)單詞以外的所有的單詞。
示例:
$(firstword foo bar)
返回值為“foo”。函數(shù)“firstword”實(shí)現(xiàn)的功能等效于“$(word 1, NAMES…)”。
以上11個(gè)函數(shù)是make內(nèi)嵌的的文本處理函數(shù)。書(shū)寫(xiě)Makefile時(shí)可搭配使用來(lái)實(shí)現(xiàn)復(fù)雜功能。最后我們使用這些函數(shù)來(lái)實(shí)現(xiàn)一個(gè)實(shí)際應(yīng)用。例子中我們使用函數(shù)“subst”和“patsbust”。Makefile中可以使用變量“VPATH”來(lái)指定搜索路徑。對(duì)于源代碼所包含的頭文件的搜索路徑需要使用gcc的“-I”參數(shù)指定目錄來(lái)實(shí)現(xiàn),“VPATH”羅列的目錄是用冒號(hào)“:”分割的。如下就是Makefile的片段:
……
VPATH = src:../includes
override CFLAGS += $(patsubst %,-I%,$(subst :, ,$(VPATH)))
…….
那么第二條語(yǔ)句所實(shí)現(xiàn)的功能就是“CFLAGS += -Isrc –I../includes”。
GNU make除支持上一節(jié)所介紹的文本處理函數(shù)之外,還支持一些針對(duì)于文件名的處理函數(shù)。這些函數(shù)主要用來(lái)對(duì)一系列空格分割的文件名進(jìn)行轉(zhuǎn)換,這些函數(shù)的參數(shù)被作為若干個(gè)文件名來(lái)對(duì)待。函數(shù)對(duì)作為參數(shù)的一組文件名按照一定方式進(jìn)行處理并返回空格分割的多個(gè)文件名序列。
函數(shù)名稱(chēng):取目錄函數(shù)—dir。
函數(shù)功能:從文件名序列“NAMES…”中取出各個(gè)文件名的目錄部分。文件名的目錄部分就是包含在文件名中的最后一個(gè)斜線(xiàn)(“/”)(包括斜線(xiàn))之前的部分。
返回值:空格分割的文件名序列“NAMES…”中每一個(gè)文件的目錄部分。
函數(shù)說(shuō)明:如果文件名中沒(méi)有斜線(xiàn),認(rèn)為此文件為當(dāng)前目錄(“./”)下的文件。
示例:
$(dir src/foo.c hacks)
返回值為“src/ ./”。
函數(shù)名稱(chēng):取文件名函數(shù)——notdir。
函數(shù)功能:從文件名序列“NAMES…”中取出非目錄部分。目錄部分是指最后一個(gè)斜線(xiàn)(“/”)(包括斜線(xiàn))之前的部分。刪除所有文件名中的目錄部分,只保留非目錄部分。
返回值:文件名序列“NAMES…”中每一個(gè)文件的非目錄部分。
函數(shù)說(shuō)明:如果“NAMES…”中存在不包含斜線(xiàn)的文件名,則不改變這個(gè)文件名。以反斜線(xiàn)結(jié)尾的文件名,是用空串代替,因此當(dāng)“NAMES…”中存在多個(gè)這樣的文件名時(shí),返回結(jié)果中分割各個(gè)文件名的空格數(shù)目將不確定!這是此函數(shù)的一個(gè)缺陷。
示例:
$(notdir src/foo.c hacks)
返回值為:“foo.c hacks”。
函數(shù)名稱(chēng):取后綴函數(shù)—suffix。
函數(shù)功能:從文件名序列“NAMES…”中取出各個(gè)文件名的后綴。后綴是文件名中最后一個(gè)以點(diǎn)“.”開(kāi)始的(包含點(diǎn)號(hào))部分,如果文件名中不包含一個(gè)點(diǎn)號(hào),則為空。
返回值:以空格分割的文件名序列“NAMES…”中每一個(gè)文件的后綴序列。
函數(shù)說(shuō)明:“NAMES…”是多個(gè)文件名時(shí),返回值是多個(gè)以空格分割的單詞序列。如果文件名沒(méi)有后綴部分,則返回空。
示例:
$(suffix src/foo.c src-1.0/bar.c hacks)
返回值為“.c .c”。
函數(shù)名稱(chēng):取前綴函數(shù)—basename。
函數(shù)功能:從文件名序列“NAMES…”中取出各個(gè)文件名的前綴部分(點(diǎn)號(hào)之后的部分)。前綴部分指的是文件名中最后一個(gè)點(diǎn)號(hào)之前的部分。
返回值:空格分割的文件名序列“NAMES…”中各個(gè)文件的前綴序列。如果文件沒(méi)有前綴,則返回空字串。
函數(shù)說(shuō)明:如果“NAMES…”中包含沒(méi)有后綴的文件名,此文件名不改變。如果一個(gè)文件名中存在多個(gè)點(diǎn)號(hào),則返回值為此文件名的最后一個(gè)點(diǎn)號(hào)之前的文件名部分。
示例:
$(basename src/foo.c src-1.0/bar.c /home/jack/.font.cache-1 hacks)
返回值為:“src/foo src-1.0/bar /home/jack/.font hacks”。
函數(shù)名稱(chēng):加后綴函數(shù)—addsuffix。
函數(shù)功能:為“NAMES…”中的每一個(gè)文件名添加后綴“SUFFIX”。參數(shù)“NAMES…”為空格分割的文件名序列,將“SUFFIX”追加到此序列的每一個(gè)文件名的末尾。
返回值:以單空格分割的添加了后綴“SUFFIX”的文件名序列。
函數(shù)說(shuō)明:
示例:
$(addsuffix .c,foo bar)
返回值為“foo.c bar.c”。
函數(shù)名稱(chēng):加前綴函數(shù)—addprefix。
函數(shù)功能:為“NAMES…”中的每一個(gè)文件名添加前綴“PREFIX”。參數(shù)“NAMES…”是空格分割的文件名序列,將“SUFFIX”添加到此序列的每一個(gè)文件名之前。
返回值:以單空格分割的添加了前綴“PREFIX”的文件名序列。
函數(shù)說(shuō)明:
示例:
$(addprefix src/,foo bar)
返回值為“src/foo src/bar”。
函數(shù)名稱(chēng):?jiǎn)卧~連接函數(shù)——join。
函數(shù)功能:將字串“LIST1”和字串“LIST2”各單詞進(jìn)行對(duì)應(yīng)連接。就是將“LIST2”中的第一個(gè)單詞追加“LIST1”第一個(gè)單詞字后合并為一個(gè)單詞;將“LIST2”中的第二個(gè)單詞追加到“LIST1”的第一個(gè)單詞之后并合并為一個(gè)單詞,……依次列推。
返回值:?jiǎn)慰崭穹指畹暮喜⒑蟮淖郑ㄎ募┬蛄小?/span>
函數(shù)說(shuō)明:如果“LIST1”和“LIST2”中的字?jǐn)?shù)目不一致時(shí),兩者中多余部分將被作為返回序列的一部分。
示例1:
$(join a b , .c .o)
返回值為:“a.c b.o”。
示例2:
$(join a b c , .c .o)
返回值為:“a.c b.o c”。
函數(shù)名稱(chēng):獲取匹配模式文件名函數(shù)—wildcard
函數(shù)功能:列出當(dāng)前目錄下所有符合模式“PATTERN”格式的文件名。
返回值:空格分割的、存在當(dāng)前目錄下的所有符合模式“PATTERN”的文件名。
函數(shù)說(shuō)明:“PATTERN”使用shell可識(shí)別的通配符,包括“?”(單字符)、“*”(多字符)等。
示例:
$(wildcard *.c)
返回值為當(dāng)前目錄下所有.c源文件列表。
函數(shù)“foreach”不同于其它函數(shù)。它是一個(gè)循環(huán)函數(shù)。類(lèi)似于Linux的shell中的for語(yǔ)句。
Ø “foreach”函數(shù)的語(yǔ)法:
$(foreach VAR,LIST,TEXT)
Ø 函數(shù)功能:這個(gè)函數(shù)的工作過(guò)程是這樣的:如果需要(存在變量或者函數(shù)的引用),首先展開(kāi)變量“VAR”和“LIST”的引用;而表達(dá)式“TEXT”中的變量引用不展開(kāi)。執(zhí)行時(shí)把“LIST”中使用空格分割的單詞依次取出賦值給變量“VAR”,然后執(zhí)行“TEXT”表達(dá)式。重復(fù)直到“LIST”的最后一個(gè)單詞(為空時(shí)結(jié)束)。“TEXT”中的變量或者函數(shù)引用在執(zhí)行時(shí)才被展開(kāi),因此如果在“TEXT”中存在對(duì)“VAR”的引用,那么“VAR”的值在每一次展開(kāi)式將會(huì)到的不同的值。
Ø 返回值:空格分割的多次表達(dá)式“TEXT”的計(jì)算的結(jié)果。
我們來(lái)看一個(gè)例子,定義變量“files”,它的值為四個(gè)目錄(變量“dirs”代表的a、b、c、d四個(gè)目錄)下的文件列表:
dirs := a b c d
files := $(foreach dir,$(dirs),$(wildcard $(dir)/*))
例子中,“TEXT”的表達(dá)式為“$(wildcard $(dir)/*)”。表達(dá)式第一次執(zhí)行時(shí)將展開(kāi)為“$(wildcard a/*)”;第二次執(zhí)行時(shí)將展開(kāi)為“$(wildcard b/*)”;第三次展開(kāi)為“$(wildcard c/*)”;….;以此類(lèi)推。所以此函數(shù)所實(shí)現(xiàn)的功能就和一下語(yǔ)句等價(jià):
files := $(wildcard a/* b/* c/* d/*)
當(dāng)函數(shù)的“TEXT”表達(dá)式過(guò)于復(fù)雜時(shí),我們可以通過(guò)定義一個(gè)中間變量,此變量代表表達(dá)式的一部分。并在函數(shù)的“TEXT”中引用這個(gè)變量。上邊的例子也可以這樣來(lái)實(shí)現(xiàn):
find_files = $(wildcard $(dir)/*)
dirs := a b c d
files := $(foreach dir,$(dirs),$(find_files))
在這里我們定義了一個(gè)變量(也可以稱(chēng)之為表達(dá)式),需要注意,在這里定義的是“遞歸展開(kāi)”時(shí)的變量“find_files”。保證了定義時(shí)變量值中的引用不展開(kāi),而是在表達(dá)式被函數(shù)處理時(shí)才展開(kāi)(如果這里使用直接展開(kāi)式的定義將是無(wú)效的表達(dá)式)。
Ø 函數(shù)說(shuō)明:函數(shù)中參數(shù)“VAR”是一個(gè)局部的臨時(shí)變量,它只在“foreach”函數(shù)的上下文中有效,它的定義不會(huì)影響其它部分定義的同名“VAR”變量的值。在函數(shù)的執(zhí)行過(guò)程中它是一個(gè)“直接展開(kāi)”式變量。
在使用函數(shù)“foreach”時(shí),需要注意:變量“VAR”的名字。我們建議使用一個(gè)單詞、最好能夠表達(dá)其含義的名字,不要使用一個(gè)奇怪的字符串作為變量名。雖然執(zhí)行是不會(huì)發(fā)生錯(cuò)誤,但是會(huì)讓人很費(fèi)解。
沒(méi)有人會(huì)喜歡這種方式,盡管可能它可以正常工作:
files := $(foreach Esta escrito en espanol!,b c ch,$(find_files))
函數(shù)“if”提供了一個(gè)在函數(shù)上下文中實(shí)現(xiàn)條件判斷的功能。就像make所支持的條件語(yǔ)句—ifeq一樣。
Ø 函數(shù)語(yǔ)法:
$(if CONDITION,THEN-PART[,ELSE-PART])
Ø 函數(shù)功能:第一個(gè)參數(shù)“CONDITION”,在函數(shù)執(zhí)行時(shí)忽略其前導(dǎo)和結(jié)尾空字符,如果包含對(duì)其他變量或者函數(shù)的引用則進(jìn)行展開(kāi)。如果“CONDITION”的展開(kāi)結(jié)果非空,則條件為真,就將第二個(gè)參數(shù)“THEN_PATR”作為函數(shù)的計(jì)算表達(dá)式;“CONDITION”的展開(kāi)結(jié)果為空,將第三個(gè)參數(shù)“ELSE-PART”作為函數(shù)的表達(dá)式,函數(shù)的返回結(jié)果為有效表達(dá)式的計(jì)算結(jié)果。
Ø 返回值:根據(jù)條件決定函數(shù)的返回值是第一個(gè)或者第二個(gè)參數(shù)表達(dá)式的計(jì)算結(jié)果。當(dāng)不存在第三個(gè)參數(shù)“ELSE-PART”,并且“CONDITION”展開(kāi)為空,函數(shù)返回空。
Ø 函數(shù)說(shuō)明:函數(shù)的條件表達(dá)式“CONDITION”決定了函數(shù)的返回值只能是“THEN-PART”或者“ELSE-PART”兩個(gè)之一的計(jì)算結(jié)果。
Ø 函數(shù)示例:
SUBDIR += $(if $(SRC_DIR) $(SRC_DIR),/home/src)
函數(shù)的結(jié)果是:如果“SRC_DIR”變量值不為空,則將變量“SRC_DIR”指定的目錄作為一個(gè)子目錄;否則將目錄“/home/src”作為一個(gè)子目錄。
“call”函數(shù)是唯一一個(gè)可以創(chuàng)建定制化參數(shù)函數(shù)的引用函數(shù)。使用這個(gè)函數(shù)可以實(shí)現(xiàn)對(duì)用戶(hù)自己定義函數(shù)引用。我們可以將一個(gè)變量定義為一個(gè)復(fù)雜的表達(dá)式,用“call”函數(shù)根據(jù)不同的參數(shù)對(duì)它進(jìn)行展開(kāi)來(lái)獲得不同的結(jié)果。
Ø 函數(shù)語(yǔ)法:
$(call VARIABLE,PARAM,PARAM,...)
Ø 函數(shù)功能:在執(zhí)行時(shí),將它的參數(shù)“PARAM”依次賦值給臨時(shí)變量“$(1)”、“$(2)”(這些臨時(shí)變量定義在“VARIABLE”的值中,參考下邊的例子)…… call函數(shù)對(duì)參數(shù)的數(shù)目沒(méi)有限制,也可以沒(méi)有參數(shù)值,沒(méi)有參數(shù)值的“call”沒(méi)有任何實(shí)際存在的意義。執(zhí)行時(shí)變量“VARIABLE”被展開(kāi)為在函數(shù)上下文有效的臨時(shí)變量,變量定義中的“$(1)”作為第一個(gè)參數(shù),并將函數(shù)參數(shù)值中的第一個(gè)參數(shù)賦值給它;變量中的“$(2)”一樣被賦值為函數(shù)的第二個(gè)參數(shù)值;依此類(lèi)推(變量$(0)代表變量“VARIABLE”本身)。之后對(duì)變量“VARIABLE” 表達(dá)式的計(jì)算值。
Ø 返回值:參數(shù)值“PARAM”依次替換“$(1)”、“$(2)”…… 之后變量“VARIABLE”定義的表達(dá)式的計(jì)算值。
Ø 函數(shù)說(shuō)明:1. 函數(shù)中“VARIBLE”是一個(gè)變量名,而不是變量引用。因此,通常“call”函數(shù)中的“VARIABLE”中不包含“$”(當(dāng)然,除非此變量名是一個(gè)計(jì)算的變量名)。2. 當(dāng)變量“VARIBLE”是一個(gè)make內(nèi)嵌的函數(shù)名時(shí)(如“if”、“foreach”、“strip”等),對(duì)“PARAM”參數(shù)的使用需要注意,因?yàn)椴缓线m或者不正確的參數(shù)將會(huì)導(dǎo)致函數(shù)的返回值難以預(yù)料。3. 函數(shù)中多個(gè)“PARAM”之間使用逗號(hào)分割。4. 變量“VARIABLE”在定義時(shí)不能定義為直接展開(kāi)式!只能定義為遞歸展開(kāi)式。
Ø 函數(shù)示例:
首先,來(lái)看一個(gè)簡(jiǎn)單的例子。
示例1:
reverse = $(2) $(1)
foo = $(call reverse,a,b)
變量“foo”的值為“ba”。這里變量“reverse”中的參數(shù)定義順序可以根據(jù)需要來(lái)調(diào)整,并不是需要按照“$(1)”、“$(2)”、“$(3)”…… 這樣的順序來(lái)定義。
看一個(gè)稍微復(fù)雜一些的例子。我們定義了一個(gè)宏“pathsearch”來(lái)在“PATH”路徑中搜索第一個(gè)指定的程序。
示例2:
pathsearch = $(firstword $(wildcard $(addsuffix /$(1),$(subst :, ,$(PATH)))))
LS := $(call pathsearch,ls)
變量“LS”的結(jié)果為“/bin/sh”。執(zhí)行過(guò)程:函數(shù)“subst”將環(huán)境變量“PATH”轉(zhuǎn)換為空格分割的搜索路徑列表;“addsuffix”構(gòu)造出可能的可執(zhí)行程序“$(1)”(這里是“ls”)帶路徑的完整文件名(如:“/bin/$(1)”),之后使用函數(shù)“wildcard”匹配,最后“firstword”函數(shù)取第一個(gè)文件名。
函數(shù)“call”以可以套嵌使用。每一層“call”函數(shù)的調(diào)用都為它自己的局部變量“$(1)”等賦值,覆蓋上一層函數(shù)為它所賦的值。
示例3:
map = $(foreach a,$(2),$(call $(1),$(a)))
o = $(call map,origin,o map MAKE)
那么變量“o”的值就為“file file default”。我們這里使用了“origin”函數(shù)。我們分析函數(shù)的執(zhí)行過(guò)程:首先,“o=$(call map,origin, o map MAKE)”這個(gè)函數(shù)調(diào)用使用了變量“map”所定義的表達(dá)式;使用內(nèi)嵌函數(shù)名“origin”作為它的第一個(gè)參數(shù)值,使用Makefile中的變量“o map MAKE”作為他的第二個(gè)參數(shù)值。當(dāng)使用“call”函數(shù)展開(kāi)后等價(jià)于“$(foreach a,o map MAKE,$(origin $(a)))”。
Ø 注意:和其它函數(shù)一樣,“call”函數(shù)會(huì)保留出現(xiàn)在其參數(shù)值列表中的空字符。因此在使用參數(shù)值時(shí)對(duì)空格處理要格外小心。如果參數(shù)中存在多余的空格,函數(shù)可能會(huì)返回一個(gè)莫名奇妙的值。為了安全,在變量作為“call”函數(shù)參數(shù)值之前,應(yīng)去掉其值中的多余空格。
函數(shù)“value”提供了一種在不對(duì)變量進(jìn)行展開(kāi)的情況下獲取變量值的方法。注意:并不是說(shuō)函數(shù)會(huì)取消之前已經(jīng)執(zhí)行過(guò)的替換擴(kuò)展。比如:定義了一個(gè)直接展開(kāi)式的變量,此變量在定義過(guò)程中對(duì)其它變量的引用進(jìn)行替換而得到自身的值。在使用“value”函數(shù)取這個(gè)變量進(jìn)行取值時(shí),得到的是不包含任何引用值。而不是將定義過(guò)程中的替換展開(kāi)動(dòng)作取消后包含引用的定義值。就是說(shuō)此過(guò)程不能取消此變量在定義時(shí)已經(jīng)發(fā)生了的替換展開(kāi)動(dòng)作。
Ø 函數(shù)語(yǔ)法:
$(value VARIABLE)
Ø 函數(shù)功能:不對(duì)變量“VARIBLE”進(jìn)行任何展開(kāi)操作,直接返回變量“VARIBALE”的值。這里“VARIABLE”是一個(gè)變量名,一般不包含“$”(除非計(jì)算的變量名),
Ø 返回值:變量“VARIBALE”所定義文本值(如果變量定義為遞歸展開(kāi)式,其中包含對(duì)其他變量或者函數(shù)的引用,那么函數(shù)不對(duì)這些引用進(jìn)行展開(kāi)。函數(shù)的返回值是包含有引用值)。
Ø 函數(shù)說(shuō)明:
示例:
# sample Makefile
FOO = $PATH
all:
@echo $(FOO)
@echo $(value FOO)
執(zhí)行make,可以看到的結(jié)果是:第一行為:“ATH”。這是因?yàn)樽兞?#8220;FOO”定義為“$PATH”,所以展開(kāi)為“ATH”(“$P”為空)。
第二行才是我們需要顯示的系統(tǒng)環(huán)境變量“PATH”的值(value函數(shù)得到變量“FOO”的值為“$PATH”)。
Ø 函數(shù)功能:函數(shù)“eval”是一個(gè)比較特殊的函數(shù)。使用它可以在Makefile中構(gòu)造一個(gè)可變的規(guī)則結(jié)構(gòu)關(guān)系(依賴(lài)關(guān)系鏈),其中可以使用其它變量和函數(shù)。函數(shù)“eval”對(duì)它的參數(shù)進(jìn)行展開(kāi),展開(kāi)的結(jié)果作為Makefile的一部分,make可以對(duì)展開(kāi)內(nèi)容進(jìn)行語(yǔ)法解析。展開(kāi)的結(jié)果可以包含一個(gè)新變量、目標(biāo)、隱含規(guī)則或者是明確規(guī)則等。也就是說(shuō)此函數(shù)的功能主要是:根據(jù)其參數(shù)的關(guān)系、結(jié)構(gòu),對(duì)它們進(jìn)行替換展開(kāi)。
Ø 返回值:函數(shù)“eval”的返回值時(shí)空,也可以說(shuō)沒(méi)有返回值。
Ø 函數(shù)說(shuō)明:“eval”函數(shù)執(zhí)行時(shí)會(huì)對(duì)它的參數(shù)進(jìn)行兩次展開(kāi)。第一次展開(kāi)過(guò)程發(fā)是由函數(shù)本身完成的,第二次是函數(shù)展開(kāi)后的結(jié)果被作為Makefile內(nèi)容時(shí)由make解析時(shí)展開(kāi)的。明確這一過(guò)程對(duì)于使用“eval”函數(shù)非常重要。理解了函數(shù)“eval”二次展開(kāi)的過(guò)程后。實(shí)際使用時(shí),如果在函數(shù)的展開(kāi)結(jié)果中存在引用(格式為:$(x)),那么在函數(shù)的參數(shù)中應(yīng)該使用“$$”來(lái)代替“$”。因?yàn)檫@一點(diǎn),所以通常它的參數(shù)中會(huì)使用函數(shù)“value”來(lái)取一個(gè)變量的文本值。
我們看一個(gè)例子。例子看起來(lái)似乎非常復(fù)雜,因?yàn)樗C合了其它的一些概念和函數(shù)。不過(guò)我們可以考慮兩點(diǎn):其一,通常實(shí)際一個(gè)模板的定義可能比例子中的更為復(fù)雜;其二,我們可以實(shí)現(xiàn)一個(gè)復(fù)雜通用的模板,在所有Makefile中包含它,亦可作到一勞永逸。相信這一點(diǎn)可能是大多數(shù)程序員所推崇的。
示例:
# sample Makefile
PROGRAMS = server client
server_OBJS = server.o server_priv.o server_access.o
server_LIBS = priv protocol
client_OBJS = client.o client_api.o client_mem.o
client_LIBS = protocol
# Everything after this is generic
.PHONY: all
all: $(PROGRAMS)
define PROGRAM_template
$(1): $$($(1)_OBJ) $$($(1)_LIBS:%=-l%)
ALL_OBJS += $$($(1)_OBJS)
endef
$(foreach prog,$(PROGRAMS),$(eval $(call PROGRAM_template,$(prog))))
$(PROGRAMS):
$(LINK.o) $^ $(LDLIBS) -o $@
clean:
rm -f $(ALL_OBJS) $(PROGRAMS)
來(lái)看一下這個(gè)例子:它實(shí)現(xiàn)的功能是完成“PROGRAMS”的編譯鏈接。例子中“$(LINK.o)”為“$(CC) $(LDFLAGS)”,意思是對(duì)所有的.o文件和指定的庫(kù)文件進(jìn)行鏈接。
“$(foreach prog,$(PROGRAM),$(eval $(call PROGRAM_template,$(prog))))”展開(kāi)為:
server : $(server_OBJS) –l$(server_LIBS)
client : $(client_OBJS) –l$(client_LIBS)
函數(shù)“origin”和其他函數(shù)不同,函數(shù)“origin”的動(dòng)作不是操作變量(它的參數(shù))。它只是獲取此變量(參數(shù))相關(guān)的信息,告訴我們這個(gè)變量的出處(定義方式)。
Ø 函數(shù)語(yǔ)法:
$(origin VARIABLE)
Ø 函數(shù)功能:函數(shù)“origin”查詢(xún)參數(shù)“VARIABLE”(一個(gè)變量名)的出處。
Ø 函數(shù)說(shuō)明:“VARIABLE”是一個(gè)變量名而不是一個(gè)變量的引用。因此通常它不包含“$”(當(dāng)然,計(jì)算的變量名例外)。
Ø 返回值:返回“VARIABLE”的定義方式。用字符串表示。
函數(shù)的返回情況有以下幾種:
1. undefined
變量“VARIABLE”沒(méi)有被定義。
2. default
變量“VARIABLE”是一個(gè)默認(rèn)定義(內(nèi)嵌變量)。如“CC”、“MAKE”、“RM”等變量。如果在Makefile中重新定義這些變量,函數(shù)返回值將相應(yīng)發(fā)生變化。
3. environment
變量“VARIABLE”是一個(gè)系統(tǒng)環(huán)境變量,并且make沒(méi)有使用命令行選項(xiàng)“-e”(Makefile中不存在同名的變量定義,此變量沒(méi)有被替代)。
4. environment override
變量“VARIABLE”是一個(gè)系統(tǒng)環(huán)境變量,并且make使用了命令行選項(xiàng)“-e”。Makefile中存在一個(gè)同名的變量定義,使用“make -e”時(shí)環(huán)境變量值替代了文件中的變量定義。
5. file
變量“VARIABLE”在某一個(gè)makefile文件中定義。
6. command line
變量“VARIABLE”在命令行中定義。
7. override
變量“VARIABLE”在makefile文件中定義并使用“override”指示符聲明。
8. automatic
變量“VARIABLE”是自動(dòng)化變量。
函數(shù)“origin”返回的變量信息對(duì)我們書(shū)寫(xiě)Makefile是相當(dāng)有用的,可以使我們?cè)谑褂靡粋€(gè)變量之前對(duì)它值的合法性進(jìn)行判斷。假設(shè)在Makefile其包了另外一個(gè)名為bar.mk的makefile文件。我們需要在bar.mk中定義變量“bletch”(無(wú)論它是否是一個(gè)環(huán)境變量),保證“make –f bar.mk”能夠正確執(zhí)行。另外一種情況,當(dāng)Makefile包含bar.mk,在Makefile包含bar.mk之前有同樣的變量定義,但是我們不希望覆蓋bar.mk中的“bletch”的定義。一種方式是:我們?cè)?/span>bar.mk中使用指示符“override”聲明這個(gè)變量。但是它所存在的問(wèn)題時(shí),此變量不能被任何方式定義的同名變量覆蓋,包括命令行定義。另外一種比較靈活的實(shí)現(xiàn)就是在bar.mk中使用“origin”函數(shù),如下:
ifdef bletch
ifeq "$(origin bletch)" "environment"
bletch = barf, gag, etc.
endif
endif
這里,如果存在環(huán)境變量“bletch”,則對(duì)它進(jìn)行重定義。
ifneq "$(findstring environment,$(origin bletch))" ""
bletch = barf, gag, etc.
endif
這個(gè)例子實(shí)現(xiàn)了:即使環(huán)境變量中已經(jīng)存在變量“bletch”,無(wú)論是否使用“make -e”來(lái)執(zhí)行Makefile,變量“bletch”的值都是“barf,gag,etc”(在Makefile中所定義的)。環(huán)境變量不能替代文件中的定義。
如果“$(origin bletch)”返回“environment”或“environment override”,都將對(duì)變量“bletch”重新定義。
shell函數(shù)不同于除“wildcard”函數(shù)之外的其它函數(shù)。make可以使用它來(lái)和外部通信。
Ø 函數(shù)功能:函數(shù)“shell”所實(shí)現(xiàn)的功能和shell中的引用(``)相同。實(shí)現(xiàn)對(duì)命令的擴(kuò)展。這就意味著需要一個(gè)shell 命令作為此函數(shù)的參數(shù),函數(shù)的返回結(jié)果是此命令在shell中的執(zhí)行結(jié)果。make僅僅對(duì)它的回返結(jié)果進(jìn)行處理;make將函數(shù)返回結(jié)果中的所有換行符(“\n”)或者一對(duì)“\n\r”替換為單空格;并去掉末尾的回車(chē)符號(hào)(“\n”)或者“\n\r”。進(jìn)行函數(shù)展開(kāi)式時(shí),它所調(diào)用的命令(它的參數(shù))得到執(zhí)行。除對(duì)它的引用出現(xiàn)在規(guī)則的命令行和遞歸變量的定義中以外,其它決大多數(shù)情況下,make是在讀取解析Makefile時(shí)完成對(duì)函數(shù)shell的展開(kāi)。
Ø 返回值:函數(shù)“shell”的參數(shù)(一個(gè)shell命令)在shell環(huán)境中的執(zhí)行結(jié)果。
Ø 函數(shù)說(shuō)明:函數(shù)本身的返回值是其參數(shù)的執(zhí)行結(jié)果,沒(méi)有進(jìn)行任何處理。對(duì)結(jié)果的處理是由make進(jìn)行的。當(dāng)對(duì)函數(shù)的引用出現(xiàn)在規(guī)則的命令行中,命令行在執(zhí)行時(shí)函數(shù)才被展開(kāi)。展開(kāi)時(shí)函數(shù)參數(shù)(shell命令)的執(zhí)行是在另外一個(gè)shell進(jìn)程中完成的,因此需要對(duì)出現(xiàn)在規(guī)則命令行的多級(jí)“shell”函數(shù)引用需要謹(jǐn)慎處理,否則會(huì)影響效率(每一級(jí)的“shell”函數(shù)的參數(shù)都會(huì)有各自的shell進(jìn)程)。
示例1:
contents := $(shell cat foo)
將變量“contents”賦值為文件“foo”的內(nèi)容,文件中的換行符在變量中使用空格代替。
示例2:
files := $(shell echo *.c)
將變量“files”賦值為當(dāng)前目錄下所有.c文件的列表(文件名之間使用空格分割)。在shell中之行的命令是“echo *.c”,此命令返回當(dāng)前目錄下的所有.c文件列表。上例的執(zhí)行結(jié)果和函數(shù)“$(wildcard *.c)”的結(jié)果相同,除非你使用的是一個(gè)奇怪的shell。
注意:通過(guò)上邊的兩個(gè)例子我們可以看到,當(dāng)引用“shell”函數(shù)的變量定義使用直接展開(kāi)式定義時(shí)可以保證函數(shù)的展開(kāi)是在make讀入Makefile時(shí)完成。后續(xù)對(duì)此變量的引用就不會(huì)有展開(kāi)過(guò)程。這樣就可以避免規(guī)則命令行中的變量引用在命令行執(zhí)行時(shí)展開(kāi)的情況發(fā)生(因?yàn)檎归_(kāi)“shell”函數(shù)需要另外的shell進(jìn)程完成,影響命令的執(zhí)行效率)。這也是我們建議的方式。make提供了兩個(gè)控制make運(yùn)行方式的函數(shù)。通常它們用在Makefile中,當(dāng)make執(zhí)行過(guò)程中檢測(cè)到某些錯(cuò)誤是為用戶(hù)提供消息,并且可以控制make過(guò)程是否繼續(xù)。
Ø 函數(shù)功能:產(chǎn)生致命錯(cuò)誤,并提示“TEXT…”信息給用戶(hù),并退出make的執(zhí)行。需要說(shuō)明的是:“error”函數(shù)是在函數(shù)展開(kāi)式(函數(shù)被調(diào)用時(shí))才提示信息并結(jié)束make進(jìn)程。因此如果函數(shù)出現(xiàn)在命令中或者一個(gè)遞歸的變量定義中時(shí),在讀取Makefile時(shí)不會(huì)出現(xiàn)錯(cuò)誤。而只有包含“error”函數(shù)引用的命令被執(zhí)行,或者定義中引用此函數(shù)的遞歸變量被展開(kāi)時(shí),才會(huì)提示致命信息“TEXT…”同時(shí)退出make。
Ø 返回值:空
Ø 函數(shù)說(shuō)明:“error”函數(shù)一般不出現(xiàn)在直接展開(kāi)式的變量定義中,否則在make讀取Makefile時(shí)將會(huì)提示致命錯(cuò)誤。
假設(shè)我們的Makefile中包含以下兩個(gè)片斷;
示例1:
ifdef ERROR1
$(error error is $(ERROR1))
endif
make讀取解析Makefile時(shí),如果只起那已經(jīng)定義變量“EROOR1”,make將會(huì)提示致命錯(cuò)誤信息“$(ERROR1)”并退出。
示例2:
ERR = $(error found an error!)
.PHONY: err
err: ; $(ERR)
這個(gè)例子,在make讀取Makefile時(shí)不會(huì)出現(xiàn)致命錯(cuò)誤。只有目標(biāo)“err”被作為一個(gè)目標(biāo)被執(zhí)行時(shí)才會(huì)出現(xiàn)。
Ø 函數(shù)功能:函數(shù)“warning”類(lèi)似于函數(shù)“error”,區(qū)別在于它不會(huì)導(dǎo)致致命錯(cuò)誤(make不退出),而只是提示“TEXT…”,make的執(zhí)行過(guò)程繼續(xù)。
Ø 返回值:空
Ø 函數(shù)說(shuō)明:用法和“error”類(lèi)似,展開(kāi)過(guò)程相同。
聯(lián)系客服