ii GNU M4 1.4.18 macro processor
6 Conditionals, loops, and recursion . . . . . . . . . . . . 39
6.1 Testing if a macro is defined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
6.2 If-else construct, or multibranch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
6.3 Recursion in m4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
6.4 Iteration by counting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
6.5 Iteration by list contents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
6.6 Working with definition stacks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
6.7 Building macros with macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
7 How to debug macros and input . . . . . . . . . . . . . . 55
7.1 Displaying macro definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
7.2 Tracing macro calls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
7.3 Controlling debugging output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
7.4 Saving debugging output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
8 Input control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
8.1 Deleting whitespace in input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
8.2 Changing the quote characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
8.3 Changing the comment delimiters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
8.4 Changing the lexical structure of words . . . . . . . . . . . . . . . . . . . . . . . . 67
8.5 Saving text until end of input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
9 File inclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
9.1 Including named files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
9.2 Searching for include files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
10 Diverting and undiverting output . . . . . . . . . . . 75
10.1 Diverting output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
10.2 Undiverting output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
10.3 Diversion numbers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
10.4 Discarding diverted text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
11 Macros for text handling . . . . . . . . . . . . . . . . . . . . . 81
11.1 Calculating length of strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
11.2 Searching for substrings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
11.3 Searching for regular expressions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
11.4 Extracting substrings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
11.5 Translating characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
11.6 Substituting text by regular expression . . . . . . . . . . . . . . . . . . . . . . . 84
11.7 Formatting strings (printf-like) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
12 Macros for doing arithmetic . . . . . . . . . . . . . . . . . 89
12.1 Decrement and increment operators. . . . . . . . . . . . . . . . . . . . . . . . . . . 89
12.2 Evaluating integer expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
