【转】makefile 函数

来源：http://blog.sina.com.cn/s/blog_7e4015380100wl48.html

原文地址：makefile--函数 作者：IcDesigneEr

makefile学习精要

[zz from]http://www.chinaunix.net/jh/23/408225.html

---

调用语法

 

comma:= , 
empty:= 
space:= $(empty) $(empty) 
foo:= a b c 
bar:= $(subst $(space),$(comma),$(foo))

---

字符串处理函数

 

字符串替换函数——subst

$(subst <from>;,<to>;,<text>;)  
[例] $(subst ee,EE,feet on the street)

返回fEEt on the strEEt。

 

模式字符串替换函数——patsubst

$(patsubst <pattern>;,<replacement>;,<text>;) 

[例] $(patsubst %.c,%.o,x.c.c bar.c) 
把字串“x.c.c bar.c”符合模式[%.c]的单词替换成[%.o]，返回结果是“x.c.o bar.o”。

 

去空格函数——strip

$(strip <string>;)

[例] $(strip a b c ) 
把字串“a b c ”去到开头和结尾的空格，结果是“a b c”。

查找字符串函数——findstring

$(findstring <find>;,<in>;)

[例] $(findstring a,a b c) 
     $(findstring a,b c) 
第一个函数返回“a”字符串，第二个返回“”字符串（空字符串）

 

过滤函数——filter (以及反过滤函数filter-out)

$(filter <pattern...>;,<text>;)

[例] sources := foo.c bar.c baz.s ugh.h 
     foo: $(sources) 
         cc $(filter %.c %.s,$(sources)) -o foo 
$(filter %.c %.s,$(sources))返回的值是“foo.c bar.c baz.s”。

排序函数——sort

$(sort <list>;)

[例] $(sort foo bar lose)

返回“bar foo lose”

 

取单词函数——word

$(word <n>;,<text>;)

[例] $(word 2, foo bar baz)

返回值是“bar” 

 

取单词串函数——wordlist

$(wordlist <s>;,<e>;,<text>;) 

[例] $(wordlist 2, 3, foo bar baz)

返回值是“bar baz”。

 

单词个数统计函数——words

$(words <text>;)

[例] $(words, foo bar baz)

返回值是“3”。

 

首单词函数——firstword

$(firstword <text>;)

[例] $(firstword foo bar)

返回值是“foo”。

---

文件名函数

 

取目录函数——dir

$(dir <names...>;) 

[例] $(dir src/foo.c hacks)

返回值是“src/ ./”。

 

取文件函数——notdir

$(notdir <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.c 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>;)

[例] $(join aaa bbb,111 222 333)

返回值是“aaa111 bbb222 333”。

---

循环函数——foreach

 

$(foreach <var>;,<list>;,<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函数当中。

---

参数化函数——call

 

$(call <expression>;,<parm1>;,<parm2>;,<parm3>;...)

[例] reverse =  $(2) $(1) 

     foo = $(call reverse,a,b)
此时的foo的值就是“b a”。

---

变量探测函数——origin

 

$(origin <variable>;)

 

下面，是origin函数的返回值: 

“undefined” 
如果<variable>;从来没有定义过，origin函数返回这个值“undefined”。 
“default” 
如果<variable>;是一个默认的定义，比如“CC”这个变量，这种变量我们将在后面讲述。 
“environment” 
如果<variable>;是一个环境变量，并且当Makefile被执行时，“-e”参数没有被打开。 
“file” 
如果<variable>;这个变量被定义在Makefile中。 
“command line” 
如果<variable>;这个变量是被命令行定义的。 
“override” 
如果<variable>;是被override指示符重新定义的。 
“automatic” 
如果<variable>;是一个命令运行中的自动化变量。关于自动化变量将在后面讲述。
[例] ifdef bletch 
     ifeq "$(origin bletch)" "environment" 
     bletch = barf, gag, etc. 
     endif 

     endif

---

Shell函数

 

shell函数也不像其它的函数。顾名思义，它的参数应该就是操作系统Shell的命令

 

contents := $(shell cat foo) 
files := $(shell echo *.c) 

注意，这个函数会新生成一个Shell程序来执行命令，所以你要注意其运行性能，如果你的Makefile中有一些复杂的规则，并大量使用了这个函数，那么对于你的系统性能是有害的。特别是隐晦的规则可能会让你的shell函数执行的次数比你想像的多得多。

---

make控制函数

 

make提供了一些函数来控制make的运行。通常，你需要检测一些运行Makefile时的运行时信息，并且根据这些信息来决定，你是让make继续执行，还是停止。

 

$(error <text ...>;)

 

产生一个致命的错误，<text ...>;是错误信息。注意，error函数不会在一被使用就会产生错误信息，所以如果你把其定义在某个变量中，并在后续的脚本中使用这个变量，那么也是可以的。例如：

 

 [例] ifdef ERROR_001 

      $(error error is $(ERROR_001)) 

      endif

$(warning <text ...>;)

 

这个函数很像error函数，只是它并不会让make退出，只是输出一段警告信息，而make继续执行。