Makefile中的函數

Makefile 中的函數

Makefile 中自帶了一些函數, 利用這些函數能夠簡化 Makefile 的編寫.

函數調用語法以下:

$(<function> <arguments>) # 或者 ${<function> <arguments>}

• <function> 是函數名
• <arguments> 是函數參數

1.1 字符串函數

字符串替換函數: $(subst <from>,<to>,<text>)

功能: 把字符串<text> 中的 <from> 替換爲 <to>

返回: 替換過的字符串

# Makefile 內容
all:
    @echo $(subst t,e,maktfilt)  <-- 將t替換爲e # bash 中執行 make $ make makefile

 

模式字符串替換函數: $(patsubst <pattern>,<replacement>,<text>)

功能: 查找<text>中的單詞(單詞以"空格", "tab", "換行"來分割) 是否符合 <pattern>, 符合的話, 用 <replacement> 替代.

返回: 替換過的字符串

# Makefile 內容
all:
    @echo $(patsubst %.c,%.o,programA.c programB.c) # bash 中執行 make $ make programA.o programB.o

 

去空格函數: $(strip <string>)

功能: 去掉 <string> 字符串中開頭和結尾的空字符

返回: 被去掉空格的字符串值

# Makefile 內容
VAL := " aa bb cc " all: @echo "去除空格前: " $(VAL) @echo "去除空格後: " $(strip $(VAL)) # bash 中執行 make $ make 去除空格前: aa bb cc 去除空格後: aa bb cc

 

查找字符串函數: $(findstring <find>,<in>)

功能: 在字符串 <in> 中查找 <find> 字符串

返回: 若是找到, 返回 <find> 字符串,  不然返回空字符串

# Makefile 內容
VAL := " aa bb cc " all: @echo $(findstring aa,$(VAL)) @echo $(findstring ab,$(VAL)) # bash 中執行 make $ make aa

 

過濾函數: $(filter <pattern...>,<text>)

功能: 以 <pattern> 模式過濾字符串 <text>, *保留* 符合模式 <pattern> 的單詞, 能夠有多個模式

返回: 符合模式 <pattern> 的字符串

# Makefile 內容
all:
    @echo $(filter %.o %.a,program.c program.o program.a) # bash 中執行 make $ make program.o program.a

 

反過濾函數: $(filter-out <pattern...>,<text>)

功能: 以 <pattern> 模式過濾字符串 <text>, *去除* 符合模式 <pattern> 的單詞, 能夠有多個模式

返回: 不符合模式 <pattern> 的字符串

# Makefile 內容
all:
    @echo $(filter-out %.o %.a,program.c program.o program.a) # bash 中執行 make $ make program.c

 

排序函數: $(sort <list>)

功能: 給字符串 <list> 中的單詞排序 (升序)

返回: 排序後的字符串

# Makefile 內容
all:
    @echo $(sort bac abc acb cab) # bash 中執行 make $ make abc acb bac cab

 

取單詞函數: $(word <n>,<text>)

功能: 取字符串 <text> 中的 第<n>個單詞 (n從1開始)

返回: <text> 中的第<n>個單詞, 若是<n> 比 <text> 中單詞個數要大, 則返回空字符串

# Makefile 內容
all:
    @echo $(word 1,aa bb cc dd) @echo $(word 5,aa bb cc dd) @echo $(word 4,aa bb cc dd) # bash 中執行 make $ make aa dd

 

取單詞串函數: $(wordlist <s>,<e>,<text>)

功能: 從字符串<text>中取從<s>開始到<e>的單詞串. <s>和<e>是一個數字.

返回: 從<s>到<e>的字符串

# Makefile 內容
all:
    @echo $(wordlist 1,3,aa bb cc dd) @echo $(word 5,6,aa bb cc dd) @echo $(word 2,5,aa bb cc dd) # bash 中執行 make $ make aa bb cc bb

 

單詞個數統計函數: $(words <text>)

功能: 統計字符串 <text> 中單詞的個數

返回: 單詞個數

# Makefile 內容

all:
    @echo $(words aa bb cc dd) @echo $(words aabbccdd) @echo $(words ) # bash 中執行 make $ make 4 1 0

 

首單詞函數: $(firstword <text>)

功能: 取字符串 <text> 中的第一個單詞

返回: 字符串 <text> 中的第一個單詞

# Makefile 內容
all:
    @echo $(firstword aa bb cc dd) @echo $(firstword aabbccdd) @echo $(firstword ) # bash 中執行 make $ make aa aabbccdd

 

1.2 文件名函數

取目錄函數: $(dir <names...>)

功能: 從文件名序列 <names> 中取出目錄部分

返回: 文件名序列 <names> 中的目錄部分

# Makefile 內容
all:
    @echo $(dir /home/a.c ./bb.c ../c.c d.c) # bash 中執行 make $ make /home/ ./ ../ ./

 

取文件函數: $(notdir <names...>)

功能: 從文件名序列 <names> 中取出非目錄部分

返回: 文件名序列 <names> 中的非目錄部分

# Makefile 內容
all:
    @echo $(notdir /home/a.c ./bb.c ../c.c d.c) # bash 中執行 make $ make a.c bb.c c.c d.c

 

取後綴函數: $(suffix <names...>)

功能: 從文件名序列 <names> 中取出各個文件名的後綴

返回: 文件名序列 <names> 中各個文件名的後綴, 沒有後綴則返回空字符串

# Makefile 內容
all:
    @echo $(suffix /home/a.c ./b.o ../c.a d) # bash 中執行 make $ make .c .o .a

 

取前綴函數: $(basename <names...>)

功能: 從文件名序列 <names> 中取出各個文件名的前綴

返回: 文件名序列 <names> 中各個文件名的前綴, 沒有前綴則返回空字符串

# Makefile 內容
all:
    @echo $(basename /home/a.c ./b.o ../c.a /home/.d .e) # bash 中執行 make $ make /home/a ./b ../c /home/

 

加後綴函數: $(addsuffix <suffix>,<names...>)

功能: 把後綴 <suffix> 加到 <names> 中的每一個單詞後面

返回: 加事後綴的文件名序列

# Makefile 內容
all:
    @echo $(addsuffix .c,/home/a b ./c.o ../d.c) # bash 中執行 make $ make /home/a.c b.c ./c.o.c ../d.c.c

 

加前綴函數: $(addprefix <prefix>,<names...>)

功能: 把前綴 <prefix> 加到 <names> 中的每一個單詞前面

返回: 加過前綴的文件名序列

# Makefile 內容
all:
    @echo $(addprefix test_,/home/a.c b.c ./d.c) # bash 中執行 make $ make test_/home/a.c test_b.c test_./d.c

 

鏈接函數: $(join <list1>,<list2>)

功能: <list2> 中對應的單詞加到 <list1> 後面

返回: 鏈接後的字符串

# Makefile 內容
all:
    @echo $(join a b c d,1 2 3 4) @echo $(join a b c d,1 2 3 4 5) @echo $(join a b c d e,1 2 3 4) # bash 中執行 make $ make a1 b2 c3 d4 a1 b2 c3 d4 5 a1 b2 c3 d4 e

 

1.3 foreach

語法:

$(foreach <var>,<list>,<text>)

 

示例:

# Makefile 內容
targets := a b c d objects := $(foreach i,$(targets),$(i).o) all: @echo $(targets) @echo $(objects) # bash 中執行 make $ make a b c d a.o b.o c.o d.o

 

1.4 if

這裏的if是個函數, 和前面的條件判斷不同, 前面的條件判斷屬於Makefile的關鍵字

語法:

$(if <condition>,<then-part>)

$(if <condition>,<then-part>,<else-part>)

 

示例:

# Makefile 內容
val := a objects := $(if $(val),$(val).o,nothing) no-objects := $(if $(no-val),$(val).o,nothing) all: @echo $(objects) @echo $(no-objects) # bash 中執行 make $ make a.o nothing

 

1.5 call - 建立新的參數化函數

語法:

$(call <expression>,<parm1>,<parm2>,<parm3>...)

 

示例:

# Makefile 內容
log = "====debug====" $(1) "====end====" all: @echo $(call log,"正在 Make") # bash 中執行 make $ make ====debug==== 正在 Make ====end====

 

1.6 origin - 判斷變量的來源

語法:

$(origin <variable>)

返回值有以下類型:

類型	含義
undefined	<variable> 沒有定義過
default	<variable> 是個默認的定義, 好比 CC 變量
environment	<variable> 是個環境變量, 而且 make時沒有使用 -e 參數
file	<variable> 定義在Makefile中
command line	<variable> 定義在命令行中
override	<variable> 被 override 從新定義過
automatic	<variable> 是自動化變量

 

示例:

# Makefile 內容
val-in-file := test-file override val-override := test-override all: @echo $(origin not-define) # not-define 沒有定義 @echo $(origin CC) # CC 是Makefile默認定義的變量 @echo $(origin PATH) # PATH 是 bash 環境變量 @echo $(origin val-in-file) # 此Makefile中定義的變量 @echo $(origin val-in-cmd) # 這個變量會加在 make 的參數中 @echo $(origin val-override) # 此Makefile中定義的override變量 @echo $(origin @) # 自動變量, 具體前面的介紹 # bash 中執行 make $ make val-in-cmd=val-cmd undefined default environment file command line override automatic

 

1.7 shell

語法:

$(shell <shell command>)

它的做用就是執行一個shell命令, 並將shell命令的結果做爲函數的返回.

做用和 `<shell command>` 同樣, ` 是反引號

 

1.8 make 控制函數

產生一個致命錯誤: $(error <text ...>)

功能: 輸出錯誤信息, 中止Makefile的運行

# Makefile 內容
all:
    $(error there is an error!) @echo "這裏不會執行!" # bash 中執行 make $ make Makefile:2: *** there is an error!. Stop.

 

輸出警告: $(warning <text ...>)

功能: 輸出警告信息, Makefile繼續運行

# Makefile 內容
all:
    $(warning there is an warning!) @echo "這裏會執行!" # bash 中執行 make $ make Makefile:2: there is an warning! 這裏會執行!