编译工具之makefile的常用函数

字符串操作函数

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信息