系列文章目录
文章目录
五、条件判断和函数使用
第一章请移步这里。
5.1 条件判断
- 使用条件判断,可以让make根据运行时的不同情况选择不同的执行分支。条件表达式可以是比较变量的值,或是比较变量和常量的值。
libs_for_gcc = -lgnu
normal_libs =
foo: $(objects)
ifeq ($(CC),gcc)
$(CC) -o foo $(objects) $(libs_for_gcc)
else
$(CC) -o foo $(objects) $(normal_libs)
endif
可见,在上面示例的这个规则中,目标 foo
可以根据变量 $(CC)
值来选取不同的函数库来编译程序。
- 示例中规则也可简化如下:
libs_for_gcc = -lgnu
normal_libs =
ifeq ($(CC),gcc)
libs=$(libs_for_gcc)
else
libs=$(normal_libs)
endif
foo: $(objects)
$(CC) -o foo $(objects) $(libs)
5.2 函数调用语法
- 函数调用,很像变量的使用,也是以 $ 来标识的,其语法如下:
$(<function> <arguments>)
## 或是:
${<function> <arguments>}
<function>
函数名,<arguments>
为函数的参数,参数间以逗号,
分隔,而函数名和参数之间以“空格”分隔。函数调用以$
开头,以圆括号或花括号把函数名和参数括起。
5.3 字符串处理函数
5.3.1 subst
$(subst <from>,<to>,<text>)
- 名称:字符串替换函数
- 功能:把
<text>
中的<from>
字符串替换成<to>
。 - 返回:函数返回被替换过后的字符串。
- 示例:
$(subst b,B,basketball)
- 把
basketball
中的b
替换成B
,返回Basketball
。
5.3.2 patsubst
$(patsubst <pattern>,<replacement>,<text>)
-
名称:模式字符串替换函数。
-
功能:查找
<text>
中的单词(单词以“空格”、“Tab”或“回车”“换行”分隔)是否符合模式<pattern>
,如果匹配的话,则以<replacement>
替换。这里,<pattern>
可以包括通配符%
,表示任意长度的字串。如果<replacement>
中也包含%
,那么,<replacement>
中的这个%
将是<pattern>
中的那个%
所代表的字串。(可以用\
来转义,以\%
来表示真实含义的%
字符) -
返回:函数返回被替换过后的字符串。
-
示例:
$(patsubst %.c,%.o,x.c.c bar.c)
-
把字串
x.c.c bar.c
符合模式%.c
的单词替换成%.o
,返回结果是x.c.o bar.o
,这里<pattern>
和<replacement>
中都包含%
,所以示例中的%
代表x.c
和bar
。 -
备注:
objects = foo.o bar.o baz.o,
-
这里
$(objects:.o=.c)
和$(patsubst %.o,%.c,$(objects))
一样。
5.3.3 strip
$(strip <string>)
- 名称:去空格函数。
- 功能:去掉
<string>
字串中开头和结尾的空字符。 - 返回:返回被去掉空格的字符串值。
5.3.4 findstring
$(findstring <find>,<in>)
-
名称:查找字符串函数
-
功能:在
<in>
中查找<find>
字串。 -
返回:如果找到,那么返回
<find>
,否则返回空字符串。 -
示例:
$(findstring a,a b c) #返回 a $(findstring a,b c) #返回 空字符串
5.3.5 filter
$(filter <pattern...>,<text>)
-
名称:过滤函数
-
功能:以
<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
5.3.6 filter-out
$(filter-out <pattern...>,<text>)
-
名称:反过滤函数
-
功能:以
<pattern>
模式过滤<text>
字符串中的单词,保留不符合模式<pattern>
的单词。可以同时指定多个模式。 -
返回:返回不符合模式
<pattern>
的字串。 -
示例:
objects=main1.o foo.o main2.o bar.o mains=main1.o main2.o ##返回:foo.o bar.o
5.3.7 sort
$(sort <list>)
- 名称:排序函数
- 功能:给字符串 中的单词排序(升序)。
- 返回:返回排序后的字符串。
- 示例:
$(sort foo bar lose lose)
- 返回: bar foo lose
- 备注:
sort
函数会去掉<list>
中相同的单词(类似于Python中的set
去重)。
5.3.8 word
$(word <n>,<text>)
-
名称:取单词函数
-
功能:取字符串
<text>
中第<n>
个单词。(从1开始) -
返回:返回字符串
<text>
中第<n>
个单词。如果<n>
比<text>
中的单词数要大,那么返回空字
符串。 -
示例:
$(word 2, foo bar baz) #返回值是 bar
5.3.9 wordlist
$(wordlist <ss>,<e>,<text>)
-
名称:取单词串函数
-
功能:从字符串
<text>
中取从 <ss>
开始到<e>
的单词串。<ss>
和<e>
是一个数字。 -
返回:返回字符串
<text>
中从<ss>
到<e>
的单词字串。如果<ss>
比<text>
中的单词数要大,那么返回空字符串。如果<e>
大于<text>
的单词数,那么返回从<ss>
开始,到<text>
结束的单词串。 -
示例:
$(wordlist 2, 3, foo bar baz) # 返回值:bar baz
5.3.10 words
$(words <text>)
-
名称:单词个数统计函数
-
功能:统计
<text>
中字符串中的单词个数。 -
返回:返回
<text>
中的单词数。 -
示例:
$(words, foo bar baz) #返回值: 3
-
备注:如果我们要取
<text>
中最后的一个单词,可以这样写:$(word $(words <text>),<text>)
。
5.3.11 firstword
$(firstword <text>)
- 名称:首单词函数——firstword。
- 功能:取字符串
中的第一个单词。 - 返回:返回字符串
的第一个单词。 - 示例:
$(firstword foo bar)
返回值:foo
- 备注:这个函数可以用 word 函数来实现:
$(word 1,<text>)
。 - 以上,是所有的字符串操作函数,如果搭配混合使用,可以完成比较复杂的功能。这里,举一个现实中应用的例子。我们知道,make 使用 VPATH 变量来指定“依赖文件”的搜索路径。于是,我们可以利用这个搜索路径来指定编译器对头文件的搜索路径参数 CFLAGS ,如:
override CFLAGS += $(patsubst %,-I%,$(subst :, ,$(VPATH)))
- 如果我们的
$(VPATH)
值是src:../headers
,那么$(patsubst %,-I%,$(subst :, ,$(VPATH)))
将返回-Isrc -I../headers
,这正是 cc 或 gcc 搜索头文件路径的参数。
5.4 文件名操作函数
5.4.1 dir
$(dir <names...>)
-
名称:取目录函数——dir。
-
功能:从文件名序列
<names>
中取出目录部分。目录部分是指最后一个反斜杠(/
)之前的部分。
如果没有反斜杠,那么返回./
。 -
返回:返回文件名序列
<names>
的目录部分。 -
示例:
$(dir src/foo.c hacks) # 返回值是 src/ ./
5.4.2 notdir
$(dir <names...>)
-
名称:取目录函数——notdir。
-
功能:从文件名序列
<names>
中取出目录部分。目录部分是指最后一个反斜杠(/
)之后的部分。 -
返回:返回文件名序列
<names>
的非目录部分。 -
示例:
$(dir src/foo.c hacks) # 返回值是 foo.c hacks
5.4.3 suffix
$(suffix <names...>)
-
名称:取後缀函数——suffix。
-
功能:从文件名序列 <
names>
中取出各个文件名的后缀。 -
返回:返回文件名序列
<names>
的后缀序列,如果文件没有后缀,则返回空字串。 -
示例:
$(suffix src/foo.c src-1.0/bar.c hacks) 返回值: .c .c
5.4.4 basename
$(basename <names...>)
-
名称:取前缀函数——basename。
-
功能:从文件名序列
<names>
中取出各个文件名的前缀部分。 -
返回:返回文件名序列
<names>
的前缀序列,如果文件没有前缀,则返回空字串。 -
示例:
$(basename src/foo.c src-1.0/bar.c hacks) #返回值:src/foo src-1.0/bar hacks
5.4.5 addsuffix
$(addsuffix <suffix>,<names...>)
-
名称:加后缀函数——addsuffix。
-
功能:把后缀
<suffix>
加到<names>
中的每个单词后面。 -
返回:返回加过后缀的文件名序列。
-
示例:
$(addsuffix .c,foo bar) #返回值:foo.c bar.c
5.4.6 addprefix
$(addprefix <prefix>,<names...>)
-
名称:加前缀函数——addprefix。
-
功能:把前缀
<prefix>
加到<names>
中的每个单词后面。 -
返回:返回加过前缀的文件名序列。
-
示例:
```c $(addprefix src/,foo bar) #返回值:src/foo src/bar ```
5.4.7 join
$(join <list1>,<list2>)
- 名称:连接函数——join。
- 功能:把
<list2>
中的单词对应地加到<list1>
的单词后面。如果<list1>
的单词个数要比<list2>
的多,那么,<list1>
中的多出来的单词将保持原样。如果<list2>
的单词个数要比<list1>
多,那么,<list2>
多出来的单词将被复制到<list1>
中。 - 返回:返回连接过后的字符串。
- 示例:
$(join aaa bbb , 111 222 333)
#返回值: aaa111 bbb222 333
5.5 foreach函数
- foreach 函数:循环(写法有点类似于Java中的循环写法)
- 语法是:
$(foreach <var>,<list>,<text>)
-
这个函数的意思是,把参数
<list>
中的单词逐一取出放到参数<var>
所指定的变量中,然后再执
行<text>
所包含的表达式。每一次<text>
会返回一个字符串,循环过程中,<text>
的所返回的每个字符串会以空格分隔,最后当整个循环结束时,<text>
所返回的每个字符串所组成的整个字符串(以空格分隔)。 -
示例如下:
names := a b c d files := $(foreach n,$(names),$(n).o)
-
示例中,
$(name)
中的单词会被挨个取出,并存到变量n
中,$(n).o
每次根据$(n)
计算出一个值,这些值以空格分隔,最后作为 foreach 函数的返回,所以,$(files)
的值是a.o b.o c.o d.o
。
注意,foreach 中的 <var>
参数是一个临时的局部变量,foreach 函数执行完后,参数 <var>
的变量将不在作用,其作用域只在 foreach 函数当中。
5.6 call函数
- call :可以用来创建新的参数化的函数。
- 其语法是:
$(call <function>,<parm1>,<parm2>,...,<parmn>)
-
在makefile文件中执行这个函数时,
<function>
参数中的变量,如$(1)
、$(2)
等,会被参数<parm1>
、<parm2>
、<parm3>
依次取代。而<function>
的返回值就是 call 函数的返回值。例如:reverse = $(1) $(2) foo = $(call reverse,a,b) # foo 的值: a b
-
参数的次序是可以自定义的,不一定是顺序的,如:
reverse = $(2) $(1) foo = $(call reverse,a,b) # foo 的值: b a
注意:在向 call 函数传递参数时要尤其注意空格的使用。call 函数在处理参数时,第 2 个及其之后的参数中的空格会被保留,因而可能造成一些奇怪的效果。因而在向 call 函数提供参数时,最好去除所有多余的空格。
5.7 origin函数
- origin :不操作变量的值,但返回这个变量的来源。
- 语法如下:
$(origin <variable>)
注意:<variable>
是变量的名字,不是引用。所以最好不要在 <variable>
中使用 $
字符。
- origin 函数的返回值如下:
返回值关键字 | 来源 |
---|---|
undefined | 从未定义过,初次使用 |
default | 默认定义,比如“CC”变量 |
environment | 环境变量 |
file | 定义在 Makefile 中 |
command line | 被命令行定义 |
override | 被override指示符重新定义 |
automatic | 一个命令运行中的自动化变量 |
-
这些信息对编写 Makefile 非常有用,例如,假设有一个 Makefile 其包了一个定义文件 Make.def,在 Make.def 中定义了一个变量“
bletch
”,而我们的环境中也有一个环境变量“bletch
”,此时,我们要判断一下变量来源,如果变量来源于环境,那么就重定义了,如果来源于 Make.def 或是命令行等非环境的,那么保持原样。示例如下:ifdef bletch ifeq "$(origin bletch)" "environment" bletch = barf, gag, etc. endif endif
5.8 shell函数
- shell :作用和反引号
“‘”
一样,用于执行操作系统shell指令 - 返回:执行操作系统命令后的输出即为返回。如:
contents := $(shell cat foo)
files := $(shell echo *.c)
注意:这个函数会新生成一个 Shell 程序来执行命令,所以要注意其运行性能,如果 Makefile中有一些比较复杂的规则,并大量使用了这个函数,那么对系统性能是有影响的。而且 Makefile的隐晦的规则可能会让 shell 函数执行的次数远超预期。
- 参考借鉴: