|
define(Name,NewName) |
用值 NewName 替换宏 Name。NewName 字符串可以用 $n . . . （其中 n 是一个数字）。在这种情况下，替代文字中每个出现 n 的地方用 Name 中的第 n 个参数替代。$0 是宏名。空字符串替换空缺的参数。参数的数目替代 $#。逗号分隔的所有参数的列表替换 $*。$@ 和 $* 相似，但是每个参数是用当前引号字符括起来的（请参阅 changequote）。 |
|
undefine(Name) |
删除 Name 的定义。 |
|
defn(Name . . . ) |
返回括起来的 Name 定义。 |
|
pushdef(Name, NewName) |
如同在 define 中那样，使用 NewName 重新定义 Name，但是保存任何以前的定义。 |
|
popdef(Name . . . ) |
删除 Name 的当前定义并返回到以前的定义（如果存在）。 |
|
ifdef(Name,True,[False]) |
仅在 Name 被定义且不为 0 时返回 True，否则返回 False。如果不支持 False，那么它的值为空。 |
|
shift(Argument . . . ) |
返回除第一个参数之外的所有参数。其它参数加引号并以逗号隔开推回。加引号使随后进行的额外扫描失效。 |
|
changequote(L,R) |
更改引号为符号 L 和 R。符号可以是 5 个字节长。不带参数的 changequote 恢复原始值（` '）。 |
|
changecom(L,R) |
将缺省的左注释标记（#）和右注释标记（换行符）更改为 L 和 R。假如不带参数，禁用注释机制。带一个参数，左注释标记变成这个参数而右注释变成换行符。带两个参数，两个标记都有效。注释标记可以是 5 个字节长。 |
|
divert(Number) |
将当前输出流更改到流 Number。有 10 个输出流，号码为 0－9。最终的输出是按字母顺序连接的的流。初始时，流 0 是当前流。m4 命令废弃转向到一个不同于 0－9 的流的输出。 |
|
undivert(Number . . . ) |
从指定的转移（或者如果没有参数时则为所有转移）的直接文本输出。文本可能取消转向到另一个转移。取消转向废弃已转向的文本。 |
|
divnum |
返回当前输出流的值。 |
|
dnl |
读取并废弃在下一个换行符前（包括下一个换行符）的字符。 |
|
ifelse([String1,String2,True,[False]] . . . ) |
如果 String1 和 String2 相同，那么该值为 True。如果不同或者有多于四个的参数，那么 m4 命令重复处理附加参数（4、5、6 和 7）。否则，值为 False 或空（如果没有 False 值）。 |
|
incr(Number) |
返回的是加 1 的参数值。 |
|
decr(Number) |
返回的是减 1 的参数值。 |
|
eval(Expression[,Number1[,Number2]]) |
使用 32 位运算求其作为算术表达式的第一个参数的值。可以使用运算符 +、-、*、/、%、 ^ (乘方)、一位宽度 &、|、 ~ 和 ^ 关系运算符和圆括号。可以在 C 中指定八进制和十六进制数。Number1 指定表达式结果的基。缺省基是 10。可以选择 Number2 来指定结果中的最小数字。 |
|
len(String) |
以 String 返回字节数。 |
|
dlen(String) |
以 String 返回可显示的字符数，即 2 字节的扩展字符被计为一个可显示字符。 |
|
index(String1,String2) |
返回字符串 String1 中字符串 String2 的开始位置（原点为 0），如果第二个参数没有出现则为 -1。 |
|
substr(String,Position, [Number] ) |
返回 String 的一个子串。用 Position 选定子串的开始，并且 Number 表示子串的长度。如果没有 Number 参数，那么子串包含至第一个字符串的结尾的所有字符。 |
|
translit(String,From,To) |
将 String 中的字符从 From 给出的集直译为 To 给出的集。不允许缩写。2 字节的扩展字符正确地映射到对应的替换字符中。 |
|
include(File) |
返回 File 的内容或者显示错误信息（如果它不能访问此文件）。 |
|
sinclude(File) |
返回 File 的内容，但是如果 File 是不可访问的，则不显示错误信息。 |
|
syscmd(Command) |
运行 Command。不返回值。 |
|
sysval |
返回最后调用 syscmd 中的返回码。 |
|
maketemp( . . . nnnn . . . ) |
用当前进程 ID 号替换参数中的 nnnn。 |
|
m4exit(Value) |
快速退出 m4，返回指定的退出 Value（缺省为 0）。 |
|
m4wrap(LastMacro) |
读取文件结束符后运行 LastMacro。例如，m4wrap (`cleanup ()') 在 m4 结束时运行清除宏。 |
|
errprint(Message) |
包含诊断输出文件中的 Message。 |
|
dumpdef([Name . . . ]) |
将指定的项或所有项（如果没有提供参数）的当前名称和定义写到标准输出中。 |
|
traceon(Macro) |
打开 Macro 跟踪。如果没有指定，则对所有宏开启跟踪。 |
|
traceoff(Macro . . . ) |
关闭全局跟踪和任何指定 Macro 的跟踪。用 traceon 特定跟踪的宏只可由 traceoff 的特定调用来取消跟踪。 |