第九部分 使用函数 （五）

目录

一、origin 函数

“undefined”

“default”

“file”

“command line”

“override”

“automatic”

二、shell 函数

三、控制 make 的函数

1、error

2、warning

---

一、origin 函数

        origin 函数不像其它的函数，他并不操作变量的值，他只是告诉你你的这个变量是哪 里来的？其语法是：

$(origin )

        注意，是变量的名字，不应该是引用。所以你最好不要在中使用 “$”字符。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 )

        产生一个致命的错误，是错误信息。注意，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 )

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