8 函数
函数允许你在makefile中处理文本,用于计算文件,操作和执行recipes。在函数调用中提供函数名和函数操作的参数。函数处理的结果替换到函数在makefile中调用的位置,就像变量被替换一样。
8.1 函数调用语法
函数调用类似于变量引用。它可以出现在任何变量引用可以出现的地方,使用与变量引用同样的扩展规则。函数调用语法如下:
$(function arguments)
或者:
${function arguments}
这里function
是函数名,是make函数列表中的一个。可以使用call
创建自己的函数。
arguments
表示函数的参数,与函数名用若干空格或tab隔开,如果有多个参数,用逗号隔开。空格和逗号不是参数值的一部分。函数调用时两边的分隔符(圆括号或花括号)只能成对出现在变量中,其它种类的分隔符可以单独出现。如果参数中包含其它的函数调用或变量引用,最好使用相同种类的分隔符,例如,写成$(subst a,b,$(x))
,而不是$(subst a,b,${x})
。这样更清晰,因为只有一种类型的分隔符需要被匹配。
写作参数的文本通过变量和函数调用处理,最终生成参数的值,也就是函数操作的文本。替换的顺序和参数出现的顺序一致。
逗号、未配对的圆括号或花括号不可以出现在参数文本中,前导空格不可以当作第一个参数文本的一部分。这些字符通过变量替换放到参数值当中。下面例子中,前面定义的变量comma
和space
,它们的值分别是逗号和空格字符,然后需要这些字符的地方,使用这两个变量替换即可:
comma:= ,
empty:=
space:= $(empty) $(empty)
foo:= a b c
bar:= $(subst $(space),$(comma),$(foo))
# bar is now 'a,b,c'
这里subst
函数替换foo
中每个空格为逗号,并返回替换结果。
8.2 字符串操作函数
下面是一些操作字符串的函数:
$(subst from,to,text)
实现对
text
的文本替换:每个在text
中的from
都替换成to
。结果是替换后的字符串,例如:$(subst ee,EE,feet on the street)
结果为
fEEt on the strEEt
。$(patsubst pattern,replacement,text)
查找
text
中用空格分隔的匹配pattern
模板的单词,并用replacement
替换之。这里pattern
可能包含%
通配符,匹配一个单词的任意多个任意字符。如果replacement
中也包含%
,那这个%
用pattern
中匹配的部分替换。只有pattern
和replacement
中的第一个%
会被当作通配符,之后的%
表示字符本身。
在patsubst
函数调用中,%
字符可以使用\
引用。反斜杆\
也可以引用反斜杆本身。当比较文件名或进行词干替换之前,作为引用字符的\
会被移除。例如,模板the\%weird\\%pattern\\
使用通配符%
分割为the%weird\
和pattern\\
两部分。最后两个反斜杆被保留,因为它们不能影响%
字符。
单词之间的空格被视为一个空格,开头和结尾的空格被忽略。
例如:$(patsubst %.c,%.o,x.c.c bar.c)
结果为
x.c.o bar.o
。$(var:pattern=replacement)
等效于:
$(patsubst pattern,replacement,$(var))
第二个简化
patsubst
的一个普遍用法是替换文件的后缀:$(var:suffix=replacement)
等效于:
$(patsubst %suffix,%replacement,$(var))
例如,有一个
objects
文件列表:objects = foo.o bar.o baz.o
为获得对应的源文件列表,可以写作:
$(objects:.o=.c)
而不是:
$(patsubst %.o,%.c,$(objects))
$(strip string)
用来移除字符串开头和结尾的空格,并且字符串中的的连续多个空格会替换为一个。因此,
$(strip a b c )
结果为'a b c'
。
函数strip
在连接条件指令时非常有用。当使用ifeq
或ifneq
将字符串与空字符串''
比较时,你通常想让只包含空格的字符串作为空字符串。
因此,下面的语句可能得不到想要的结果:.PHONY: all ifneq "$(needs_made)" "" all: $(needs_made) else all:;@echo 'Nothing to make!' endif
将
ifneq
指令中的变量引用$(needs_made)
替换为函数调用$(strip $(needs_made))
,会使程序更健壮。$(findstring find,in)
在
in
中查找find
。如果找到,返回find
,否则结果为空。你可以在条件测试中使用这个函数判断给定字符串中是否包含一个特定子字符串。下面两个例子:$(findstring a,a b c) $(findstring a,b c)
分别返回
'a'
和''
。$(filter pattern...,text)
返回
text
中用空格分隔的所有匹配pattern
的单词,删除所有不匹配的单词。pattern
使用通配符%
,就像函数patsubst
中一样。
函数filter
可以用于分离变量中不同类型的字符串(比如文件名)。例如:sources := foo.c bar.c baz.s ugh.h foo: $(sources) cc $(filter %.c %.s,$(sources)) -o foo
表示
foo
基于文件foo.c
,bar.c
,baz.s
和ugh.h
,但是在编译时只使用foo.c
,bar.c
和baz.s
。$(filter-out pattern...,text)
返回
text
中所有不匹配pattern
的以空格分隔的单词,删除所有匹配的单词。相对于函数filter
。
例如,给定:objects=main1.o foo.o main2.o bar.o mains=main1.o main2.o
下面的语句生成一个不包含
mains
中文件的所有objects
文件列表:$(filter-out $(mains),$(objects))
$(sort list)