GNU (内部)make函数
GNU make的函數(shù)提供了處理文件名、變量、文本和命令的方法。使用函數(shù)我們的Makefile可以書寫的更加靈活和健壯。可以在需要的地方地調(diào)用函數(shù)來處理指定的文本（需要處理的文本作為函數(shù)的參數(shù)），函數(shù)的在調(diào)用它的地方被替換為它的處理結(jié)果。函數(shù)調(diào)用（引用）的展開和變量引用的展開方式相同。
8.1??????函數(shù)的調(diào)用語法
GNU make函數(shù)的調(diào)用格式類似于變量的引用，以“$”開始表示一個(gè)引用。語法格式如下：
?
$(FUNCTION ARGUMENTS)
?
或者：
?
${FUNCTION ARGUMENTS}
?
對于函數(shù)調(diào)用的格式有以下幾點(diǎn)說明：
1.????????調(diào)用語法格式中“FUNCTION”是需要調(diào)用的函數(shù)名，它應(yīng)該是make內(nèi)嵌的函數(shù)名。對于用戶自己的函數(shù)需要通過make的“call”函數(shù)來間接調(diào)用。
2.????????“ARGUMENTS”是函數(shù)的參數(shù)，參數(shù)和函數(shù)名之間使用若干個(gè)空格或者[tab]字符分割（建議使用一個(gè)空格，這樣不僅使在書寫上比較直觀，更重要的是當(dāng)你不能確定是否可以使用[Tab]的時(shí)候，避免不必要的麻煩）；如果存在多個(gè)參數(shù)時(shí)，參數(shù)之間使用逗號“,”分開。
3.????????以“$”開頭，使用成對的圓括號或花括號把函數(shù)名和參數(shù)括起（在Makefile中，圓括號和花括號在任何地方必須成對出現(xiàn)）。參數(shù)中存在變量或者函數(shù)的引用時(shí)，對它們所使用的分界符（圓括號或者花括號）建議和引用函數(shù)的相同，不使用兩種不同的括號。推薦在變量引用和函數(shù)引用中統(tǒng)一使用圓括號；這樣在使用“vim”編輯器書寫Makefile時(shí)，使用圓括它可以亮度顯式make的內(nèi)嵌函數(shù)名，避免函數(shù)名的拼寫錯(cuò)誤。在Makefile中應(yīng)該這樣來書寫“$(sort $(x))”；而不是“$(sort ${x})”和其它幾種。
4.????????函數(shù)處理參數(shù)時(shí)，參數(shù)中如果存在對其它變量或者函數(shù)的引用，首先對這些引用進(jìn)行展開得到參數(shù)的實(shí)際內(nèi)容。而后才對它們進(jìn)行處理。參數(shù)的展開順序是按照參數(shù)的先后順序來進(jìn)行的。
5.????????書寫時(shí)，函數(shù)的參數(shù)不能出現(xiàn)逗號“,”和空格。這是因?yàn)槎禾柋蛔鳛槎鄠€(gè)參數(shù)的分隔符，前導(dǎo)空格會被忽略。在實(shí)際書寫Makefile時(shí)，當(dāng)有逗號或者空格作為函數(shù)的參數(shù)時(shí)，需要把它們賦值給一個(gè)變量，在函數(shù)的參數(shù)中引用這個(gè)變量來實(shí)現(xiàn)。我們來看一個(gè)這樣的例子：
comma:= ,
empty:=
space:= $(empty) $(empty)
foo:= a b c
bar:= $(subst $(space),$(comma),$(foo))
????
這樣我們就實(shí)現(xiàn)了“bar”的值是“a,b,c”。
8.2??????文本處理函數(shù)
以下是GNU make內(nèi)嵌的文本（字符串）處理函數(shù)。
8.2.1???????$(subst FROM,TO,TEXT)
函數(shù)名稱：字符串替換函數(shù)—subst。
函數(shù)功能：把字串“TEXT”中的“FROM”字符替換為“TO”。
返回值：替換后的新字符串。
示例：
?
$(subst ee,EE,feet on the street)
?
替換“feet on the street”中的“ee”為“EE”，結(jié)果得到字符串“fEEt on the strEEt”。
8.2.2???????$(patsubst PATTERN,REPLACEMENT,TEXT)
函數(shù)名稱：模式替換函數(shù)—patsubst。
函數(shù)功能：搜索“TEXT”中以空格分開的單詞，將否符合模式“TATTERN”替換為“REPLACEMENT”。參數(shù)“PATTERN”中可以使用模式通配符“%”來代表一個(gè)單詞中的若干字符。如果參數(shù)“REPLACEMENT”中也包含一個(gè)“%”，那么“REPLACEMENT”中的“%”將是“TATTERN”中的那個(gè)“%”所代表的字符串。在“TATTERN”和“REPLACEMENT”中，只有第一個(gè)“%”被作為模式字符來處理，之后出現(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ī)則的語法?一小節(jié)）。
返回值：替換后的新字符串。
函數(shù)說明：參數(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”
本文的第六章在?變量的高級用法的第一小節(jié)?中曾經(jīng)討論過變量的替換引用，它是一個(gè)簡化版的“patsubst”函數(shù)在變量引用過程的實(shí)現(xiàn)。變量替換引用中：
$(VAR:PATTERN=REPLACEMENT)
?
就相當(dāng)于：
$(patsubst PATTERN,REPLACEMENT,$(VAR))
?
而另外一種更為簡單的替換字符后綴的實(shí)現(xiàn)：
$(VAR:SUFFIX=REPLACEMENT)
它等于：
$(patsubst %SUFFIX,%REPLACEMENT,$(VAR))
?
例如我們存在一個(gè)代表所有.o文件的變量。定義為“objects = foo.o bar.o baz.o”。為了得到這些.o文件所對應(yīng)的.c源文件。我們可以使用以下兩種方式的任意一個(gè)：
$(objects:.o=.c)
$(patsubst %.o,%.c,$(objects))
8.2.3???????$(strip STRINT)
函數(shù)名稱：去空格函數(shù)—strip。
函數(shù)功能：去掉字串（若干單詞，使用若干空字符分割）“STRINT”開頭和結(jié)尾的空字符，并將其中多個(gè)連續(xù)空字符合并為一個(gè)空字符。
返回值：無前導(dǎo)和結(jié)尾空字符、使用單一空格分割的多單詞字符串。
函數(shù)說明：空字符包括空格、[Tab]等不可顯示字符。
示例：
STR =??????? a??? b c????
LOSTR = $(strip $(STR))
結(jié)果是“a b c”。
“strip”函數(shù)經(jīng)常用在條件判斷語句的表達(dá)式中，確保表達(dá)式比較的可靠和健壯！
8.2.4???????$(findstring FIND,IN)
函數(shù)名稱：查找字符串函數(shù)—findstring。
函數(shù)功能：搜索字串“IN”，查找“FIND”字串。
返回值：如果在“IN”之中存在“FIND”，則返回“FIND”，否則返回空。
函數(shù)說明：字串“IN”之中可以包含空格、[Tab]。搜索需要是嚴(yán)格的文本匹配。
示例：
$(findstring a,a b c)
$(findstring a,b c)
第一個(gè)函數(shù)結(jié)果是字“a”；第二個(gè)值為空字符。
8.2.5???????$(filter PATTERN…,TEXT)
函數(shù)名稱：過濾函數(shù)—filter。
函數(shù)功能：過濾掉字串“TEXT”中所有不符合模式“PATTERN”的單詞，保留所有符合此模式的單詞。可以使用多個(gè)模式。模式中一般需要包含模式字符“%”。存在多個(gè)模式時(shí)，模式表達(dá)式之間使用空格分割。
返回值：空格分割的“TEXT”字串中所有符合模式“PATTERN”的字串。
函數(shù)說明：“filter”函數(shù)可以用來去除一個(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來編譯生成目標(biāo)“foo”，函數(shù)返回值為“foo.c bar.c baz.s”。
8.2.6???????$(filter-out PATTERN...,TEXT)
函數(shù)名稱：反過濾函數(shù)—filter-out。
函數(shù)功能：和“filter”函數(shù)實(shí)現(xiàn)的功能相反。過濾掉字串“TEXT”中所有符合模式“PATTERN”的單詞，保留所有不符合此模式的單詞。可以有多個(gè)模式。存在多個(gè)模式時(shí)，模式表達(dá)式之間使用空格分割。。
返回值：空格分割的“TEXT”字串中所有不符合模式“PATTERN”的字串。
函數(shù)說明：“filter-out”函數(shù)也可以用來去除一個(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”。
8.2.7???????$(sort LIST)
函數(shù)名稱：排序函數(shù)—sort。
函數(shù)功能：給字串“LIST”中的單詞以首字母為準(zhǔn)進(jìn)行排序（升序），并取掉重復(fù)的單詞。
返回值：空格分割的沒有重復(fù)單詞的字串。
函數(shù)說明：兩個(gè)功能，排序和去字串中的重復(fù)單詞。可以單獨(dú)使用其中一個(gè)功能。
示例：
$(sort foo bar lose foo)
?
返回值為：“bar foo lose”?。
8.2.8???????$(word N,TEXT)
函數(shù)名稱：取單詞函數(shù)—word。
函數(shù)功能：取字串“TEXT”中第“N”個(gè)單詞（“N”的值從1開始）。
返回值：返回字串“TEXT”中第“N”個(gè)單詞。
函數(shù)說明：如果“N”值大于字串“TEXT”中單詞的數(shù)目，返回空字符串。如果“N”為0，出錯(cuò)！
示例：
$(word 2, foo bar baz)
返回值為“bar”。
8.2.9???????$(wordlist S,E,TEXT)
函數(shù)名稱：取字串函數(shù)—wordlist。
函數(shù)功能：從字串“TEXT”中取出從“S”開始到“E”的單詞串。“S”和“E”表示單詞在字串中位置的數(shù)字。
返回值：字串“TEXT”中從第“S”到“E”（包括“E”）的單詞字串。
函數(shù)說明：“S”和“E”都是從1開始的數(shù)字。
當(dāng)“S”比“TEXT”中的字?jǐn)?shù)大時(shí)，返回空。如果“E”大于“TEXT”字?jǐn)?shù)，返回從“S”開始，到“TEXT”結(jié)束的單詞串。如果“S”大于“E”，返回空。
示例：
$(wordlist 2, 3, foo bar baz)
返回值為：“bar baz”。
8.2.10??$(words TEXT)
函數(shù)名稱：統(tǒng)計(jì)單詞數(shù)目函數(shù)—words。
函數(shù)功能：字算字串“TEXT”中單詞的數(shù)目。
返回值：“TEXT”字串中的單詞數(shù)。
示例：
$(words, foo bar)
返回值是“2”。所以字串“TEXT”的最后一個(gè)單詞就是：$(word $(words TEXT),TEXT)。
8.2.11??$(firstword NAMES…)
函數(shù)名稱：取首單詞函數(shù)—firstword。
函數(shù)功能：取字串“NAMES…”中的第一個(gè)單詞。
返回值：字串“NAMES…”的第一個(gè)單詞。
函數(shù)說明：“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ù)。書寫Makefile時(shí)可搭配使用來實(shí)現(xiàn)復(fù)雜功能。最后我們使用這些函數(shù)來實(shí)現(xiàn)一個(gè)實(shí)際應(yīng)用。例子中我們使用函數(shù)“subst”和“patsbust”。Makefile中可以使用變量“VPATH”來指定搜索路徑。對于源代碼所包含的頭文件的搜索路徑需要使用gcc的“-I”參數(shù)指定目錄來實(shí)現(xiàn)，“VPATH”羅列的目錄是用冒號“:”分割的。如下就是Makefile的片段：
……
VPATH = src:../includes
override CFLAGS += $(patsubst %,-I%,$(subst :, ,$(VPATH)))
…….
那么第二條語句所實(shí)現(xiàn)的功能就是“CFLAGS += -Isrc –I../includes”。
8.3??????文件名處理函數(shù)
GNU make除支持上一節(jié)所介紹的文本處理函數(shù)之外，還支持一些針對于文件名的處理函數(shù)。這些函數(shù)主要用來對一系列空格分割的文件名進(jìn)行轉(zhuǎn)換，這些函數(shù)的參數(shù)被作為若干個(gè)文件名來對待。函數(shù)對作為參數(shù)的一組文件名按照一定方式進(jìn)行處理并返回空格分割的多個(gè)文件名序列。
8.3.1???????$(dir NAMES…)
函數(shù)名稱：取目錄函數(shù)—dir。
函數(shù)功能：從文件名序列“NAMES…”中取出各個(gè)文件名的目錄部分。文件名的目錄部分就是包含在文件名中的最后一個(gè)斜線（“/”）（包括斜線）之前的部分。
返回值：空格分割的文件名序列“NAMES…”中每一個(gè)文件的目錄部分。
函數(shù)說明：如果文件名中沒有斜線，認(rèn)為此文件為當(dāng)前目錄（“./”）下的文件。
示例：
$(dir src/foo.c hacks)
返回值為“src/ ./”。
8.3.2???????$(notdir NAMES…)
函數(shù)名稱：取文件名函數(shù)——notdir。
函數(shù)功能：從文件名序列“NAMES…”中取出非目錄部分。目錄部分是指最后一個(gè)斜線（“/”）（包括斜線）之前的部分。刪除所有文件名中的目錄部分，只保留非目錄部分。
返回值：文件名序列“NAMES…”中每一個(gè)文件的非目錄部分。
函數(shù)說明：如果“NAMES…”中存在不包含斜線的文件名，則不改變這個(gè)文件名。以反斜線結(jié)尾的文件名，是用空串代替，因此當(dāng)“NAMES…”中存在多個(gè)這樣的文件名時(shí)，返回結(jié)果中分割各個(gè)文件名的空格數(shù)目將不確定！這是此函數(shù)的一個(gè)缺陷。
示例：
?
$(notdir src/foo.c hacks)
?
返回值為：“foo.c hacks”。
8.3.3???????$(suffix NAMES…)
函數(shù)名稱：取后綴函數(shù)—suffix。
函數(shù)功能：從文件名序列“NAMES…”中取出各個(gè)文件名的后綴。后綴是文件名中最后一個(gè)以點(diǎn)“.”開始的（包含點(diǎn)號）部分，如果文件名中不包含一個(gè)點(diǎn)號，則為空。
返回值：以空格分割的文件名序列“NAMES…”中每一個(gè)文件的后綴序列。
函數(shù)說明：“NAMES…”是多個(gè)文件名時(shí)，返回值是多個(gè)以空格分割的單詞序列。如果文件名沒有后綴部分，則返回空。
?
示例：
?
$(suffix src/foo.c src-1.0/bar.c hacks)
?
返回值為“.c .c”。
8.3.4???????$(basename NAMES…)
函數(shù)名稱：取前綴函數(shù)—basename。
函數(shù)功能：從文件名序列“NAMES…”中取出各個(gè)文件名的前綴部分（點(diǎn)號之后的部分）。前綴部分指的是文件名中最后一個(gè)點(diǎn)號之前的部分。
返回值：空格分割的文件名序列“NAMES…”中各個(gè)文件的前綴序列。如果文件沒有前綴，則返回空字串。
函數(shù)說明：如果“NAMES…”中包含沒有后綴的文件名，此文件名不改變。如果一個(gè)文件名中存在多個(gè)點(diǎn)號，則返回值為此文件名的最后一個(gè)點(diǎn)號之前的文件名部分。
示例：
?
$(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”。
8.3.5???????$(addsuffix SUFFIX,NAMES…)
函數(shù)名稱：加后綴函數(shù)—addsuffix。
函數(shù)功能：為“NAMES…”中的每一個(gè)文件名添加后綴“SUFFIX”。參數(shù)“NAMES…”為空格分割的文件名序列，將“SUFFIX”追加到此序列的每一個(gè)文件名的末尾。
返回值：以單空格分割的添加了后綴“SUFFIX”的文件名序列。
函數(shù)說明：
示例：
$(addsuffix .c,foo bar)
?
返回值為“foo.c bar.c”。
8.3.6???????$(addprefix PREFIX,NAMES…)
函數(shù)名稱：加前綴函數(shù)—addprefix。
函數(shù)功能：為“NAMES…”中的每一個(gè)文件名添加前綴“PREFIX”。參數(shù)“NAMES…”是空格分割的文件名序列，將“SUFFIX”添加到此序列的每一個(gè)文件名之前。
返回值：以單空格分割的添加了前綴“PREFIX”的文件名序列。
函數(shù)說明：
示例：
?
$(addprefix src/,foo bar)
?
返回值為“src/foo src/bar”。
8.3.7???????$(join LIST1,LIST2)
函數(shù)名稱：單詞連接函數(shù)——join。
函數(shù)功能：將字串“LIST1”和字串“LIST2”各單詞進(jìn)行對應(yīng)連接。就是將“LIST2”中的第一個(gè)單詞追加“LIST1”第一個(gè)單詞字后合并為一個(gè)單詞；將“LIST2”中的第二個(gè)單詞追加到“LIST1”的第一個(gè)單詞之后并合并為一個(gè)單詞，……依次列推。
返回值：單空格分割的合并后的字（文件名）序列。
函數(shù)說明：如果“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”。
8.3.8???????$(wildcard PATTERN)
函數(shù)名稱：獲取匹配模式文件名函數(shù)—wildcard
函數(shù)功能：列出當(dāng)前目錄下所有符合模式“PATTERN”格式的文件名。
返回值：空格分割的、存在當(dāng)前目錄下的所有符合模式“PATTERN”的文件名。
函數(shù)說明：“PATTERN”使用shell可識別的通配符，包括“?”（單字符）、“*”（多字符）等。
示例：
$(wildcard *.c)
返回值為當(dāng)前目錄下所有.c源文件列表。
8.4??????foreach?函數(shù)
函數(shù)“foreach”不同于其它函數(shù)。它是一個(gè)循環(huán)函數(shù)。類似于Linux的shell中的for語句。
?????????“foreach”函數(shù)的語法：
?
$(foreach VAR,LIST,TEXT)
?
?????????函數(shù)功能：這個(gè)函數(shù)的工作過程是這樣的：如果需要（存在變量或者函數(shù)的引用），首先展開變量“VAR”和“LIST”的引用；而表達(dá)式“TEXT”中的變量引用不展開。執(zhí)行時(shí)把“LIST”中使用空格分割的單詞依次取出賦值給變量“VAR”，然后執(zhí)行“TEXT”表達(dá)式。重復(fù)直到“LIST”的最后一個(gè)單詞（為空時(shí)結(jié)束）。“TEXT”中的變量或者函數(shù)引用在執(zhí)行時(shí)才被展開，因此如果在“TEXT”中存在對“VAR”的引用，那么“VAR”的值在每一次展開式將會到的不同的值。
?????????返回值：空格分割的多次表達(dá)式“TEXT”的計(jì)算的結(jié)果。
我們來看一個(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í)將展開為“$(wildcard a/*)”；第二次執(zhí)行時(shí)將展開為“$(wildcard b/*)”；第三次展開為“$(wildcard c/*)”；….；以此類推。所以此函數(shù)所實(shí)現(xiàn)的功能就和一下語句等價(jià)：
?
files := $(wildcard a/* b/* c/* d/*)
?
當(dāng)函數(shù)的“TEXT”表達(dá)式過于復(fù)雜時(shí)，我們可以通過定義一個(gè)中間變量，此變量代表表達(dá)式的一部分。并在函數(shù)的“TEXT”中引用這個(gè)變量。上邊的例子也可以這樣來實(shí)現(xiàn)：
?
find_files = $(wildcard $(dir)/*)
dirs := a b c d
files := $(foreach dir,$(dirs),$(find_files))
?
在這里我們定義了一個(gè)變量（也可以稱之為表達(dá)式），需要注意，在這里定義的是“遞歸展開”時(shí)的變量“find_files”。保證了定義時(shí)變量值中的引用不展開，而是在表達(dá)式被函數(shù)處理時(shí)才展開（如果這里使用直接展開式的定義將是無效的表達(dá)式）。
?????????函數(shù)說明：函數(shù)中參數(shù)“VAR”是一個(gè)局部的臨時(shí)變量，它只在“foreach”函數(shù)的上下文中有效，它的定義不會影響其它部分定義的同名“VAR”變量的值。在函數(shù)的執(zhí)行過程中它是一個(gè)“直接展開”式變量。
?
在使用函數(shù)“foreach”時(shí)，需要注意：變量“VAR”的名字。我們建議使用一個(gè)單詞、最好能夠表達(dá)其含義的名字，不要使用一個(gè)奇怪的字符串作為變量名。雖然執(zhí)行是不會發(fā)生錯(cuò)誤，但是會讓人很費(fèi)解。
沒有人會喜歡這種方式，盡管可能它可以正常工作：
?
files := $(foreach Esta escrito en espanol!,b c ch,$(find_files))
8.5??????if?函數(shù)
函數(shù)“if”提供了一個(gè)在函數(shù)上下文中實(shí)現(xiàn)條件判斷的功能。就像make所支持的條件語句—ifeq一樣。
?????????函數(shù)語法：
?
$(if CONDITION,THEN-PART[,ELSE-PART])
?
?????????函數(shù)功能：第一個(gè)參數(shù)“CONDITION”，在函數(shù)執(zhí)行時(shí)忽略其前導(dǎo)和結(jié)尾空字符，如果包含對其他變量或者函數(shù)的引用則進(jìn)行展開。如果“CONDITION”的展開結(jié)果非空，則條件為真，就將第二個(gè)參數(shù)“THEN_PATR”作為函數(shù)的計(jì)算表達(dá)式；“CONDITION”的展開結(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”展開為空，函數(shù)返回空。
?????????函數(shù)說明：函數(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è)子目錄。
8.6??????call函數(shù)
“call”函數(shù)是唯一一個(gè)可以創(chuàng)建定制化參數(shù)函數(shù)的引用函數(shù)。使用這個(gè)函數(shù)可以實(shí)現(xiàn)對用戶自己定義函數(shù)引用。我們可以將一個(gè)變量定義為一個(gè)復(fù)雜的表達(dá)式，用“call”函數(shù)根據(jù)不同的參數(shù)對它進(jìn)行展開來獲得不同的結(jié)果。
?????????函數(shù)語法：
?
$(call VARIABLE,PARAM,PARAM,...)
?
?????????函數(shù)功能：在執(zhí)行時(shí)，將它的參數(shù)“PARAM”依次賦值給臨時(shí)變量“$(1)”、“$(2)”（這些臨時(shí)變量定義在“VARIABLE”的值中，參考下邊的例子）……?call函數(shù)對參數(shù)的數(shù)目沒有限制，也可以沒有參數(shù)值，沒有參數(shù)值的“call”沒有任何實(shí)際存在的意義。執(zhí)行時(shí)變量“VARIABLE”被展開為在函數(shù)上下文有效的臨時(shí)變量，變量定義中的“$(1)”作為第一個(gè)參數(shù)，并將函數(shù)參數(shù)值中的第一個(gè)參數(shù)賦值給它；變量中的“$(2)”一樣被賦值為函數(shù)的第二個(gè)參數(shù)值；依此類推（變量$(0)代表變量“VARIABLE”本身）。之后對變量“VARIABLE”?表達(dá)式的計(jì)算值。
?????????返回值：參數(shù)值“PARAM”依次替換“$(1)”、“$(2)”……?之后變量“VARIABLE”定義的表達(dá)式的計(jì)算值。
?????????函數(shù)說明：1.?函數(shù)中“VARIBLE”是一個(gè)變量名，而不是變量引用。因此，通常“call”函數(shù)中的“VARIABLE”中不包含“$”（當(dāng)然，除非此變量名是一個(gè)計(jì)算的變量名）。2.?當(dāng)變量“VARIBLE”是一個(gè)make內(nèi)嵌的函數(shù)名時(shí)（如“if”、“foreach”、“strip”等），對“PARAM”參數(shù)的使用需要注意，因?yàn)椴缓线m或者不正確的參數(shù)將會導(dǎo)致函數(shù)的返回值難以預(yù)料。3.?函數(shù)中多個(gè)“PARAM”之間使用逗號分割。4.?變量“VARIABLE”在定義時(shí)不能定義為直接展開式！只能定義為遞歸展開式。
?????????函數(shù)示例：
首先，來看一個(gè)簡單的例子。
示例1：
?
reverse =? $(2) $(1)
foo = $(call reverse,a,b)
?
變量“foo”的值為“ba”。這里變量“reverse”中的參數(shù)定義順序可以根據(jù)需要來調(diào)整，并不是需要按照“$(1)”、“$(2)”、“$(3)”……?這樣的順序來定義。
看一個(gè)稍微復(fù)雜一些的例子。我們定義了一個(gè)宏“pathsearch”來在“PATH”路徑中搜索第一個(gè)指定的程序。
示例2：
?
pathsearch = $(firstword $(wildcard $(addsuffix /$(1),$(subst :, ,$(PATH)))))
LS := $(call pathsearch,ls)
?
變量“LS”的結(jié)果為“/bin/sh”。執(zhí)行過程：函數(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í)行過程：首先，“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ù)展開后等價(jià)于“$(foreach a,o map MAKE,$(origin $(a)))”。
?????????注意：和其它函數(shù)一樣，“call”函數(shù)會保留出現(xiàn)在其參數(shù)值列表中的空字符。因此在使用參數(shù)值時(shí)對空格處理要格外小心。如果參數(shù)中存在多余的空格，函數(shù)可能會返回一個(gè)莫名奇妙的值。為了安全，在變量作為“call”函數(shù)參數(shù)值之前，應(yīng)去掉其值中的多余空格。
8.7??????value函數(shù)
函數(shù)“value”提供了一種在不對變量進(jìn)行展開的情況下獲取變量值的方法。注意：并不是說函數(shù)會取消之前已經(jīng)執(zhí)行過的替換擴(kuò)展。比如：定義了一個(gè)直接展開式的變量，此變量在定義過程中對其它變量的引用進(jìn)行替換而得到自身的值。在使用“value”函數(shù)取這個(gè)變量進(jìn)行取值時(shí)，得到的是不包含任何引用值。而不是將定義過程中的替換展開動作取消后包含引用的定義值。就是說此過程不能取消此變量在定義時(shí)已經(jīng)發(fā)生了的替換展開動作。
?????????函數(shù)語法：
?
$(value VARIABLE)
?
?????????函數(shù)功能：不對變量“VARIBLE”進(jìn)行任何展開操作，直接返回變量“VARIBALE”的值。這里“VARIABLE”是一個(gè)變量名，一般不包含“$”（除非計(jì)算的變量名），
?????????返回值：變量“VARIBALE”所定義文本值（如果變量定義為遞歸展開式，其中包含對其他變量或者函數(shù)的引用，那么函數(shù)不對這些引用進(jìn)行展開。函數(shù)的返回值是包含有引用值）。
?????????函數(shù)說明：
示例：
# sample Makefile
FOO = $PATH
?
all:
@echo $(FOO)
@echo $(value FOO)
?
執(zhí)行make，可以看到的結(jié)果是：第一行為：“ATH”。這是因?yàn)樽兞俊?span lang="EN-US">FOO”定義為“$PATH”，所以展開為“ATH”（“$P”為空）。
第二行才是我們需要顯示的系統(tǒng)環(huán)境變量“PATH”的值（value函數(shù)得到變量“FOO”的值為“$PATH”）。
8.8??????eval函數(shù)???????
?????????函數(shù)功能：函數(shù)“eval”是一個(gè)比較特殊的函數(shù)。使用它可以在Makefile中構(gòu)造一個(gè)可變的規(guī)則結(jié)構(gòu)關(guān)系（依賴關(guān)系鏈），其中可以使用其它變量和函數(shù)。函數(shù)“eval”對它的參數(shù)進(jìn)行展開，展開的結(jié)果作為Makefile的一部分，make可以對展開內(nèi)容進(jìn)行語法解析。展開的結(jié)果可以包含一個(gè)新變量、目標(biāo)、隱含規(guī)則或者是明確規(guī)則等。也就是說此函數(shù)的功能主要是：根據(jù)其參數(shù)的關(guān)系、結(jié)構(gòu)，對它們進(jìn)行替換展開。
?????????返回值：函數(shù)“eval”的返回值時(shí)空，也可以說沒有返回值。
?????????函數(shù)說明：“eval”函數(shù)執(zhí)行時(shí)會對它的參數(shù)進(jìn)行兩次展開。第一次展開過程發(fā)是由函數(shù)本身完成的，第二次是函數(shù)展開后的結(jié)果被作為Makefile內(nèi)容時(shí)由make解析時(shí)展開的。明確這一過程對于使用“eval”函數(shù)非常重要。理解了函數(shù)“eval”二次展開的過程后。實(shí)際使用時(shí)，如果在函數(shù)的展開結(jié)果中存在引用（格式為：$(x)），那么在函數(shù)的參數(shù)中應(yīng)該使用“$$”來代替“$”。因?yàn)檫@一點(diǎn)，所以通常它的參數(shù)中會使用函數(shù)“value”來取一個(gè)變量的文本值。
我們看一個(gè)例子。例子看起來似乎非常復(fù)雜，因?yàn)樗C合了其它的一些概念和函數(shù)。不過我們可以考慮兩點(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)
?
來看一下這個(gè)例子：它實(shí)現(xiàn)的功能是完成“PROGRAMS”的編譯鏈接。例子中“$(LINK.o)”為“$(CC) $(LDFLAGS)”，意思是對所有的.o文件和指定的庫文件進(jìn)行鏈接。
“$(foreach prog,$(PROGRAM),$(eval $(call PROGRAM_template,$(prog))))”展開為：
server : $(server_OBJS) –l$(server_LIBS)
client : $(client_OBJS) –l$(client_LIBS)
8.9??????origin函數(shù)
函數(shù)“origin”和其他函數(shù)不同，函數(shù)“origin”的動作不是操作變量（它的參數(shù)）。它只是獲取此變量（參數(shù)）相關(guān)的信息，告訴我們這個(gè)變量的出處（定義方式）。
?????????函數(shù)語法：
$(origin VARIABLE)
?
?????????函數(shù)功能：函數(shù)“origin”查詢參數(shù)“VARIABLE”（一個(gè)變量名）的出處。
?????????函數(shù)說明：“VARIABLE”是一個(gè)變量名而不是一個(gè)變量的引用。因此通常它不包含“$”（當(dāng)然，計(jì)算的變量名例外）。
?????????返回值：返回“VARIABLE”的定義方式。用字符串表示。
函數(shù)的返回情況有以下幾種：
1.????????undefined
變量“VARIABLE”沒有被定義。
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沒有使用命令行選項(xiàng)“-e”（Makefile中不存在同名的變量定義，此變量沒有被替代）。
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”是自動化變量。
?
函數(shù)“origin”返回的變量信息對我們書寫Makefile是相當(dāng)有用的，可以使我們在使用一個(gè)變量之前對它值的合法性進(jìn)行判斷。假設(shè)在Makefile其包了另外一個(gè)名為bar.mk的makefile文件。我們需要在bar.mk中定義變量“bletch”（無論它是否是一個(gè)環(huán)境變量），保證“make –f bar.mk”能夠正確執(zhí)行。另外一種情況，當(dāng)Makefile包含bar.mk，在Makefile包含bar.mk之前有同樣的變量定義，但是我們不希望覆蓋bar.mk中的“bletch”的定義。一種方式是：我們在bar.mk中使用指示符“override”聲明這個(gè)變量。但是它所存在的問題時(shí)，此變量不能被任何方式定義的同名變量覆蓋，包括命令行定義。另外一種比較靈活的實(shí)現(xiàn)就是在bar.mk中使用“origin”函數(shù)，如下：
?
ifdef bletch
ifeq "$(origin bletch)" "environment"
bletch = barf, gag, etc.
endif
endif
?
這里，如果存在環(huán)境變量“bletch”，則對它進(jìn)行重定義。
?
ifneq "$(findstring environment,$(origin bletch))" ""
bletch = barf, gag, etc.
endif
?
這個(gè)例子實(shí)現(xiàn)了：即使環(huán)境變量中已經(jīng)存在變量“bletch”，無論是否使用“make -e”來執(zhí)行Makefile，變量“bletch”的值都是“barf,gag,etc”（在Makefile中所定義的）。環(huán)境變量不能替代文件中的定義。
如果“$(origin bletch)”返回“environment”或“environment override”，都將對變量“bletch”重新定義。
8.10shell函數(shù)
shell函數(shù)不同于除“wildcard”函數(shù)之外的其它函數(shù)。make可以使用它來和外部通信。
?????????函數(shù)功能：函數(shù)“shell”所實(shí)現(xiàn)的功能和shell中的引用（``）相同。實(shí)現(xiàn)對命令的擴(kuò)展。這就意味著需要一個(gè)shell?命令作為此函數(shù)的參數(shù)，函數(shù)的返回結(jié)果是此命令在shell中的執(zhí)行結(jié)果。make僅僅對它的回返結(jié)果進(jìn)行處理；make將函數(shù)返回結(jié)果中的所有換行符（“/n”）或者一對“/n/r”替換為單空格；并去掉末尾的回車符號（“/n”）或者“/n/r”。進(jìn)行函數(shù)展開式時(shí)，它所調(diào)用的命令（它的參數(shù)）得到執(zhí)行。除對它的引用出現(xiàn)在規(guī)則的命令行和遞歸變量的定義中以外，其它決大多數(shù)情況下，make是在讀取解析Makefile時(shí)完成對函數(shù)shell的展開。
?????????返回值：函數(shù)“shell”的參數(shù)（一個(gè)shell命令）在shell環(huán)境中的執(zhí)行結(jié)果。
?????????函數(shù)說明：函數(shù)本身的返回值是其參數(shù)的執(zhí)行結(jié)果，沒有進(jìn)行任何處理。對結(jié)果的處理是由make進(jìn)行的。當(dāng)對函數(shù)的引用出現(xiàn)在規(guī)則的命令行中，命令行在執(zhí)行時(shí)函數(shù)才被展開。展開時(shí)函數(shù)參數(shù)（shell命令）的執(zhí)行是在另外一個(gè)shell進(jìn)程中完成的，因此需要對出現(xiàn)在規(guī)則命令行的多級“shell”函數(shù)引用需要謹(jǐn)慎處理，否則會影響效率（每一級的“shell”函數(shù)的參數(shù)都會有各自的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。
注意： 通過上邊的兩個(gè)例子我們可以看到，當(dāng)引用“ shell ”函數(shù)的變量定義使用 直接展開式定義 時(shí)可以保證函數(shù)的展開是在 make 讀入 Makefile 時(shí)完成。后續(xù)對此變量的引用就不會有展開過程。這樣就可以避免規(guī)則命令行中的變量引用在命令行執(zhí)行時(shí)展開的情況發(fā)生（因?yàn)檎归_“ shell ”函數(shù)需要另外的 shell 進(jìn)程完成，影響命令的執(zhí)行效率）。這也是我們建議的方式。8.11make的控制函數(shù)
make提供了兩個(gè)控制make運(yùn)行方式的函數(shù)。通常它們用在Makefile中，當(dāng)make執(zhí)行過程中檢測到某些錯(cuò)誤是為用戶提供消息，并且可以控制make過程是否繼續(xù)。
8.11.1??$(error TEXT…)
?????????函數(shù)功能：產(chǎn)生致命錯(cuò)誤，并提示“TEXT…”信息給用戶，并退出make的執(zhí)行。需要說明的是：“error”函數(shù)是在函數(shù)展開式（函數(shù)被調(diào)用時(shí)）才提示信息并結(jié)束make進(jìn)程。因此如果函數(shù)出現(xiàn)在命令中或者一個(gè)遞歸的變量定義中時(shí)，在讀取Makefile時(shí)不會出現(xiàn)錯(cuò)誤。而只有包含“error”函數(shù)引用的命令被執(zhí)行，或者定義中引用此函數(shù)的遞歸變量被展開時(shí)，才會提示致命信息“TEXT…”同時(shí)退出make。
?????????返回值：空
?????????函數(shù)說明：“error”函數(shù)一般不出現(xiàn)在直接展開式的變量定義中，否則在make讀取Makefile時(shí)將會提示致命錯(cuò)誤。
假設(shè)我們的Makefile中包含以下兩個(gè)片斷；
示例1：
ifdef ERROR1
$(error error is $(ERROR1))
endif
?
make讀取解析Makefile時(shí)，如果只起那已經(jīng)定義變量“EROOR1”，make將會提示致命錯(cuò)誤信息“$(ERROR1)”并退出。
示例2：
ERR = $(error found an error!)
?
.PHONY: err
err: ; $(ERR)
?
這個(gè)例子，在make讀取Makefile時(shí)不會出現(xiàn)致命錯(cuò)誤。只有目標(biāo)“err”被作為一個(gè)目標(biāo)被執(zhí)行時(shí)才會出現(xiàn)。
8.11.2??$(warning TEXT…)?
?????????函數(shù)功能：函數(shù)“warning”類似于函數(shù)“error”，區(qū)別在于它不會導(dǎo)致致命錯(cuò)誤（make不退出），而只是提示“TEXT…”，make的執(zhí)行過程繼續(xù)。
?????????返回值：空
?????????函數(shù)說明：用法和“error”類似，展開過程相同。
總結(jié)
以上是生活随笔為你收集整理的GNU (内部)make函数的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： Android system.img 打
- 下一篇： arm-eabi-gcc: error