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)

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

上一篇:Java中的String类下的正则表达式运用附带编程题解析


下一篇:boolean matches(String regex)正则表达式判断当前字符串是否满足格式要求