Makefile 常用函數表
一、字符串處理函數
1.$(subst FROM,TO,TEXT)
函數名稱：字符串替換函數—subst。
函數功能：把字串“TEXT”中的“FROM”字符替換爲“TO”。
返回值：替換後的新字符串。
2.$(patsubst PATTERN,REPLACEMENT,TEXT)
函數名稱：模式替換函數—patsubst。
函數功能：搜索“TEXT”中以空格分開的單詞，將否符合模式“TATTERN”替換爲“REPLACEMENT”。參數“PATTERN”中可以使用模
式通配符“%”來代表一個單詞中的若干字符。如果參數“REPLACEMENT”中也包含一個“%”，那麼“REPLACEMENT”中的“%”將是
“TATTERN”中的那個“%”所代表的字符串。在“TATTERN”和“REPLACEMENT”中，只有第一個“%”被作爲模式字符來處理，後續的作爲字符本上來處理。在兩個參數中當使用第一個“%”本是字符本身時，可使用反斜槓“/”對它進行轉義處理。
返回值：替換後的新字符串。
函數說明：參數“TEXT”單詞之間的多個空格在處理時被合併爲一個空格，但前導和結尾空格忽略。
3.$(strip STRINT)
函數名稱：去空格函數—strip。
函數功能：去掉字串（若干單詞，使用若干空字符分割）“STRINT”開頭和結尾的空字符，並將其中多個連續空字符合併爲一個空字符。
返回值：無前導和結尾空字符、使用單一空格分割的多單詞字符串。
函數說明：空字符包括空格、[Tab]等不可顯示字符。
4.$(findstring FIND,IN)
函數名稱：查找字符串函數—findstring。
函數功能：搜索字串“IN”，查找“FIND”字串。
返回值：如果在“IN”之中存在“FIND”，則返回“FIND”，否則返回空。
函數說明：字串“IN”之中可以包含空格、[Tab]。搜索需要是嚴格的文本匹配。
5.$(filter PATTERN…,TEXT)
函數名稱：過濾函數—filter。
函數功能：過濾掉字串“TEXT”中所有不符合模式“PATTERN”的單詞，保留所有符合此模式的單詞。可以使用多個模式。模式中一般需要包含模式字符“%”。存在多個模式時，模式表達式之間使用空格分割。
返回值：空格分割的“TEXT”字串中所有符合模式“PATTERN”的字串。
函數說明：“filter”函數可以用來去除一個變量中的某些字符串，我們下邊的例子中就是用到了此函數。
6.$(filter-out PATTERN...,TEXT)
函數名稱：反過濾函數—filter-out。
函數功能：和“filter”函數實現的功能相反。過濾掉字串“TEXT”中所有符合模式“PATTERN”的單詞，保留所有不符合此模式的單詞。可以有多個模式。存在多個模式時，模式表達式之間使用空格分割。。
返回值：空格分割的“TEXT”字串中所有不符合模式“PATTERN”的字串。
函數說明：“filter-out”函數也可以用來去除一個變量中的某些字符串，（實現和“filter”函數相反）。
7.$(sort LIST)
函數名稱：排序函數—sort。
函數功能：給字串“LIST”中的單詞以首字母爲準進行排序（升序），並取掉重複的單詞。
返回值：空格分割的沒有重複單詞的字串。
函數說明：兩個功能，排序和去字串中的重複單詞。可以單獨使用其中一個功能。
8.$(word N,TEXT)
函數名稱：取單詞函數—word。
函數功能：取字串“TEXT”中第“N”個單詞（“N”的值從1開始）。
返回值：返回字串“TEXT”中第“N”個單詞。
函數說明：如果“N”值大於字串“TEXT”中單詞的數目，返回空字符串。如果“N”爲0，出錯！
9.$(wordlist S,E,TEXT)
函數名稱：取字串函數—wordlist。
函數功能：從字串“TEXT”中取出從“S”開始到“E”的單詞串。“S”和“E”表示單詞在字串中位置的數字。
返回值：字串“TEXT”中從第“S”到“E”（包括“E”）的單詞字串。
函數說明：“S”和“E”都是從1開始的數字。
當“S”比“TEXT”中的字數大時，返回空。如果“E”大於“TEXT”字數，返回從“S”開始，到“TEXT”結束的單詞串。如果“S”大於“E”，返回空。
10.$(words TEXT)
函數名稱：統計單詞數目函數—words。
函數功能：字算字串“TEXT”中單詞的數目。
返回值：“TEXT”字串中的單詞數。
11.$(firstword NAMES…)
函數名稱：取首單詞函數—firstword。
函數功能：取字串“NAMES…”中的第一個單詞。
返回值：字串“NAMES…”的第一個單詞。
函數說明：“NAMES”被認爲是使用空格分割的多個單詞（名字）的序列。函數忽略“NAMES…”中除第一個單詞以外的所有的單詞。
二、文件名處理函數
1.$(dir NAMES…)
函數名稱：取目錄函數—dir。
函數功能：從文件名序列“NAMES…”中取出各個文件名目錄部分。文件名的目錄部分就是包含在文件名中的最後一個斜線（“/”）（包括斜線）之前的部分。
返回值：空格分割的文件名序列“NAMES…”中每一個文件的目錄部分。
函數說明：如果文件名中沒有斜線，認爲此文件爲當前目錄（“./”）下的文件。
2.$(notdir NAMES…)
函數名稱：取文件名函數——notdir。
函數功能：從文件名序列“NAMES…”中取出非目錄部分。目錄部分是指最後一個斜線（“/”）（包括斜線）之前的部分。刪除所有文件名中的目錄部分，只保留非目錄部分。
返回值：文件名序列“NAMES…”中每一個文件的非目錄部分。
函數說明：如果“NAMES…”中存在不包含斜線的文件名，則不改變這個文件名。以反斜線結尾的文件名，是用空串代替，因此當“NAMES…”中存在多個這樣的文件名時，返回結果中分割各個文件名的空格數目將不確定！這是此函數的一個缺陷。
3.$(suffix NAMES…)
函數名稱：取後綴函數—suffix。
函數功能：從文件名序列“NAMES…”中取出各個文件名的後綴。後綴是文件名中最後一個以點“.”開始的（包含點號）部分，如果文件名中不包含一個點號，則爲空。
返回值：以空格分割的文件名序列“NAMES…”中每一個文件的後綴序列。
函數說明：“NAMES…”是多個文件名時，返回值是多個以空格分割的單詞序列。如果文件名沒有後綴部分，則返回空。
4.$(basename NAMES…)
函數名稱：取前綴函數—basename。
函數功能：從文件名序列“NAMES…”中取出各個文件名的前綴部分（點號之後的部分）。前綴部分指的是文件名中最後一個點號之前的部分。
返回值：空格分割的文件名序列“NAMES…”中各個文件的前綴序列。如果文件沒有前綴，則返回空字串。
函數說明：如果“NAMES…”中包含沒有後綴的文件名，此文件名不改變。如果一個文件名中存在多個點號，則返回值爲此文件名的最後一個點號之前的文件名部分。
5.$(addsuffix SUFFIX,NAMES…)
函數名稱：加後綴函數—addsuffix。
函數功能：爲“NAMES…”中的每一個文件名添加後綴“SUFFIX”。參數“NAMES…”爲空格分割的文件名序列，將“SUFFIX”追加到此序列的每一個文件名的末尾。
返回值：以單空格分割的添加了後綴“SUFFIX”的文件名序列。
6.$(addprefix PREFIX,NAMES…)
函數名稱：加前綴函數—addprefix。
函數功能：爲“NAMES…”中的每一個文件名添加前綴“PREFIX”。參數“NAMES…”是空格分割的文件名序列，將“SUFFIX”添加到此序列的每一個文件名之前。
返回值：以單空格分割的添加了前綴“PREFIX”的文件名序列。
7.$(join LIST1,LIST2)
函數名稱：單詞連接函數——join。
函數功能：將字串“LIST1”和字串“LIST2”各單詞進行對應連接。就是將“LIST2”中的第一個單詞追加“LIST1”第一個單詞字後合併爲一個單詞；將“LIST2”中的第二個單詞追加到“LIST1”的第一個單詞之後並合併爲一個單詞，……依次列推。
返回值：單空格分割的合併後的字（文件名）序列。
函數說明：如果“LIST1”和“LIST2”中的字數目不一致時，兩者中多餘部分將被作爲返回序列的一部分。
8.$(wildcard PATTERN)
函數名稱：獲取匹配模式文件名函數—wildcard
函數功能：列出當前目錄下所有符合模式“PATTERN”格式的文件名。
返回值：空格分割的、存在當前目錄下的所有符合模式“PATTERN”的文件名。
函數說明：“PATTERN”使用shell可識別的通配符，包括“?”（單字符）、“*”（多字符）等。
三、其它函數
1.$(foreach VAR,LIST,TEXT)
函數功能：函數“foreach”不同於其它函數。它是一個循環函數。類似於Linux的shell中的循環（for語句）。這個函數的工作過程是這樣
的：如果必要（存在變量或者函數的引用），首先展開變量“VAR”和“LIST”；而表達式“TEXT”中的變量引用不被展開。執行時把“LIST”中使
用空格分割的單詞依次取出賦值給變量“VAR”，然後執行“TEXT”表達式。重複直到“LIST”的最後一個單詞（爲空時結束）。“TEXT”中的變量
或者函數引用在執行時才被展開，因此如果在“TEXT”中存在對“VAR”的引用，那麼“VAR”的值在每一次展開式將會到的不同的值。
返回值：空格分割的多次表達式“TEXT”的計算的結果。
2.$(if CONDITION,THEN-PART[,ELSE-PART])
函數功能：函數“if”提供了一個在函數上下文中實現條件判斷的功能。就像make所支持的條件語句—ifeq。第一個參數“CONDITION”，在函
數執行時忽略其前導和結尾空字符並展開。“CONDITION”的展開結果非空，則條件爲真，就將第二個參數“THEN_PATR”作爲函數的計算表達
式，函數的返回值就是第二表達式的計算結果；“CONDITION”的展開結果爲空，將第三個參數
“ELSE-PART”作爲函數的表達式，返回結果爲第三個表達式的計算結果。
返回值：根據條件決定函數的返回值是第一個或者第二個參數表達式的計算結果。當不存在第三個參數“ELSE-PART”，並且“CONDITION”展開爲空，函數返回空。
函數說明：函數的條件表達式“CONDITION”決定了，函數的返回值只能是“THEN-PART”或者“ELSE-PART”兩個之一的計算結果。
3.$(call VARIABLE,PARAM,PARAM,...)
函數功能：“call”函數是唯一一個可以創建定製參數化的函數的引用函數。我們可以將一個變量定義爲一個複雜的表達式，用“call”函數根據不同的參數對它進行展開來獲得不同的結果。
在執行時，將它的參數“PARAM”依次賦值給臨時變量“$(1)”、“$(2)”（這些臨時變量定義在“VARIABLE”的值中，參考下邊的例
子）……
call函數對參數的數目沒有限制，也可以沒有參數值，沒有參數值的“call”沒有任何實際存在的意義。執行時變量“VARIABLE”被展開爲在函數
上下文有效的臨時變量，變量定義中的“$(1)”作爲第一個參數，並將函數參數值中的第一個參數賦值給它；變量中的“$(2)”一樣被賦值爲函數的第二個
參數值；依此類推（變量$(0)代表變量“VARIABLE”本身）。之後對變量“VARIABLE” 表達式的計算值。
返回值：參數值“PARAM”依次替換“$(1)”、“$(2)”…… 之後變量“VARIABLE”定義的表達式的計算值。
函數說明：1.
函數中“VARIBLE”是一個變量名，而不是對變量的引用。因此，通常“call”函數中的“VARIABLE”中不包含“$”（當然，除了此變量名是
一個計算的變量名）。2.
當變量“VARIBLE”是一個make內嵌的函數名時（如“if”、“foreach”、“strip”等），對“PARAM”參數的使用需要注意，因
爲不合適或者不正確的參數將會導致函數的返回值難以預料。3. 函數中多個“PARAM”之間使用逗號分割。4.
變量“VARIABLE”在定義時不能定義爲直接展開式！只能定義爲遞歸展開式。
4.value函數
$(value VARIABLE)
函數功能：不對變量“VARIBLE”進行任何展開操作，直接返回變量“VARIBALE”代表的值。這裏“VARIABLE”是一個變量名，一般不包含“$”（當然，除了計算的變量名），
返回值：變量“VARIBALE”所定義文本值（不展開其中的變量或者函數應用）。
5.eval函數
函數功能：函數“eval”是一個比較特殊的函數。使用它我們可以在我們的Makefile中構造一個可變的規則結構關係（依賴關係鏈），其中可以使用其
它變量和函數。函數“eval”對它的參數進行展開，展開的結果作爲Makefile的一部分，make可以對展開內容進行語法解析。展開的結果可以包含
一個新變量、目標、隱含規則或者是明確規則等。也就是說此函數的功能主要是：根據其參數的關係、結構，對它們進行替換展開。
返回值：函數“eval”的返回值時空，也可以說沒有返回值。
函數說明：“eval”函數執行時會對它的參數進行兩次展開。第一次展開過程發是由函數本身完成的，第二次是函數展開後的結果被作爲Makefile內容
時由make解析時展開的。明確這一點對於使用“eval”函數非常重要。在理解了函數“eval”二次展開的過程後。實際使用時，當函數的展開結果中存
在引用（格式爲：$(x)）時，那麼在函數的參數中應該使用“$$”來代替“$”。因爲這一點，所以通常它的參數中會使用函數“value”來取一個變量
的文本值。
6.origin函數
$(origin VARIABLE)
函數功能：函數“origin”查詢參數“VARIABLE”（通常是一個變量名）的出處。
函數說明：“VARIABLE”是一個變量名而不是一個變量的引用。因此通常它不包含“$”（當然，計算的變量名例外）。
返回值：返回“VARIABLE”的定義方式。用字符串表示。
. undefined
變量“VARIABLE”沒有被定義。
. default
變量“VARIABLE”是一個默認定義（內嵌變量）。如“CC”、“MAKE”、“RM”等變量。如果在Makefile中重新定義這些變量，函數返回值將相應發生變化。
. environment
變量“VARIABLE”是一個系統環境變量，並且make沒有使用命令行選項“-e”（Makefile中不存在同名的變量定義，此變量沒有被替代）。
. environment override
變量“VARIABLE”是一個系統環境變量，並且make使用了命令行選項“-e”。Makefile中存在一個同名的變量定義，使用“make -e”時環境變量值替代了文件中的變量定義。
. file
變量“VARIABLE”在某一個makefile文件中定義。
. command line
變量“VARIABLE”在命令行中定義。
. override
變量“VARIABLE”在makefile文件中定義並使用“override”指示符聲明。
. automatic
變量“VARIABLE”是自動化變量。
7.shell函數
不同於除“wildcard”函數之外的其它函數。make可以使用它來和外部通信。
函數功能：函數“shell”所實現的功能和shell中的引用（``）相同。實現了命令的擴展。意味着需要一個shell
命令作爲它的參數，而返回的結果是此命令在shell中的執行結果。make僅僅對它的回返結果進行處理；make將函數的返回結果中的所有換行符
（“/n”）或者一對“/n/r”替換爲單空格；並去掉末尾的回車符號（“/n”）或者“/n/r”。函數展開式時，它所調用的命令（它的參數）得到執
行。除了對它的引用出現在規則的命令行中和遞歸的變量定義引用以外，其它決大多數情況下，make在讀取Makefile時函數shell就被擴展。
返回值：函數“shell”的參數在shell中的執行結果。
函數說明：函數本身的返回值是其參數的執行結果，沒有進行任何處理。對結果的處理是由make進行的。當對函數的引用出現在規則的命令行中，命令行在執行
時函數引用才被展開。展開過程函數參數的執行時在另外一個shell進程中完成的，因此對於出現在規則命令行的多級“shell”函數引用需要謹慎處理，
否則會影響效率（每一級的“shell”函數的參數都會有各自的shell進程）。
8.error 函數
$(error TEXT…)
函數功能：產生致命錯誤，並提示“TEXT…”信息給用戶，之後退出make的執行。需要說明的是：“error”函數是在函數展開式（函數被調用時）才
提示信息並結束make進程。因此如果函數出現在命令中或者一個遞歸的變量定義中時，在讀取Makefile時不會出現錯誤。而只有包含
“error”函數引用的命令被執行，或者定義中引用此函數的遞歸變量被展開時，纔會提示致命信息“TEXT…”同時make退出執行。
返回值：空字符
函數說明：“error”函數一般不出現在直接展開式的變量定義中，否則在make讀取Makefile時將會提示致命錯誤。
9. warning 函數
$(warning TEXT…)
函數功能：函數“warning”類似於函數“error”，區別在於它不會導致致命錯誤（make不退出），而只是提示“TEXT…”，make的執行過程繼續。
返回值：空字符
函數說明：用法和“error”類似，展開過程相同。
