Makefile中的常用函数 - foreach、if、call、shell、value、eval

foreach循环函数

foreach是Makefile中用来做循环的函数，它把可以重复利用一段脚本，但是每次又有不同的条件。它类似于Unix标准Shell（/bin/sh）中的for语句，或是C-Shell（/bin/csh）中的foreach语句。它的语法是：

       $(foreach  var, list, text)

       前两个参数var和list，参数中的单词逐一取出放到参数所指定的变量中，然后再执行所包含的表达式。每一次会返回一个字符串，循环过程中，的所返回的每个字符串会以空格分隔，最后当整个循环结束时，所返回的每个字符串所组成的整个字符串（以空格分隔）将会是foreach函数的返回值。

所以，最好是一个变量名，可以是一个表达式，而中一般会使用这个参数来依次枚举中的单词。

       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中的参数是一个临时的局部变量，foreach函数执行完后，参数的变量将不在作用，其作用域只在foreach函数当中。

if 函数

if函数很像GNU的make所支持的条件语句——ifeq（参见前面所述的章节），if函数的语法是：

       $(if ,)

 或是

       $(if ,,)

可见，if函数可以包含“else”部分，或是不含。即if函数的参数可以是两个，也可以是三个。参数是if的表达式，如果其返回的为非空字符串，那么这个表达式就相当于返回真，于是，会被计算，否则会被计算。

而if函数的返回值是，如果为真（非空字符串），那个会是整个函数的返回值，如果为假（空字符串），那么会是整个函数的返回值，此时如果没有被定义，那么，整个函数返回空字串。

所以，和只会有一个被计算。

 
      补充一个ifeq的用法:
Makefile中的ifeq定义前面不能被tab制表符修饰，只能被空格。这与Makefile函数正好是相反的。
当出现语法错误时，务必检查是否在ifeq前面有tab制表符    

/bin/sh: -c: line 0: syntax error near unexpected token `nightly,nightly'

/bin/sh: -c: line 0: `ifeq (nightly,nightly)'

ifeq ($(1), arg1)
    # text do something
endif

call函数

call函数是唯一一个可以用来创建新的参数化的函数。你可以写一个非常复杂的表达式，这个表达式中，你可以定义许多参数，然后你可以用call函数来向这个表达式传递参数。其语法是：

      $(call ,,,...)

 当make执行这个函数时，参数中的变量，如$(1)，$(2)，$(3)等，会被参数，，依次取代。而的返回值就是call函数的返回值。例如：
       reverse = $(1) $(2)

       foo = $(call reverse, a, b)

那么，foo的值就是“a b”。当然，参数的次序是可以自定义的，不一定是顺序的，如：

       reverse = $(2) $(1)

       foo = $(call reverse,a,b)

此时的foo的值就是“b a”。

shell函数

shell函数也不像其它的函数。顾名思义，它的参数应该就是操作系统Shell的命令。它和反引号“`”是相同的功能。这就是说，shell函数把执行操作系统命令后的输出作为函数返回。于是，我们可以用操作系统命令以及字符串处理命令awk，sed等等命令来生成一个变量，如：

      contents := $(shell cat foo)

      files := $(shell echo *.c)

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

value函数

       value函数提供了一种使用变量非展开值的方式，但是它也并不能对于已经在定义中展开的结果生效。比如，你使用$()定义了一个变量，那么就可以用value来使用变量的非展开值。value的语法是：

       $(value  var)

       注意，这里的var参数是变量名，而不是对变量的引用$(var)

       例子：

       FO=$(PATH)

       all:

              echo 1$(FO)

              echo 2 $(value FO)

       输出是1 /bin:/usr/bin:/usr/local/sbin:/usr/sbin:/sbin:   （系统PATH的展开）

2 $(PATH)，FOO的定义。

       Value函数经常与eval函数一起结合使用。

eval函数

       eval函数可以通过其他变量或函数的结果来定义新的makefile结构。Eval的参数被按照makefile的语法格式展开。展开的结果可以用来构造新的变量、目标、隐式或者显式规则。

       eval的参数被展开两次，第一次被eval本身，第二次是第一次展开的结果被解析为makefile语法时。因此在使用eval时需要提供额外的$引用字符。这时候也可以使用value来避免不希望的展开。

       下面是一个用eval来创建目标的例子，尽管看起来有些复杂，但是在写好它之后，就可以把generic的部分提供到一个公共文件中，再在你的个人makefile中include它，这样子你的个人makefile就会特别简练了。

1. PROGRAMS = server client
2. server_OBJS = server.o server_priv.o server_access.o
3. server_LIBS = priv protocol
4. client_OBJS = client.o client_api.o client_mem.o
5. client_LIBS = protocol
6. 
   
7. # Everything after this is generic，可以拿到其他文件用来include
8. .PHONY: all
9. all: $(PROGRAMS)
10. 
    
11. define PROGRAM_template =
12. $(1): $$($(1)_OBJS) $$($(1)_LIBS:%=-l%)
13. ALL_OBJS += $$($(1)_OBJS)
14. endef
15. 
    
16. $(foreach prog,$(PROGRAMS),$(eval $(call PROGRAM_template,$(prog))))
17. $(PROGRAMS):
18. $(LINK.o) $^ $(LDLIBS) -o $@
19. clean:
20. rm -f $(ALL_OBJS) $(PROGRAMS)

     更多的eval函数实用例子可见 OpenWRT的package编译文件，里面大量的使用了eval模板来构建target