makefile(3)函数

前言

学习make和makefile的主要目的是分析大型项目的源代码的关系,上一节我们讲述了makefile 中的变量,本节主要学习一下 makefile 中的函数,首先函数肯定可以分为几部分:

• 内置函数
• 用户自动义函数
• 函数的调用
• ..

函数的语法

make 下所有函数都有如下形式:

1	$(function-name arg1[,arg2,arg3,..])

我们首先来看内置函数:

内置函数

make 的内置函数可分类如下:

字符串函数

$(filter pattern …,text)

pattern 中可以使用 % 来做通配符,值得注意的是: 每个 pattern 只支持 1 个 % ,比如:

1 2 3 4 5 6

//makefile words := he the hen other the% get-word: @echo he matches: $(filter he,$(words)) @echo th% matches: $(filter th%,$(words)) @echo %th% matches: $(filter %th%,$(words))

结果为:

1 2 3 4

//result he matches: he th% matches: the the% %th% matches: #最后一个不匹配,因为words中不存在以th%为结尾的单词

$(filter-out pattern ..,text)

filter-out同filter相反,比如:

1 2 3 4 5

//makefile words := he the hen other the% get-word: @echo %th% matches: $(filter %th%,$(words)) @echo %th% matches: $(filter-out %th%,$(words))

结果为:

1 2 3

//result %th% matches: %th% matches: he the hen other the%

$(findstring string…,text)

此函数所返回会的只是“搜索字符”而不是包含搜索字符的字符,另外不支持pattern

1 2 3 4 5

words := he the hen other the% get-word: @echo %th% matches: $(findstring %th%,$(words)) @echo he matches: $(findstring he,$(words)) @echo he% matches: $(findstring he%,$(words))

结果为:

1 2 3

%th% matches: he matches: he he% matches: he%

$(subst search-string,replace-string,text)

不具有通配符能力的搜索替换函数,最经常使用于替换文件名列表的扩展名,如:

1 2 3 4 5

sources := fun.c foo.c objects := $(subst .c,.o,$(sources)) target: @echo $(objects)

结果为:

1	fun.o foo.o

$(patsubst search-pattern,replace-pattern,text)

具有通配符能力的替换功能,有几个注意点:

• 此处的模式只可以包含一个 % 字符
• replace-pattern中的百分比符号会被替换成与符号相符的文字
• search-pattern必须和text的整个值进行匹配

1 2 3 4

source := main.c object := $(patsubst %.c,%.o,$(source)) target: gcc -c $(source) -o $(object)

结果为:

1	gcc -c main.c -o main.o

单词函数

$(words text)

统计text中单词个数 ,按照”space(空格)”进行拆分

1 2 3 4

CURRENT_PATH := $(subst /, ,$(PWD)) words: @echo current path $(PWD) @echo current path has $(words $(CURRENT_PATH)) directories

结果为:

1 2	current path /Users/hejianglin/study/makefile current path has 4 directories

$(word n,text)

“space(空格)”进行拆分,返回 text 中的第 n 个单词,开始编号为 1,如果找不到相应的位置则返回空

1 2 3 4

CURRENT_PATH := $(subst /, ,$(PWD)) words: @echo current path $ 大专栏  makefile(3)函数(PWD) @echo current path second word: $(word 2,$(CURRENT_PATH))

结果为:

1 2	current path /Users/hejianglin/study/makefile current path second word: hejianglin

$(wordlist start,end,text)

“space(空格)”进行拆分,返回 text 中的第 start(含) 到 end(含) 的单词,开始编号为 1,如果找不到相应的位置则返回空

文件名函数

$(wildcard pattern..)

文件列表

1 2 3 4 5

source := $(wildcard src/*.c include/*.h) .PHONY: test test: @echo $(source)

结果为:

1	src/foo.c src/fun.c src/main.c include/foo.h include/fun.h

$(dir list…)

目录列表

1 2 3 4 5

source := $(wildcard src/*.c include/*.h) .PHONY: test test: @echo $(dir $(source))

结果为:

1	src/ src/ src/ include/ include/

$(notdir list..)

删除目录的文件列表

1 2 3 4 5

source := $(wildcard src/*.c include/*.h) .PHONY: test test: @echo $(notdir $(source))

结果为:

1	foo.c fun.c main.c foo.h fun.h

$(suffix name…)

返回每个单词的后缀

$(basename name…)

suffix的反函数

$(addsuffix suffix, name…)

添加后缀名称

$(addprefix prefix,name…)

addsuffix的反函数,添加前缀

$(join prefix-list,suffix-list)

连接字符,dir 和 notdir 的反函数

1 2 3 4 5 6

source := $(wildcard src/*.c include/*.h) prefix_dir := $(dir $(source)) suffix_file := $(notdir $(source)) .PHONY: test test: @echo join $(join $(prefix_dir),$(suffix_file))

结果为:

1	join src/foo.c src/fun.c src/main.c include/foo.h include/fun.h

其他

$(sort list)

排序 list 并移除重复项,排序优先级: 数字 > 字母,字母按照升序排序:

1 2 3

source := b c 1 2 d 0 c target: @echo sort source: $(sort $(source))

结果为:

1	sort source: 0 1 2 b c d

$(shell command)

执行 shell 命令,输出的换行被替换成单一的空格符号,错误和状态都不会返回

1 2 3 4

.PHONY: test CURRENT_DATE = $(shell date +%Y%m%d) test: @echo $(CURRENT_DATE)

结果为:

1

20180610

流程控制

if

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

只要 condition 返回不为空,则为 true 便会执行 then-part, 否则执行 else-part

1 2 3 4 5 6

$(if $(filter $(MAKE_VERSION),3.79 3,80),, $(error requires makefile version -.)) .PHONY: test test: @echo join $(join $(prefix_dir),$(suffix_file))

结果为:

1	makefile:1: *** requires makefile version -.. Stop.

因为本机的 make 版本是 3.81

for/while

$(foreach variable,list,body)

==这个函数实在难以理解(用法…),跳过吧==