字符串操作函数
wildcard
用法:$(wildcard pattern…)
描述:匹配任何满足匹配规则的文件
返回:返回包含所有匹配项的字符串
subst
用法:$(subst from,to,text)
描述:将text中匹配from的字符替换为to
返回:被替换后的字符串
例子:
$(subst ee,EE,feet on the street)
结果:
‘fEEt on the strEEt’
patsubst
用法:$(patsubst pattern,replacement,text)
描述:text中以空格分割的每个子串若匹配模式pattern则替换成replacement
返回:替换后的字符串
例子:
$(patsubst %.c,%.o,x.c.c bar.c)
$(var:suffix=replacement) 等价于 $(patsubst %suffix,%replacement,$(var))
结果:
‘x.c.o bar.o’
strip
用法:$(strip string)
描述:去掉字符串头或尾的空白字符
返回:头或尾无空白字符的字符串
findstring
用法:$(findstring find,in)
描述:查找满足查找条件find的字符串
返回:查找结果
例子:
$(findstring a,a b c)
结果:
'a'
filter
用法:$(filter pattern…,text)
描述:过滤所有满足模式pattern的字符串
返回:符合pattern的字符串
例子:
sources := foo.c bar.c baz.s ugh.h
foo: $(sources)
cc $(filter %.c %.s,$(sources)) -o foo
结果:
'foo.c, bar.c, baz.s'
filter-out
用法:$(filter-out pattern…,text)
描述:过滤所有不满足模式pattern的字符串
返回:不符合pattern的字符串
sort
用法:$(sort list)
描述:按首字母排序
返回:排序后的字符串,空格分割
例子:
$(sort foo bar lose)
结果:
‘bar foo lose’
word
用法:$(word n,text)
描述:获取以空格分隔的字符串中的第n个子串,n从1开始
返回:第n个子串
例子:
$(word 2, foo bar baz)
结果:
‘bar’
wordlist
用法:$(wordlist s,e,text)
描述:获取s->e的n个子串
返回:返回从s开始到e的子串
words
用法:$(words text)
描述:获取子串个数
返回:返回用空格分隔的子串的个数
firstword
用法:$(firstword names…)
描述:获取第一个子串
返回:第一个子串
lastword
用法:$(lastword names…)
描述:获取最后一个子串
返回:最后一个子串
文件操作函数
dir
用法:$(dir names…)
描述:获取当前names中的每个文件所对应的目录
返回:对应的目录字符串
例子:
$(dir src/foo.c hacks)
结果:
‘src/ ./’
notdir
用法:$(notdir names…)
描述:获取当前names中的字符串所描述的文件部分
返回:文件名字符串
例子:
$(notdir src/foo.c hacks)
结果:
‘foo.c hacks’
suffix
用法:$(suffix names…)
描述:返回文件后缀
例子:
$(suffix src/foo.c src-1.0/bar.c hacks)
结果:
‘.c .c’
basename
用法:$(basename names…)
描述:获取文件不带后缀的名
例子:
$(basename src/foo.c src-1.0/bar hacks)
结果:
‘src/foo src-1.0/bar hacks’
addsuffix
用法:$(addsuffix suffix,names…)
描述:给文件名添加后缀
例子:
$(addsuffix .c,foo bar)
结果:
‘foo.c bar.c’
addprefix
用法:$(addprefix prefix,names…)
描述:给文件名添加前缀
例子:
$(addprefix src/,foo bar)
结果:
‘src/foo src/bar’
join
用法:$(join list1,list2)
描述:将list1与list2连接起来
例子:
$(join a b,.c .o)
结果:
‘a.c b.o’
realpath
用法:$(realpath names…)
描述:返回每个文件的绝对路径
abspath
用法:$(abspath names…)
描述:与realpath功能相同,但abspath不处理链接,也不保证相应文件一定存在
条件判断函数
if
用法:$(if condition,then-part[,else-part])
描述:用于if条件判断
or
用法:$(or condition1[,condition2[,condition3…]])
描述:用于或条件判断
and
用法:$(and condition1[,condition2[,condition3…]])
描述:用于与条件判断
其它函数
foreach
用法:$(foreach var,list,text)
描述:遍历list中的元素,text是额外的过滤条件
例子:
dirs := a b c d
files := $(foreach dir,$(dirs),$(wildcard $(dir)/*))
结果:
files := $(wildcard a/* b/* c/* d/*)
file
用法:$(file op filename[,text])
描述:用于读写文件,读模式下没有参数text,写模式下text将被写入文件filename,op与filename之间可以没有空格分隔
op的可选项为:
<——读
>——写
>>——追加写
例子:
program: $(OBJECTS)
$(file >$@.in,$^)
$(CMD) $(CMDFLAGS) @$@.in
@rm $@.in
call
用法:$(call variable,param,param,…)
描述:可以创建复杂的宏定义表达式,用call进行展开
例子:
pathsearch = $(firstword $(wildcard $(addsuffix /$(1),$(subst :, ,$(PATH)))))
LS := $(call pathsearch,ls)
结果:
LS将变成一个可用的ls命令所在的路径
value
用法:$(value variable)
描述:
例子:
FOO = $PATH
all:
@echo $(FOO)
@echo $(value FOO)
eval
用法:$(eval expression)
描述:eval包含的表达式或值会被扩展两次,返回值为空
例子:
PROGRAMS = server client
server_OBJS = server.o server_priv.o server_access.o
server_LIBS = priv protocol
client_OBJS = client.o client_api.o client_mem.o
client_LIBS = protocol
.PHONY: all
all: $(PROGRAMS)
define PROGRAM_template =
$(1): $$($(1)_OBJS) $$($(1)_LIBS:%=-l%)
ALL_OBJS += $$($(1)_OBJS)
endef
$(foreach prog,$(PROGRAMS),$(eval $(call PROGRAM_template,$(prog))))
$(PROGRAMS):
$(LINK.o) $^ $(LDLIBS) -o $@
clean:
rm -f $(ALL_OBJS) $(PROGRAMS)
origin
用法:$(origin variable)
描述:用于检查一个变量的属性
返回:
‘undefined’——这个变量未定义
‘default’——该变量默认被定义,如CC等
‘environment’——表明该变量继承自环境变量
‘environment override’——变量继承自环境变量,在makefile中已经被重写
‘file’——该变量在makefile中被定义
‘command line’——该变量在命令行中被定义
‘override’——该变量在makefile中用override重写
‘automatic’——该变量是一个自动变量
flavor
用法:$(flavor variable)
描述:检查变量的属性
返回:
‘undefined’——这个变量未定义
‘recursive’——变量是一个递归展开的变量
‘simple’——变量是一个简单展开的变量
shell
用法:$(shell command)
描述:执行shell命令
guile
用法:$(guile variable)
描述:variable先会由make进行扩展,然后会被送入GNU Guile求值器,最终求值器得到的值会被转化为字符串作为variable的最终结果
控制make的函数
error
用法:$(error text…)
描述:产生一个错误信息,终止编译
warn
用法:$(warning text…)
描述:产生一个警告信息
info
用法:$(info text…)
描述:打印常规log信息