目录
[一、origin 函数](#一、origin 函数)
["command line"](#“command line”)
[二、shell 函数](#二、shell 函数)
[三、控制 make 的函数](#三、控制 make 的函数)
一、origin 函数
origin 函数不像其它的函数,他并不操作变量的值,他只是告诉你你的这个变量是哪 里来的?其语法是:
$(origin <variable>)
注意,是变量的名字,不应该是引用。所以你最好不要在中使用 "$"字符。Origin 函数会以其返回值来告诉你这个变量的"出生情况",下面,是 origin 函数的返回值:
"undefined"
如果从来没有定义过,origin 函数返回这个值"undefined"。
"default"
如果是一个默认的定义,比如"CC"这个变量,这种变量我们将在后面 讲述。environment" 如果是一个环境变量,并且当 Makefile 被执行时,"-e" 参数没有被打开。
"file"
如果这个变量被定义在 Makefile 中。
"command line"
如果这个变量是被命令行定义的。
"override"
如果是被 override 指示符重新定义的。
"automatic"
如果是一个命令运行中的自动化变量。关于自动化变量将在后面讲述。
这些信息对于我们编写 Makefile 是非常有用的,例如,假设我们有一个 Makefile 其包 了一个定义文件 Make.def,在 Make.def 中定义了一个变量"bletch",而我们的环境中也 有一个环境变量"bletch",此时,我们想判断一下,如果变量来源于环境,那么我们就把 之重定义了,如果来源于 Make.def 或是命令行等非环境的,那么我们就不重新定义它。于 是,在我们的 Makefile 中,我们可以这样写:
ifdef bletch
ifeq "$(origin bletch)" "environment"
bletch = barf, gag, etc.
endif
endif
当然,你也许会说,使用 override 关键字不就可以重新定义环境中的变量了吗?为什 么需要使用这样的步骤?是的,我们用 override 是可以达到这样的效果,可是 override过于粗暴,它同时会把从命令行定义的变量也覆盖了,而我们只想重新定义环境传来的,而 不想重新定义命令行传来的。
二、shell 函数
shell 函数也不像其它的函数。顾名思义,它的参数应该就是操作系统 Shell 的命令。 它和反引号"`"是相同的功能。这就是说,shell 函数把执行操作系统命令后的输出作为 函数返回。于是,我们可以用操作系统命令以及字符串处理命令 awk,sed 等等命令来生成 一个变量,如:
contents := $(shell cat foo)
files := $(shell echo *.c)
注意,这个函数会新生成一个 Shell 程序来执行命令,所以你要注意其运行性能,如果你的 Makefile 中有一些比较复杂的规则,并大量使用了这个函数,那么对于你的系统性能是有 害的。特别是 Makefile 的隐晦的规则可能会让你的 shell 函数执行的次数比你想像的多得 多。
三、控制 make 的函数
make 提供了一些函数来控制 make 的运行。通常,你需要检测一些运行 Makefile 时的 运行时信息,并且根据这些信息来决定,你是让 make 继续执行,还是停止。
1、error
$(error <text...>)
产生一个致命的错误,是错误信息。注意,error 函数不会在一被使用就会 产生错误信息,所以如果你把其定义在某个变量中,并在后续的脚本中使用这个变量,那么 也是可以的。例如:
示例一:
ifdef ERROR_001
$(error error is $(ERROR_001))
endif
示例二:
ERR = $(error found an error!)
.PHONY: err
err: ; $(ERR)
示例一会在变量 ERROR_001 定义了后执行时产生 error 调用,而示例二则在目录 err 被执行时才发生 error 调用。
2、warning
$(warning <text ...>)
这个函数很像 error 函数,只是它并不会让 make 退出,只是输出一段警告信息,而 ma ke 继续执行。