cast 0.0.1 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +10 -0
  3. data/CHANGELOG +63 -0
  4. data/Gemfile +9 -0
  5. data/LICENSE +22 -0
  6. data/README.markdown +1924 -0
  7. data/Rakefile +29 -0
  8. data/cast.gemspec +18 -0
  9. data/ext/cast.c +6 -0
  10. data/ext/cast.h +141 -0
  11. data/ext/extconf.rb +2 -0
  12. data/ext/parser.c +287 -0
  13. data/ext/yylex.re +340 -0
  14. data/lib/cast.rb +11 -9
  15. data/lib/cast/c.y +904 -0
  16. data/lib/{c_nodes.rb → cast/c_nodes.rb} +188 -392
  17. data/lib/{to_debug.rb → cast/inspect.rb} +18 -20
  18. data/lib/cast/node.rb +741 -0
  19. data/lib/{node_list.rb → cast/node_list.rb} +175 -176
  20. data/lib/{parse.rb → cast/parse.rb} +86 -65
  21. data/lib/cast/preprocessor.rb +59 -0
  22. data/lib/cast/tempfile.rb +33 -0
  23. data/lib/{to_s.rb → cast/to_s.rb} +133 -80
  24. data/lib/cast/version.rb +11 -0
  25. data/test/c_nodes_test.rb +224 -0
  26. data/test/lexer_test.rb +335 -0
  27. data/test/{test_node_list.rb → node_list_test.rb} +401 -413
  28. data/test/{test_node.rb → node_test.rb} +186 -214
  29. data/test/parse_test.rb +2068 -0
  30. data/test/{test_parser.rb → parser_test.rb} +145 -58
  31. data/test/preprocessor_test.rb +85 -0
  32. data/test/render_test.rb +2116 -0
  33. data/test/test_helper.rb +198 -0
  34. metadata +83 -52
  35. data/README +0 -6
  36. data/doc/index.html +0 -2513
  37. data/install.rb +0 -14
  38. data/lib/c.tab.rb +0 -3433
  39. data/lib/c.y +0 -935
  40. data/lib/node.rb +0 -744
  41. data/test/common.rb +0 -174
  42. data/test/run.rb +0 -5
  43. data/test/test_c_nodes.rb +0 -160
  44. data/test/test_parse.rb +0 -2014
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA256:
3
+ metadata.gz: 8d28ed8c2a4e614f19a15b7a11f03248e113460a1696aee87f297f13b5f2accd
4
+ data.tar.gz: 05f1e875efc4c582d266716c75947d678763acae895550d97840dd60f8d4f4d3
5
+ SHA512:
6
+ metadata.gz: 153f75a811886c45e1babfb2ba5b3f797bbe3abb7d8b9cfedd328ea6a0027d7790d8ed586c9a8875acfb926d3dec9005c0d3db4b737dd79047085e848eb3072d
7
+ data.tar.gz: 3c6c578a7b8fb2dda38b5428b82eaadd2fc399747047b5100153e560cd3c4da41b8baad145cd0ecc65ddbf30ce6c8516339fd1e98b0fa14526b66deac06e93f4
data/.gitignore ADDED
@@ -0,0 +1,10 @@
1
+ /*.gem
2
+ /Gemfile.lock
3
+ /ext/Makefile
4
+ /ext/*.bundle
5
+ /ext/*.o
6
+ /ext/*.so
7
+ /ext/yylex.c
8
+ /lib/cast/cast.so
9
+ /lib/cast/c.tab.rb
10
+ /lib/cast/cast.bundle
data/CHANGELOG ADDED
@@ -0,0 +1,63 @@
1
+ == 0.3.1 2020-07-15
2
+
3
+ * Support struct/union member declarations with no declarators. [Brice Videau]
4
+
5
+ == 0.3.0 2016-03-21
6
+
7
+ * Fix popping & shifting from an empty NodeList.
8
+ * Add FloatLiteral#exponent and require exponent for hex floats.
9
+
10
+ == 0.2.1 2012-12-19
11
+
12
+ * Parse adjacent string literals correctly.
13
+
14
+ == 0.2.0 2012-05-14
15
+
16
+ * Works with Ruby 1.8.6, 1.8.7, 1.9.2, 1.9.3.
17
+ * MIT License.
18
+ * Friendlier changelog.
19
+ * Added C::Preprocessor, which wraps Config::CONFIG['CPP']. Assumes
20
+ POSIX-style -D and -I options.
21
+ * IntLiteral suffixes are parsed correctly for things like 2e-2.
22
+ * Newlines are allowed in StringLiterals and CharLiterals.
23
+ * Added StringLiteral and CharLiteral #prefix. #wide? and #wide are
24
+ now methods, not fields.
25
+ * IntLiteral and FloatLiteral #format is now the first field.
26
+ * More meaningful parse error messages.
27
+ * Printing (#to_s):
28
+ * FunctionDef#no_prototype? is now honored.
29
+ * ':' is now printed for labels.
30
+ * Consecutive unary operators no longer conflict with other
31
+ operators (e.g. "+ +" instead of "++").
32
+ * Sizeof is printed with parentheses (not mandated by C99, but
33
+ conventional).
34
+ * Signedness qualifier is always printed for char.
35
+ * Longness is printed correctly for Bool, Complex, Imaginary.
36
+ * Nested Conditionals are handled correctly.
37
+ * MemberInit#member is printed correctly.
38
+ * Parsing (#parse):
39
+ * Member now works.
40
+ * Expression now supports CompoundLiterals without types (as
41
+ allowed in declarators only).
42
+ * Declarator allows specification of #num_bits.
43
+
44
+ == 0.1.0 2006-04-25
45
+
46
+ * Faster lexer (written in C).
47
+ * Renamed Node#to_debug to Node#inspect.
48
+ * Allow type names in Call#args. (Not C99, but useful for macros.)
49
+ * Added node fields:
50
+ * StringLiteral#wide?
51
+ * CharLiteral#wide?
52
+ * IntLiteral#suffix
53
+ * FloatLiteral#format
54
+ * FloatLiteral#suffix
55
+ * Fixed CompoundLiteral#to_s.
56
+ * Fixed AssignmentExpression#to_s when #lval is a Comma.
57
+ * Fixed Parameter#to_s when #type is nil.
58
+ * Cleaned up load path.
59
+ * Install with rake task.
60
+
61
+ == 0.0.1 2005-02-21
62
+
63
+ * Hi.
data/Gemfile ADDED
@@ -0,0 +1,9 @@
1
+ source 'https://rubygems.org/'
2
+
3
+ gem 'minitest'
4
+ gem 'minitest-focus'
5
+ gem 'pry'
6
+ gem 'racc'
7
+ gem 'ritual'
8
+
9
+ gemspec
data/LICENSE ADDED
@@ -0,0 +1,22 @@
1
+ The MIT License
2
+
3
+ Copyright (c) George Ogata
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining
6
+ a copy of this software and associated documentation files (the
7
+ "Software"), to deal in the Software without restriction, including
8
+ without limitation the rights to use, copy, modify, merge, publish,
9
+ distribute, sublicense, and/or sell copies of the Software, and to
10
+ permit persons to whom the Software is furnished to do so, subject to
11
+ the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be
14
+ included in all copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
19
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
20
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
21
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
22
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
data/README.markdown ADDED
@@ -0,0 +1,1924 @@
1
+ # CAST
2
+
3
+ C parser and abstract syntax tree for Ruby.
4
+
5
+ ## Example
6
+
7
+ require 'cast'
8
+
9
+ source = File.read('file.c')
10
+ ast = C.parse(source)
11
+ ast.entities.each do |declaration|
12
+ declaration.declarator.each do |declarator|
13
+ puts "#{declarator.name}: declarator.type"
14
+ end
15
+ end
16
+
17
+ Or in irb:
18
+
19
+ irb> ast = C.parse('int main(void) { return 0; }')
20
+ => TranslationUnit
21
+ entities:
22
+ - FunctionDef
23
+ type: Function
24
+ type: Int
25
+ params: []
26
+ name: "main"
27
+ def: Block
28
+ stmts:
29
+ - Return
30
+ expr: IntLiteral
31
+ val: 0
32
+
33
+ irb> puts ast
34
+ int main(void) {
35
+ return 0;
36
+ }
37
+ => nil
38
+
39
+ ## Nodes
40
+
41
+ `C.parse` returns a tree of `Node` objects. Here's the class hierarchy:
42
+
43
+ * **Node**
44
+ * TranslationUnit
45
+ * Comment
46
+ * Declaration
47
+ * Declarator
48
+ * FunctionDef
49
+ * Parameter
50
+ * Enumerator
51
+ * MemberInit
52
+ * Member
53
+ * **Statement**
54
+ * Block
55
+ * If
56
+ * Switch
57
+ * While
58
+ * For
59
+ * Goto
60
+ * Continue
61
+ * Break
62
+ * Return
63
+ * ExpressionStatement
64
+ * **Label**
65
+ * PlainLabel
66
+ * Default
67
+ * Case
68
+ * **Type**
69
+ * **IndirectType**
70
+ * Pointer
71
+ * Array
72
+ * Function
73
+ * **DirectType**
74
+ * Struct
75
+ * Union
76
+ * Enum
77
+ * CustomType
78
+ * **PrimitiveType**
79
+ * Void
80
+ * Int
81
+ * Float
82
+ * Char
83
+ * Bool
84
+ * Complex
85
+ * Imaginary
86
+ * **Expression**
87
+ * Comma
88
+ * Conditional
89
+ * Variable
90
+ * **UnaryExpression**
91
+ * **PostfixExpression**
92
+ * Index
93
+ * Call
94
+ * Dot
95
+ * Arrow
96
+ * PostInc
97
+ * PostDec
98
+ * **PrefixExpression**
99
+ * Cast
100
+ * Address
101
+ * Dereference
102
+ * Sizeof
103
+ * Plus
104
+ * Minus
105
+ * PreInc
106
+ * PreDec
107
+ * BitNot
108
+ * Not
109
+ * **BinaryExpression**
110
+ * Add
111
+ * Subtract
112
+ * Multiply
113
+ * Divide
114
+ * Mod
115
+ * Equal
116
+ * NotEqual
117
+ * Less
118
+ * More
119
+ * LessOrEqual
120
+ * MoreOrEqual
121
+ * BitAnd
122
+ * BitOr
123
+ * BitXor
124
+ * ShiftLeft
125
+ * ShiftRight
126
+ * And
127
+ * Or
128
+ * **AssignmentExpression**
129
+ * Assign
130
+ * MultiplyAssign
131
+ * DivideAssign
132
+ * ModAssign
133
+ * AddAssign
134
+ * SubtractAssign
135
+ * ShiftLeftAssign
136
+ * ShiftRightAssign
137
+ * BitAndAssign
138
+ * BitXorAssign
139
+ * BitOrAssign
140
+ * **Literal**
141
+ * StringLiteral
142
+ * CharLiteral
143
+ * CompoundLiteral
144
+ * IntLiteral
145
+ * FloatLiteral
146
+ * **NodeList**
147
+ * NodeArray
148
+ * NodeChain
149
+
150
+ The **bold** ones are abstract.
151
+
152
+ The last 2 (`NodeList`s) represent lists of `Node`s. They quack like
153
+ standard ruby `Arrays`. `NodeChain` is a doubly linked list;
154
+ `NodeArray` is an array.
155
+
156
+ ### Node Methods
157
+
158
+ * `parent`: return the parent in the tree (a `Node` or nil).
159
+ * `pos`, `pos=`: the position in the source file (a `Node::Pos`).
160
+ * `to_s`: return the code for the tree (a `String`).
161
+ * `inspect`: return a pretty string for inspection, makes irb fun.
162
+ * `match?(str)`, `=~(str)`: return true iff str parses as a `Node`
163
+ equal to this one.
164
+ * `detach`: remove this node from the tree (parent becomes nil) and
165
+ return it.
166
+ * `detached?`, `attached?`: return true if parent is nil or non-nil
167
+ respectively.
168
+ * `replace_with(node)`: replace this node with node in the tree.
169
+ * `swap_with(node)`: exchange this node with node in their trees.
170
+ * `insert_prev(*nodes)`, `insert_next(*nodes)`: insert nodes before
171
+ this node in the parent list. Parent must be a `NodeList`! Useful
172
+ for adding statements before a node in a block, for example.
173
+ * `Foo?`: (where `Foo` is a module name) return `self.is_a?(Foo)`.
174
+ This is a convienience for a common need. Example:
175
+
176
+ <pre>
177
+ \# print all global variables
178
+ ast.entities.each do |node|
179
+ node.Declaration? or next
180
+ node.declarators.each do |decl|
181
+ unless decl.type.Function?
182
+ puts "#{decl.name}: #{decl.type}"
183
+ end
184
+ end
185
+ end
186
+ </pre>
187
+
188
+ The `=~` method lets you do:
189
+
190
+ if declarator.type =~ 'const int *'
191
+ puts "Ooh, a const int pointer!"
192
+ end
193
+
194
+ This is not the same as `declarator.type.to_s == 'const int *'`;
195
+ that'd require you to guess how `to_s` formats its strings (most
196
+ notably, the whitespace).
197
+
198
+ ### Fields and Children
199
+
200
+ The big table down below lists the *fields* of each `Node`. A field is
201
+ an attribute which:
202
+
203
+ * is used in equality checks (`==` and `eql?`).
204
+ * are copied recursively by `dup` and `clone`.
205
+
206
+ Fields listed as *children* form the tree structure. They only have a
207
+ `Node` or `nil` value, and are yielded/returned/affected by the
208
+ traversal methods:
209
+
210
+ * `next`, `prev`: return the next/prev sibling.
211
+ * `list_next`, `list_prev`: like `next`/`prev`, but also requires the
212
+ parent to be `NodeList`. I'll be honest; I don't remember why I
213
+ added these methods. They may well suddenly disappear.
214
+ * `each`, `reverse_each`: Yield all (non-nil) children. `Node`
215
+ includes `Enumerable`, so, you know.
216
+ * `depth_first`, `reverse_depth_first`: Walk the tree in that order,
217
+ yielding two args (event, node) at each node. event is `:down` on
218
+ the way down, `:up` on the way up. If the block throws `:prune`, it
219
+ won't descend any further.
220
+ * `preorder`, `reverse_preorder`, `postorder`, `reverse_postorder`:
221
+ Walk the tree depth first, yielding nodes in the given order. For
222
+ the preorders, if the block throws `:prune`, it won't descend any
223
+ further.
224
+ * `node_after(child)`, `node_before(child)`: return the node
225
+ before/after child (same as `child.next`).
226
+ * `remove_node(child)`: remove child from this node (same as
227
+ `child.detach`).
228
+ * `replace_node(child, new_child)`: replace child with yeah you
229
+ guessed it (same as `child.replace_with(newchild)`).
230
+
231
+ Note: don't modify the tree during traversal!
232
+
233
+ Other notes about the table:
234
+
235
+ * Field names that end in '?' are always true-or-false.
236
+ * If no default is listed:
237
+ * it is false if the field name ends in a '?'
238
+ * it is a `NodeArray` if it is a `NodeList`.
239
+ * it is `nil` otherwise.
240
+
241
+ <table class="node_desc" cellspacing="0">
242
+ <style>
243
+ table.node_desc tr.first_field td {
244
+ border-top: 1px solid black;
245
+ }
246
+
247
+ table.node_desc tr.first_field table td {
248
+ border: none;
249
+ }
250
+
251
+ table.node_desc td {
252
+ padding: 3px;
253
+ vertical-align: top;
254
+ {
255
+
256
+ table.node_desc table td {
257
+ padding: 0px;
258
+ {
259
+ </style>
260
+
261
+ <tr>
262
+ <th align="center">Class</th>
263
+ <th align="center">Field</th>
264
+ <th align="center">Type / values</th>
265
+ <th align="center">Default</th>
266
+ <th align="center">Comments</th>
267
+ </tr>
268
+
269
+ <tr class="first_field">
270
+ <td class="nd_class" rowspan="1"><tt>TranslationUnit</tt></td>
271
+ <td class="nd_field"><tt>entities *</tt></td>
272
+ <td class="nd_values"><tt>NodeList</tt></td>
273
+ <td class="nd_default"><tt>NodeChain[]</tt></td>
274
+ <td class="nd_comments" rowspan="1">
275
+ The root of a parsed file.
276
+ </td>
277
+ </tr>
278
+
279
+ <tr class="first_field">
280
+ <td class="nd_class" rowspan="4"><tt>Declaration</tt></td>
281
+ <td class="nd_field"><tt>storage</tt></td>
282
+ <td class="nd_values"><tt>:typedef</tt>, <tt>:extern</tt>, <tt>:static</tt>, <tt>:auto</tt>, <tt>:register</tt></td>
283
+ <td class="nd_default"></td>
284
+ <td class="nd_comments" rowspan="4">
285
+ Also:
286
+ <ul>
287
+ <li><tt>#typedef? </tt> -- true iff <tt>storage == :typedef </tt></li>
288
+ <li><tt>#extern? </tt> -- true iff <tt>storage == :extern </tt></li>
289
+ <li><tt>#static? </tt> -- true iff <tt>storage == :static </tt></li>
290
+ <li><tt>#auto? </tt> -- true iff <tt>storage == :auto </tt></li>
291
+ <li><tt>#register?</tt> -- true iff <tt>storage == :register</tt></li>
292
+ </ul>
293
+ </td>
294
+ </tr>
295
+ <tr>
296
+ <td class="nd_field"><tt>type *</tt></td>
297
+ <td class="nd_values"><tt>DirectType</tt></td>
298
+ <td class="nd_default"></td>
299
+ </tr>
300
+ <tr>
301
+ <td class="nd_field"><tt>declarators *</tt></td>
302
+ <td class="nd_values"><tt>NodeList</tt></td>
303
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
304
+ </tr>
305
+ <tr>
306
+ <td class="nd_field"><tt>inline?</tt></td>
307
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
308
+ <td class="nd_default"></td>
309
+ </tr>
310
+
311
+ <tr class="first_field">
312
+ <td class="nd_class" rowspan="4"><tt>Declarator</tt></td>
313
+ <td class="nd_field"><tt>indirect_type *</tt></td>
314
+ <td class="nd_values"><tt>IndirectType</tt></td>
315
+ <td class="nd_default"></td>
316
+ <td class="nd_comments" rowspan="4">
317
+ What's a "declarator?" Consider "<tt>int i, *ip;</tt>". This is
318
+ a <tt>Declaration</tt> with two <tt>Declarator</tt>s:
319
+ <pre>
320
+ Declaration
321
+ type: Int
322
+ declarators:
323
+ - Declarator
324
+ name: "i"
325
+ - Declarator
326
+ indirect_type: Pointer
327
+ name: "ip"
328
+ </pre>
329
+ The <tt>indirect_type</tt> of the <tt>ip</tt>
330
+ <tt>Declarator</tt> is a <tt>Pointer</tt> to <tt>nil</tt>.
331
+ To get the complete type of the variable use:
332
+ <ul>
333
+ <li>
334
+ <tt>#type</tt> -- return the complete type. This is a clone;
335
+ modifying it won't modify the tree.
336
+ </li>
337
+ </ul>
338
+ So calling <tt>#type</tt> on the <tt>ip</tt> <tt>Declarator</tt>
339
+ gives:
340
+ <pre>
341
+ Pointer
342
+ type: Int
343
+ </pre>
344
+ </td>
345
+ </tr>
346
+ <tr>
347
+ <td class="nd_field"><tt>name</tt></td>
348
+ <td class="nd_values"><tt>String</tt></td>
349
+ <td class="nd_default"></td>
350
+ </tr>
351
+ <tr>
352
+ <td class="nd_field"><tt>init *</tt></td>
353
+ <td class="nd_values"><tt>Expression</tt></td>
354
+ <td class="nd_default"></td>
355
+ </tr>
356
+ <tr>
357
+ <td class="nd_field"><tt>num_bits *</tt></td>
358
+ <td class="nd_values"><tt>Integer</tt></td>
359
+ <td class="nd_default"></td>
360
+ </tr>
361
+
362
+ <tr class="first_field">
363
+ <td class="nd_class" rowspan="6"><tt>FunctionDef</tt></td>
364
+ <td class="nd_field"><tt>storage</tt></td>
365
+ <td class="nd_values"><tt>:extern</tt>, <tt>:static</tt></td>
366
+ <td class="nd_default"></td>
367
+ <td class="nd_comments" rowspan="6">
368
+ Also:
369
+ <ul>
370
+ <li><tt>#extern?</tt> -- return true iff <tt>storage == :extern</tt></li>
371
+ <li><tt>#static?</tt> -- return true iff <tt>storage == :static</tt></li>
372
+ <li><tt>#prototype?</tt> -- same as !no_prototype?</li>
373
+ <li><tt>#prototype=(val)</tt> -- same as no_prototype = !val</li>
374
+ </ul>
375
+ <tt>no_prototype?</tt> means that no prototype was given. That means parameter types weren't given in the parens, but in the "old-style" declaration list. Example:
376
+ <table>
377
+ <tr><td style="padding: 0px 25px">
378
+ <pre>
379
+ int main(argc, argv)
380
+ int argc;
381
+ char **argv;
382
+ {
383
+ return 0;
384
+ }</pre>
385
+ </td><td style="padding: 0px 25px">
386
+ <pre>
387
+ int main(int argc, char **argv) {
388
+ return 0;
389
+ }</pre>
390
+ </td></tr>
391
+ <tr>
392
+ <th>No prototype</th>
393
+ <th>Prototype</th>
394
+ </tr>
395
+ </table>
396
+ Everyone tells you to use prototypes. That's because no type
397
+ checking is done when calling a function declared without a
398
+ prototype.
399
+ </td>
400
+ </tr>
401
+ <tr>
402
+ <td class="nd_field"><tt>inline?</tt></td>
403
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
404
+ <td class="nd_default"></td>
405
+ </tr>
406
+ <tr>
407
+ <td class="nd_field"><tt>type *</tt></td>
408
+ <td class="nd_values"><tt>Type</tt></td>
409
+ <td class="nd_default"></td>
410
+ </tr>
411
+ <tr>
412
+ <td class="nd_field"><tt>name</tt></td>
413
+ <td class="nd_values"><tt>String</tt></td>
414
+ <td class="nd_default"></td>
415
+ </tr>
416
+ <tr>
417
+ <td class="nd_field"><tt>def *</tt></td>
418
+ <td class="nd_values"><tt>Block</tt></td>
419
+ <td class="nd_default"><tt>Block.new</tt></td>
420
+ </tr>
421
+ <tr>
422
+ <td class="nd_field"><tt>no_prototype?</tt></td>
423
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
424
+ <td class="nd_default"></td>
425
+ </tr>
426
+
427
+ <tr class="first_field">
428
+ <td class="nd_class" rowspan="3"><tt>Parameter</tt></td>
429
+ <td class="nd_field"><tt>register?</tt></td>
430
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
431
+ <td class="nd_default"></td>
432
+ <td class="nd_comments" rowspan="3">
433
+ Used in <tt>Function</tt>s.
434
+ </td>
435
+ </tr>
436
+ <tr>
437
+ <td class="nd_field"><tt>type *</tt></td>
438
+ <td class="nd_values"><tt>Type</tt></td>
439
+ <td class="nd_default"></td>
440
+ </tr>
441
+ <tr>
442
+ <td class="nd_field"><tt>name</tt></td>
443
+ <td class="nd_values"><tt>String</tt></td>
444
+ <td class="nd_default"></td>
445
+ </tr>
446
+
447
+ <tr class="first_field">
448
+ <td class="nd_class" rowspan="2"><tt>Enumerator</tt></td>
449
+ <td class="nd_field"><tt>name</tt></td>
450
+ <td class="nd_values"><tt>String</tt></td>
451
+ <td class="nd_default"></td>
452
+ <td class="nd_comments" rowspan="2">
453
+ Used in <tt>Enum</tt>s.
454
+ </td>
455
+ </tr>
456
+ <tr>
457
+ <td class="nd_field"><tt>val *</tt></td>
458
+ <td class="nd_values"><tt>Expression</tt></td>
459
+ <td class="nd_default"></td>
460
+ </tr>
461
+
462
+ <tr class="first_field">
463
+ <td class="nd_class" rowspan="2"><tt>MemberInit</tt></td>
464
+ <td class="nd_field"><tt>member *</tt></td>
465
+ <td class="nd_values"><tt>NodeList</tt> of (<tt>Member</tt> or <tt>Expression</tt>)</td>
466
+ <td class="nd_default"></td>
467
+ <td class="nd_comments" rowspan="2">
468
+ Used in <tt>CompoundLiteral</tt>s.
469
+ </td>
470
+ </tr>
471
+ <tr>
472
+ <td class="nd_field"><tt>init *</tt></td>
473
+ <td class="nd_values"><tt>Expression</tt></td>
474
+ <td class="nd_default"></td>
475
+ </tr>
476
+
477
+ <tr class="first_field">
478
+ <td class="nd_class" rowspan="1"><tt>Member</tt></td>
479
+ <td class="nd_field"><tt>name</tt></td>
480
+ <td class="nd_values"><tt>String</tt></td>
481
+ <td class="nd_default"></td>
482
+ <td class="nd_comments" rowspan="1">
483
+ Used in <tt>MemberInit</tt>s.
484
+ </td>
485
+ </tr>
486
+
487
+ <tr class="first_field">
488
+ <td class="nd_class" rowspan="2"><tt>Block</tt></td>
489
+ <td class="nd_field"><tt>labels *</tt></td>
490
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Label</tt></td>
491
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
492
+ <td class="nd_comments" rowspan="2">
493
+ </td>
494
+ </tr>
495
+ <tr>
496
+ <td class="nd_field"><tt>stmts *</tt></td>
497
+ <td class="nd_values"><tt>NodeList</tt> of (<tt>Statement</tt> or <tt>Declaration</tt> or <tt>Comment</tt>)</td>
498
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
499
+ </tr>
500
+
501
+ <tr class="first_field">
502
+ <td class="nd_class" rowspan="4"><tt>If</tt></td>
503
+ <td class="nd_field"><tt>labels *</tt></td>
504
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Label</tt></td>
505
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
506
+ <td class="nd_comments" rowspan="4">
507
+ </td>
508
+ </tr>
509
+ <tr>
510
+ <td class="nd_field"><tt>cond *</tt></td>
511
+ <td class="nd_values"><tt>Expression</tt></td>
512
+ <td class="nd_default"></td>
513
+ </tr>
514
+ <tr>
515
+ <td class="nd_field"><tt>then *</tt></td>
516
+ <td class="nd_values"><tt>Statement</tt></td>
517
+ <td class="nd_default"></td>
518
+ </tr>
519
+ <tr>
520
+ <td class="nd_field"><tt>else *</tt></td>
521
+ <td class="nd_values"><tt>Statement</tt></td>
522
+ <td class="nd_default"></td>
523
+ </tr>
524
+
525
+ <tr class="first_field">
526
+ <td class="nd_class" rowspan="3"><tt>Switch</tt></td>
527
+ <td class="nd_field"><tt>labels *</tt></td>
528
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Label</tt></td>
529
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
530
+ <td class="nd_comments" rowspan="3">
531
+ </td>
532
+ </tr>
533
+ <tr>
534
+ <td class="nd_field"><tt>cond *</tt></td>
535
+ <td class="nd_values"><tt>Expression</tt></td>
536
+ <td class="nd_default"></td>
537
+ </tr>
538
+ <tr>
539
+ <td class="nd_field"><tt>stmt *</tt></td>
540
+ <td class="nd_values"><tt>Statement</tt></td>
541
+ <td class="nd_default"></td>
542
+ </tr>
543
+
544
+ <tr class="first_field">
545
+ <td class="nd_class" rowspan="4"><tt>While</tt></td>
546
+ <td class="nd_field"><tt>labels *</tt></td>
547
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Label</tt></td>
548
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
549
+ <td class="nd_comments" rowspan="4">
550
+ <tt>do?</tt> means it's a do-while loop.
551
+ </td>
552
+ </tr>
553
+ <tr>
554
+ <td class="nd_field"><tt>do?</tt></td>
555
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
556
+ <td class="nd_default"></td>
557
+ </tr>
558
+ <tr>
559
+ <td class="nd_field"><tt>cond *</tt></td>
560
+ <td class="nd_values"><tt>Expression</tt></td>
561
+ <td class="nd_default"></td>
562
+ </tr>
563
+ <tr>
564
+ <td class="nd_field"><tt>stmt *</tt></td>
565
+ <td class="nd_values"><tt>Statement</tt></td>
566
+ <td class="nd_default"></td>
567
+ </tr>
568
+
569
+ <tr class="first_field">
570
+ <td class="nd_class" rowspan="5"><tt>For</tt></td>
571
+ <td class="nd_field"><tt>labels *</tt></td>
572
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Label</tt></td>
573
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
574
+ <td class="nd_comments" rowspan="5">
575
+ </td>
576
+ </tr>
577
+ <tr>
578
+ <td class="nd_field"><tt>init *</tt></td>
579
+ <td class="nd_values"><tt>Expression</tt> or <tt>Declaration</tt></td>
580
+ <td class="nd_default"></td>
581
+ </tr>
582
+ <tr>
583
+ <td class="nd_field"><tt>cond *</tt></td>
584
+ <td class="nd_values"><tt>Expression</tt></td>
585
+ <td class="nd_default"></td>
586
+ </tr>
587
+ <tr>
588
+ <td class="nd_field"><tt>iter *</tt></td>
589
+ <td class="nd_values"><tt>Expression</tt></td>
590
+ <td class="nd_default"></td>
591
+ </tr>
592
+ <tr>
593
+ <td class="nd_field"><tt>stmt *</tt></td>
594
+ <td class="nd_values"><tt>Statement</tt></td>
595
+ <td class="nd_default"></td>
596
+ </tr>
597
+
598
+ <tr class="first_field">
599
+ <td class="nd_class" rowspan="2"><tt>Goto</tt></td>
600
+ <td class="nd_field"><tt>labels *</tt></td>
601
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Label</tt></td>
602
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
603
+ <td class="nd_comments" rowspan="2">
604
+ </td>
605
+ </tr>
606
+ <tr>
607
+ <td class="nd_field"><tt>target</tt></td>
608
+ <td class="nd_values"><tt>String</tt></td>
609
+ <td class="nd_default"></td>
610
+ </tr>
611
+
612
+ <tr class="first_field">
613
+ <td class="nd_class" rowspan="1"><tt>Continue</tt></td>
614
+ <td class="nd_field"><tt>labels *</tt></td>
615
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Label</tt></td>
616
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
617
+ <td class="nd_comments" rowspan="1">
618
+ </td>
619
+ </tr>
620
+
621
+ <tr class="first_field">
622
+ <td class="nd_class" rowspan="1"><tt>Break</tt></td>
623
+ <td class="nd_field"><tt>labels *</tt></td>
624
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Label</tt></td>
625
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
626
+ <td class="nd_comments" rowspan="1">
627
+ </td>
628
+ </tr>
629
+
630
+ <tr class="first_field">
631
+ <td class="nd_class" rowspan="2"><tt>Return</tt></td>
632
+ <td class="nd_field"><tt>labels *</tt></td>
633
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Label</tt></td>
634
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
635
+ <td class="nd_comments" rowspan="2">
636
+ </td>
637
+ </tr>
638
+ <tr>
639
+ <td class="nd_field"><tt>expr *</tt></td>
640
+ <td class="nd_values"><tt>Expression</tt></td>
641
+ <td class="nd_default"></td>
642
+ </tr>
643
+
644
+ <tr class="first_field">
645
+ <td class="nd_class" rowspan="2"><tt>ExpressionStatement</tt></td>
646
+ <td class="nd_field"><tt>labels *</tt></td>
647
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Label</tt></td>
648
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
649
+ <td class="nd_comments" rowspan="2">
650
+ </td>
651
+ </tr>
652
+ <tr>
653
+ <td class="nd_field"><tt>expr *</tt></td>
654
+ <td class="nd_values"><tt>Expression</tt></td>
655
+ <td class="nd_default"></td>
656
+ </tr>
657
+
658
+ <tr class="first_field">
659
+ <td class="nd_class" rowspan="1"><tt>PlainLabel</tt></td>
660
+ <td class="nd_field"><tt>name</tt></td>
661
+ <td class="nd_values"><tt>String</tt></td>
662
+ <td class="nd_default"></td>
663
+ <td class="nd_comments" rowspan="1">
664
+ </td>
665
+ </tr>
666
+
667
+ <tr class="first_field">
668
+ <td class="nd_class" rowspan="1"><tt>Default</tt></td>
669
+ <td class="nd_field"></td>
670
+ <td class="nd_values"></td>
671
+ <td class="nd_default"></td>
672
+ <td class="nd_comments" rowspan="1">
673
+ </td>
674
+ </tr>
675
+
676
+ <tr class="first_field">
677
+ <td class="nd_class" rowspan="1"><tt>Case</tt></td>
678
+ <td class="nd_field"><tt>expr *</tt></td>
679
+ <td class="nd_values"><tt>Expression</tt></td>
680
+ <td class="nd_default"></td>
681
+ <td class="nd_comments" rowspan="1">
682
+ </td>
683
+ </tr>
684
+
685
+ <tr class="first_field">
686
+ <td class="nd_class" rowspan="1"><tt>Comma</tt></td>
687
+ <td class="nd_field"><tt>exprs *</tt></td>
688
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Expression</tt></td>
689
+ <td class="nd_default"></td>
690
+ <td class="nd_comments" rowspan="1">
691
+ </td>
692
+ </tr>
693
+
694
+ <tr class="first_field">
695
+ <td class="nd_class" rowspan="3"><tt>Conditional</tt></td>
696
+ <td class="nd_field"><tt>cond *</tt></td>
697
+ <td class="nd_values"><tt>Expression</tt></td>
698
+ <td class="nd_default"></td>
699
+ <td class="nd_comments" rowspan="3">
700
+ </td>
701
+ </tr>
702
+ <tr>
703
+ <td class="nd_field"><tt>then *</tt></td>
704
+ <td class="nd_values"><tt>Expression</tt></td>
705
+ <td class="nd_default"></td>
706
+ </tr>
707
+ <tr>
708
+ <td class="nd_field"><tt>else *</tt></td>
709
+ <td class="nd_values"><tt>Expression</tt></td>
710
+ <td class="nd_default"></td>
711
+ </tr>
712
+
713
+ <tr class="first_field">
714
+ <td class="nd_class" rowspan="1"><tt>Variable</tt></td>
715
+ <td class="nd_field"><tt>name</tt></td>
716
+ <td class="nd_values"><tt>String</tt></td>
717
+ <td class="nd_default"></td>
718
+ <td class="nd_comments" rowspan="1">
719
+ </td>
720
+ </tr>
721
+
722
+ <tr class="first_field">
723
+ <td class="nd_class" rowspan="2"><tt>Index</tt></td>
724
+ <td class="nd_field"><tt>expr *</tt></td>
725
+ <td class="nd_values"><tt>Expression</tt></td>
726
+ <td class="nd_default"></td>
727
+ <td class="nd_comments" rowspan="2">
728
+ </td>
729
+ </tr>
730
+ <tr>
731
+ <td class="nd_field"><tt>index *</tt></td>
732
+ <td class="nd_values"><tt>Expression</tt></td>
733
+ <td class="nd_default"></td>
734
+ </tr>
735
+
736
+ <tr class="first_field">
737
+ <td class="nd_class" rowspan="2"><tt>Call</tt></td>
738
+ <td class="nd_field"><tt>expr *</tt></td>
739
+ <td class="nd_values"><tt>Expression</tt></td>
740
+ <td class="nd_default"></td>
741
+ <td class="nd_comments" rowspan="2">
742
+ </td>
743
+ </tr>
744
+ <tr>
745
+ <td class="nd_field"><tt>args *</tt></td>
746
+ <td class="nd_values"><tt>NodeList</tt> of (<tt>Expression</tt> or <tt>Type</tt>)</td>
747
+ <td class="nd_default"></td>
748
+ </tr>
749
+
750
+ <tr class="first_field">
751
+ <td class="nd_class" rowspan="2"><tt>Dot</tt></td>
752
+ <td class="nd_field"><tt>expr *</tt></td>
753
+ <td class="nd_values"><tt>Expression</tt></td>
754
+ <td class="nd_default"></td>
755
+ <td class="nd_comments" rowspan="2">
756
+ </td>
757
+ </tr>
758
+ <tr>
759
+ <td class="nd_field"><tt>member *</tt></td>
760
+ <td class="nd_values"><tt>String</tt></td>
761
+ <td class="nd_default"></td>
762
+ </tr>
763
+
764
+ <tr class="first_field">
765
+ <td class="nd_class" rowspan="2"><tt>Arrow</tt></td>
766
+ <td class="nd_field"><tt>expr *</tt></td>
767
+ <td class="nd_values"><tt>Expression</tt></td>
768
+ <td class="nd_default"></td>
769
+ <td class="nd_comments" rowspan="2">
770
+ </td>
771
+ </tr>
772
+ <tr>
773
+ <td class="nd_field"><tt>member *</tt></td>
774
+ <td class="nd_values"><tt>String</tt></td>
775
+ <td class="nd_default"></td>
776
+ </tr>
777
+
778
+ <tr class="first_field">
779
+ <td class="nd_class" rowspan="1"><tt>PostInc</tt></td>
780
+ <td class="nd_field"><tt>expr *</tt></td>
781
+ <td class="nd_values"><tt>Expression</tt></td>
782
+ <td class="nd_default"></td>
783
+ <td class="nd_comments" rowspan="1">
784
+ </td>
785
+ </tr>
786
+
787
+ <tr class="first_field">
788
+ <td class="nd_class" rowspan="1"><tt>PostDec</tt></td>
789
+ <td class="nd_field"><tt>expr *</tt></td>
790
+ <td class="nd_values"><tt>Expression</tt></td>
791
+ <td class="nd_default"></td>
792
+ <td class="nd_comments" rowspan="1">
793
+ </td>
794
+ </tr>
795
+
796
+ <tr class="first_field">
797
+ <td class="nd_class" rowspan="2"><tt>Cast</tt></td>
798
+ <td class="nd_field"><tt>type *</tt></td>
799
+ <td class="nd_values"><tt>Type</tt></td>
800
+ <td class="nd_default"></td>
801
+ <td class="nd_comments" rowspan="2">
802
+ </td>
803
+ </tr>
804
+ <tr>
805
+ <td class="nd_field"><tt>expr *</tt></td>
806
+ <td class="nd_values"><tt>Expression</tt></td>
807
+ <td class="nd_default"></td>
808
+ </tr>
809
+
810
+ <tr class="first_field">
811
+ <td class="nd_class" rowspan="1"><tt>Address</tt></td>
812
+ <td class="nd_field"><tt>expr *</tt></td>
813
+ <td class="nd_values"><tt>Expression</tt></td>
814
+ <td class="nd_default"></td>
815
+ <td class="nd_comments" rowspan="1">
816
+ </td>
817
+ </tr>
818
+
819
+ <tr class="first_field">
820
+ <td class="nd_class" rowspan="1"><tt>Dereference</tt></td>
821
+ <td class="nd_field"><tt>expr *</tt></td>
822
+ <td class="nd_values"><tt>Expression</tt></td>
823
+ <td class="nd_default"></td>
824
+ <td class="nd_comments" rowspan="1">
825
+ </td>
826
+ </tr>
827
+
828
+ <tr class="first_field">
829
+ <td class="nd_class" rowspan="1"><tt>Sizeof</tt></td>
830
+ <td class="nd_field"><tt>expr *</tt></td>
831
+ <td class="nd_values"><tt>Type</tt> or <tt>Expression</tt></td>
832
+ <td class="nd_default"></td>
833
+ <td class="nd_comments" rowspan="1">
834
+ </td>
835
+ </tr>
836
+
837
+ <tr class="first_field">
838
+ <td class="nd_class" rowspan="1"><tt>Positive</tt></td>
839
+ <td class="nd_field"><tt>expr *</tt></td>
840
+ <td class="nd_values"><tt>Expression</tt></td>
841
+ <td class="nd_default"></td>
842
+ <td class="nd_comments" rowspan="1">
843
+ </td>
844
+ </tr>
845
+
846
+ <tr class="first_field">
847
+ <td class="nd_class" rowspan="1"><tt>Negative</tt></td>
848
+ <td class="nd_field"><tt>expr *</tt></td>
849
+ <td class="nd_values"><tt>Expression</tt></td>
850
+ <td class="nd_default"></td>
851
+ <td class="nd_comments" rowspan="1">
852
+ </td>
853
+ </tr>
854
+
855
+ <tr class="first_field">
856
+ <td class="nd_class" rowspan="1"><tt>PreInc</tt></td>
857
+ <td class="nd_field"><tt>expr *</tt></td>
858
+ <td class="nd_values"><tt>Expression</tt></td>
859
+ <td class="nd_default"></td>
860
+ <td class="nd_comments" rowspan="1">
861
+ </td>
862
+ </tr>
863
+
864
+ <tr class="first_field">
865
+ <td class="nd_class" rowspan="1"><tt>PreDec</tt></td>
866
+ <td class="nd_field"><tt>expr *</tt></td>
867
+ <td class="nd_values"><tt>Expression</tt></td>
868
+ <td class="nd_default"></td>
869
+ <td class="nd_comments" rowspan="1">
870
+ </td>
871
+ </tr>
872
+
873
+ <tr class="first_field">
874
+ <td class="nd_class" rowspan="1"><tt>BitNot</tt></td>
875
+ <td class="nd_field"><tt>expr *</tt></td>
876
+ <td class="nd_values"><tt>Expression</tt></td>
877
+ <td class="nd_default"></td>
878
+ <td class="nd_comments" rowspan="1">
879
+ </td>
880
+ </tr>
881
+
882
+ <tr class="first_field">
883
+ <td class="nd_class" rowspan="1"><tt>Not</tt></td>
884
+ <td class="nd_field"><tt>expr *</tt></td>
885
+ <td class="nd_values"><tt>Expression</tt></td>
886
+ <td class="nd_default"></td>
887
+ <td class="nd_comments" rowspan="1">
888
+ </td>
889
+ </tr>
890
+
891
+ <tr class="first_field">
892
+ <td class="nd_class" rowspan="2"><tt>Add</tt></td>
893
+ <td class="nd_field"><tt>expr1 *</tt></td>
894
+ <td class="nd_values"><tt>Expression</tt></td>
895
+ <td class="nd_default"></td>
896
+ <td class="nd_comments" rowspan="2">
897
+ </td>
898
+ </tr>
899
+ <tr>
900
+ <td class="nd_field"><tt>expr2 *</tt></td>
901
+ <td class="nd_values"><tt>Expression</tt></td>
902
+ <td class="nd_default"></td>
903
+ </tr>
904
+
905
+ <tr class="first_field">
906
+ <td class="nd_class" rowspan="2"><tt>Subtract</tt></td>
907
+ <td class="nd_field"><tt>expr1 *</tt></td>
908
+ <td class="nd_values"><tt>Expression</tt></td>
909
+ <td class="nd_default"></td>
910
+ <td class="nd_comments" rowspan="2">
911
+ </td>
912
+ </tr>
913
+ <tr>
914
+ <td class="nd_field"><tt>expr2 *</tt></td>
915
+ <td class="nd_values"><tt>Expression</tt></td>
916
+ <td class="nd_default"></td>
917
+ </tr>
918
+
919
+ <tr class="first_field">
920
+ <td class="nd_class" rowspan="2"><tt>Multiply</tt></td>
921
+ <td class="nd_field"><tt>expr1 *</tt></td>
922
+ <td class="nd_values"><tt>Expression</tt></td>
923
+ <td class="nd_default"></td>
924
+ <td class="nd_comments" rowspan="2">
925
+ </td>
926
+ </tr>
927
+ <tr>
928
+ <td class="nd_field"><tt>expr2 *</tt></td>
929
+ <td class="nd_values"><tt>Expression</tt></td>
930
+ <td class="nd_default"></td>
931
+ </tr>
932
+
933
+ <tr class="first_field">
934
+ <td class="nd_class" rowspan="2"><tt>Divide</tt></td>
935
+ <td class="nd_field"><tt>expr1 *</tt></td>
936
+ <td class="nd_values"><tt>Expression</tt></td>
937
+ <td class="nd_default"></td>
938
+ <td class="nd_comments" rowspan="2">
939
+ </td>
940
+ </tr>
941
+ <tr>
942
+ <td class="nd_field"><tt>expr2 *</tt></td>
943
+ <td class="nd_values"><tt>Expression</tt></td>
944
+ <td class="nd_default"></td>
945
+ </tr>
946
+
947
+ <tr class="first_field">
948
+ <td class="nd_class" rowspan="2"><tt>Mod</tt></td>
949
+ <td class="nd_field"><tt>expr1 *</tt></td>
950
+ <td class="nd_values"><tt>Expression</tt></td>
951
+ <td class="nd_default"></td>
952
+ <td class="nd_comments" rowspan="2">
953
+ </td>
954
+ </tr>
955
+ <tr>
956
+ <td class="nd_field"><tt>expr2 *</tt></td>
957
+ <td class="nd_values"><tt>Expression</tt></td>
958
+ <td class="nd_default"></td>
959
+ </tr>
960
+
961
+ <tr class="first_field">
962
+ <td class="nd_class" rowspan="2"><tt>Equal</tt></td>
963
+ <td class="nd_field"><tt>expr1 *</tt></td>
964
+ <td class="nd_values"><tt>Expression</tt></td>
965
+ <td class="nd_default"></td>
966
+ <td class="nd_comments" rowspan="2">
967
+ </td>
968
+ </tr>
969
+ <tr>
970
+ <td class="nd_field"><tt>expr2 *</tt></td>
971
+ <td class="nd_values"><tt>Expression</tt></td>
972
+ <td class="nd_default"></td>
973
+ </tr>
974
+
975
+ <tr class="first_field">
976
+ <td class="nd_class" rowspan="2"><tt>NotEqual</tt></td>
977
+ <td class="nd_field"><tt>expr1 *</tt></td>
978
+ <td class="nd_values"><tt>Expression</tt></td>
979
+ <td class="nd_default"></td>
980
+ <td class="nd_comments" rowspan="2">
981
+ </td>
982
+ </tr>
983
+ <tr>
984
+ <td class="nd_field"><tt>expr2 *</tt></td>
985
+ <td class="nd_values"><tt>Expression</tt></td>
986
+ <td class="nd_default"></td>
987
+ </tr>
988
+
989
+ <tr class="first_field">
990
+ <td class="nd_class" rowspan="2"><tt>Less</tt></td>
991
+ <td class="nd_field"><tt>expr1 *</tt></td>
992
+ <td class="nd_values"><tt>Expression</tt></td>
993
+ <td class="nd_default"></td>
994
+ <td class="nd_comments" rowspan="2">
995
+ </td>
996
+ </tr>
997
+ <tr>
998
+ <td class="nd_field"><tt>expr2 *</tt></td>
999
+ <td class="nd_values"><tt>Expression</tt></td>
1000
+ <td class="nd_default"></td>
1001
+ </tr>
1002
+
1003
+ <tr class="first_field">
1004
+ <td class="nd_class" rowspan="2"><tt>More</tt></td>
1005
+ <td class="nd_field"><tt>expr1 *</tt></td>
1006
+ <td class="nd_values"><tt>Expression</tt></td>
1007
+ <td class="nd_default"></td>
1008
+ <td class="nd_comments" rowspan="2">
1009
+ </td>
1010
+ </tr>
1011
+ <tr>
1012
+ <td class="nd_field"><tt>expr2 *</tt></td>
1013
+ <td class="nd_values"><tt>Expression</tt></td>
1014
+ <td class="nd_default"></td>
1015
+ </tr>
1016
+
1017
+ <tr class="first_field">
1018
+ <td class="nd_class" rowspan="2"><tt>LessOrEqual</tt></td>
1019
+ <td class="nd_field"><tt>expr1 *</tt></td>
1020
+ <td class="nd_values"><tt>Expression</tt></td>
1021
+ <td class="nd_default"></td>
1022
+ <td class="nd_comments" rowspan="2">
1023
+ </td>
1024
+ </tr>
1025
+ <tr>
1026
+ <td class="nd_field"><tt>expr2 *</tt></td>
1027
+ <td class="nd_values"><tt>Expression</tt></td>
1028
+ <td class="nd_default"></td>
1029
+ </tr>
1030
+
1031
+ <tr class="first_field">
1032
+ <td class="nd_class" rowspan="2"><tt>MoreOrEqual</tt></td>
1033
+ <td class="nd_field"><tt>expr1 *</tt></td>
1034
+ <td class="nd_values"><tt>Expression</tt></td>
1035
+ <td class="nd_default"></td>
1036
+ <td class="nd_comments" rowspan="2">
1037
+ </td>
1038
+ </tr>
1039
+ <tr>
1040
+ <td class="nd_field"><tt>expr2 *</tt></td>
1041
+ <td class="nd_values"><tt>Expression</tt></td>
1042
+ <td class="nd_default"></td>
1043
+ </tr>
1044
+
1045
+ <tr class="first_field">
1046
+ <td class="nd_class" rowspan="2"><tt>BitAnd</tt></td>
1047
+ <td class="nd_field"><tt>expr1 *</tt></td>
1048
+ <td class="nd_values"><tt>Expression</tt></td>
1049
+ <td class="nd_default"></td>
1050
+ <td class="nd_comments" rowspan="2">
1051
+ </td>
1052
+ </tr>
1053
+ <tr>
1054
+ <td class="nd_field"><tt>expr2 *</tt></td>
1055
+ <td class="nd_values"><tt>Expression</tt></td>
1056
+ <td class="nd_default"></td>
1057
+ </tr>
1058
+
1059
+ <tr class="first_field">
1060
+ <td class="nd_class" rowspan="2"><tt>BitOr</tt></td>
1061
+ <td class="nd_field"><tt>expr1 *</tt></td>
1062
+ <td class="nd_values"><tt>Expression</tt></td>
1063
+ <td class="nd_default"></td>
1064
+ <td class="nd_comments" rowspan="2">
1065
+ </td>
1066
+ </tr>
1067
+ <tr>
1068
+ <td class="nd_field"><tt>expr2 *</tt></td>
1069
+ <td class="nd_values"><tt>Expression</tt></td>
1070
+ <td class="nd_default"></td>
1071
+ </tr>
1072
+
1073
+ <tr class="first_field">
1074
+ <td class="nd_class" rowspan="2"><tt>BitXor</tt></td>
1075
+ <td class="nd_field"><tt>expr1 *</tt></td>
1076
+ <td class="nd_values"><tt>Expression</tt></td>
1077
+ <td class="nd_default"></td>
1078
+ <td class="nd_comments" rowspan="2">
1079
+ </td>
1080
+ </tr>
1081
+ <tr>
1082
+ <td class="nd_field"><tt>expr2 *</tt></td>
1083
+ <td class="nd_values"><tt>Expression</tt></td>
1084
+ <td class="nd_default"></td>
1085
+ </tr>
1086
+
1087
+ <tr class="first_field">
1088
+ <td class="nd_class" rowspan="2"><tt>ShiftLeft</tt></td>
1089
+ <td class="nd_field"><tt>expr1 *</tt></td>
1090
+ <td class="nd_values"><tt>Expression</tt></td>
1091
+ <td class="nd_default"></td>
1092
+ <td class="nd_comments" rowspan="2">
1093
+ </td>
1094
+ </tr>
1095
+ <tr>
1096
+ <td class="nd_field"><tt>expr2 *</tt></td>
1097
+ <td class="nd_values"><tt>Expression</tt></td>
1098
+ <td class="nd_default"></td>
1099
+ </tr>
1100
+
1101
+ <tr class="first_field">
1102
+ <td class="nd_class" rowspan="2"><tt>ShiftRight</tt></td>
1103
+ <td class="nd_field"><tt>expr1 *</tt></td>
1104
+ <td class="nd_values"><tt>Expression</tt></td>
1105
+ <td class="nd_default"></td>
1106
+ <td class="nd_comments" rowspan="2">
1107
+ </td>
1108
+ </tr>
1109
+ <tr>
1110
+ <td class="nd_field"><tt>expr2 *</tt></td>
1111
+ <td class="nd_values"><tt>Expression</tt></td>
1112
+ <td class="nd_default"></td>
1113
+ </tr>
1114
+
1115
+ <tr class="first_field">
1116
+ <td class="nd_class" rowspan="2"><tt>And</tt></td>
1117
+ <td class="nd_field"><tt>expr1 *</tt></td>
1118
+ <td class="nd_values"><tt>Expression</tt></td>
1119
+ <td class="nd_default"></td>
1120
+ <td class="nd_comments" rowspan="2">
1121
+ </td>
1122
+ </tr>
1123
+ <tr>
1124
+ <td class="nd_field"><tt>expr2 *</tt></td>
1125
+ <td class="nd_values"><tt>Expression</tt></td>
1126
+ <td class="nd_default"></td>
1127
+ </tr>
1128
+
1129
+ <tr class="first_field">
1130
+ <td class="nd_class" rowspan="2"><tt>Or</tt></td>
1131
+ <td class="nd_field"><tt>expr1 *</tt></td>
1132
+ <td class="nd_values"><tt>Expression</tt></td>
1133
+ <td class="nd_default"></td>
1134
+ <td class="nd_comments" rowspan="2">
1135
+ </td>
1136
+ </tr>
1137
+ <tr>
1138
+ <td class="nd_field"><tt>expr2 *</tt></td>
1139
+ <td class="nd_values"><tt>Expression</tt></td>
1140
+ <td class="nd_default"></td>
1141
+ </tr>
1142
+
1143
+ <tr class="first_field">
1144
+ <td class="nd_class" rowspan="2"><tt>Assign</tt></td>
1145
+ <td class="nd_field"><tt>lval *</tt></td>
1146
+ <td class="nd_values"><tt>Expression</tt></td>
1147
+ <td class="nd_default"></td>
1148
+ <td class="nd_comments" rowspan="2">
1149
+ </td>
1150
+ </tr>
1151
+ <tr>
1152
+ <td class="nd_field"><tt>rval *</tt></td>
1153
+ <td class="nd_values"><tt>Expression</tt></td>
1154
+ <td class="nd_default"></td>
1155
+ </tr>
1156
+
1157
+ <tr class="first_field">
1158
+ <td class="nd_class" rowspan="2"><tt>MultiplyAssign</tt></td>
1159
+ <td class="nd_field"><tt>lval *</tt></td>
1160
+ <td class="nd_values"><tt>Expression</tt></td>
1161
+ <td class="nd_default"></td>
1162
+ <td class="nd_comments" rowspan="2">
1163
+ </td>
1164
+ </tr>
1165
+ <tr>
1166
+ <td class="nd_field"><tt>rval *</tt></td>
1167
+ <td class="nd_values"><tt>Expression</tt></td>
1168
+ <td class="nd_default"></td>
1169
+ </tr>
1170
+
1171
+ <tr class="first_field">
1172
+ <td class="nd_class" rowspan="2"><tt>DivideAssign</tt></td>
1173
+ <td class="nd_field"><tt>lval *</tt></td>
1174
+ <td class="nd_values"><tt>Expression</tt></td>
1175
+ <td class="nd_default"></td>
1176
+ <td class="nd_comments" rowspan="2">
1177
+ </td>
1178
+ </tr>
1179
+ <tr>
1180
+ <td class="nd_field"><tt>rval *</tt></td>
1181
+ <td class="nd_values"><tt>Expression</tt></td>
1182
+ <td class="nd_default"></td>
1183
+ </tr>
1184
+
1185
+ <tr class="first_field">
1186
+ <td class="nd_class" rowspan="2"><tt>ModAssign</tt></td>
1187
+ <td class="nd_field"><tt>lval *</tt></td>
1188
+ <td class="nd_values"><tt>Expression</tt></td>
1189
+ <td class="nd_default"></td>
1190
+ <td class="nd_comments" rowspan="2">
1191
+ </td>
1192
+ </tr>
1193
+ <tr>
1194
+ <td class="nd_field"><tt>rval *</tt></td>
1195
+ <td class="nd_values"><tt>Expression</tt></td>
1196
+ <td class="nd_default"></td>
1197
+ </tr>
1198
+
1199
+ <tr class="first_field">
1200
+ <td class="nd_class" rowspan="2"><tt>AddAssign</tt></td>
1201
+ <td class="nd_field"><tt>lval *</tt></td>
1202
+ <td class="nd_values"><tt>Expression</tt></td>
1203
+ <td class="nd_default"></td>
1204
+ <td class="nd_comments" rowspan="2">
1205
+ </td>
1206
+ </tr>
1207
+ <tr>
1208
+ <td class="nd_field"><tt>rval *</tt></td>
1209
+ <td class="nd_values"><tt>Expression</tt></td>
1210
+ <td class="nd_default"></td>
1211
+ </tr>
1212
+
1213
+ <tr class="first_field">
1214
+ <td class="nd_class" rowspan="2"><tt>SubtractAssign</tt></td>
1215
+ <td class="nd_field"><tt>lval *</tt></td>
1216
+ <td class="nd_values"><tt>Expression</tt></td>
1217
+ <td class="nd_default"></td>
1218
+ <td class="nd_comments" rowspan="2">
1219
+ </td>
1220
+ </tr>
1221
+ <tr>
1222
+ <td class="nd_field"><tt>rval *</tt></td>
1223
+ <td class="nd_values"><tt>Expression</tt></td>
1224
+ <td class="nd_default"></td>
1225
+ </tr>
1226
+
1227
+ <tr class="first_field">
1228
+ <td class="nd_class" rowspan="2"><tt>ShiftLeftAssign</tt></td>
1229
+ <td class="nd_field"><tt>lval *</tt></td>
1230
+ <td class="nd_values"><tt>Expression</tt></td>
1231
+ <td class="nd_default"></td>
1232
+ <td class="nd_comments" rowspan="2">
1233
+ </td>
1234
+ </tr>
1235
+ <tr>
1236
+ <td class="nd_field"><tt>rval *</tt></td>
1237
+ <td class="nd_values"><tt>Expression</tt></td>
1238
+ <td class="nd_default"></td>
1239
+ </tr>
1240
+
1241
+ <tr class="first_field">
1242
+ <td class="nd_class" rowspan="2"><tt>ShiftRightAssign</tt></td>
1243
+ <td class="nd_field"><tt>lval *</tt></td>
1244
+ <td class="nd_values"><tt>Expression</tt></td>
1245
+ <td class="nd_default"></td>
1246
+ <td class="nd_comments" rowspan="2">
1247
+ </td>
1248
+ </tr>
1249
+ <tr>
1250
+ <td class="nd_field"><tt>rval *</tt></td>
1251
+ <td class="nd_values"><tt>Expression</tt></td>
1252
+ <td class="nd_default"></td>
1253
+ </tr>
1254
+
1255
+ <tr class="first_field">
1256
+ <td class="nd_class" rowspan="2"><tt>BitAndAssign</tt></td>
1257
+ <td class="nd_field"><tt>lval *</tt></td>
1258
+ <td class="nd_values"><tt>Expression</tt></td>
1259
+ <td class="nd_default"></td>
1260
+ <td class="nd_comments" rowspan="2">
1261
+ </td>
1262
+ </tr>
1263
+ <tr>
1264
+ <td class="nd_field"><tt>rval *</tt></td>
1265
+ <td class="nd_values"><tt>Expression</tt></td>
1266
+ <td class="nd_default"></td>
1267
+ </tr>
1268
+
1269
+ <tr class="first_field">
1270
+ <td class="nd_class" rowspan="2"><tt>BitXorAssign</tt></td>
1271
+ <td class="nd_field"><tt>lval *</tt></td>
1272
+ <td class="nd_values"><tt>Expression</tt></td>
1273
+ <td class="nd_default"></td>
1274
+ <td class="nd_comments" rowspan="2">
1275
+ </td>
1276
+ </tr>
1277
+ <tr>
1278
+ <td class="nd_field"><tt>rval *</tt></td>
1279
+ <td class="nd_values"><tt>Expression</tt></td>
1280
+ <td class="nd_default"></td>
1281
+ </tr>
1282
+
1283
+ <tr class="first_field">
1284
+ <td class="nd_class" rowspan="2"><tt>BitOrAssign</tt></td>
1285
+ <td class="nd_field"><tt>lval *</tt></td>
1286
+ <td class="nd_values"><tt>Expression</tt></td>
1287
+ <td class="nd_default"></td>
1288
+ <td class="nd_comments" rowspan="2">
1289
+ </td>
1290
+ </tr>
1291
+ <tr>
1292
+ <td class="nd_field"><tt>rval *</tt></td>
1293
+ <td class="nd_values"><tt>Expression</tt></td>
1294
+ <td class="nd_default"></td>
1295
+ </tr>
1296
+
1297
+ <tr class="first_field">
1298
+ <td class="nd_class" rowspan="1"><tt>StringLiteral</tt></td>
1299
+ <td class="nd_field"><tt>val</tt></td>
1300
+ <td class="nd_values"><tt>String</tt></td>
1301
+ <td class="nd_default"></td>
1302
+ <td class="nd_comments" rowspan="1">
1303
+ The <tt>String</tt> in <tt>val</tt> is the literal string entered. <tt>"\n"</tt>
1304
+ isn't converted to a newline, for instance.
1305
+ </td>
1306
+ </tr>
1307
+
1308
+ <tr class="first_field">
1309
+ <td class="nd_class" rowspan="1"><tt>CharLiteral</tt></td>
1310
+ <td class="nd_field"><tt>val</tt></td>
1311
+ <td class="nd_values"><tt>String</tt></td>
1312
+ <td class="nd_default"></td>
1313
+ <td class="nd_comments" rowspan="1">
1314
+ The <tt>String</tt> in <tt>val</tt> is the literal string entered. <tt>'\n'</tt>
1315
+ isn't converted to a newline, for instance.
1316
+ </td>
1317
+ </tr>
1318
+
1319
+ <tr class="first_field">
1320
+ <td class="nd_class" rowspan="2"><tt>CompoundLiteral</tt></td>
1321
+ <td class="nd_field"><tt>type *</tt></td>
1322
+ <td class="nd_values"><tt>Type</tt></td>
1323
+ <td class="nd_default"></td>
1324
+ <td class="nd_comments" rowspan="2">
1325
+ <p>Here's an example:</p>
1326
+ <pre>(struct S){1, .x = 2, .y [3] .z = 4}</pre>
1327
+ <p>parses as:</p>
1328
+ <pre>CompoundLiteral
1329
+ type: Struct
1330
+ name: "S"
1331
+ member_inits:
1332
+ - MemberInit
1333
+ init: IntLiteral
1334
+ val: 1
1335
+ - MemberInit
1336
+ member:
1337
+ - Member
1338
+ name: "x"
1339
+ init: IntLiteral
1340
+ val: 2
1341
+ - MemberInit
1342
+ member:
1343
+ - Member
1344
+ name: "y"
1345
+ - IntLiteral
1346
+ val: 3
1347
+ - Member
1348
+ name: "z"
1349
+ init: IntLiteral
1350
+ val: 4</pre>
1351
+ </td>
1352
+ </tr>
1353
+ <tr>
1354
+ <td class="nd_field"><tt>member_inits *</tt></td>
1355
+ <td class="nd_values"><tt>NodeList</tt> of <tt>MemberInit</tt></td>
1356
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
1357
+ </tr>
1358
+
1359
+ <tr class="first_field">
1360
+ <td class="nd_class" rowspan="3"><tt>IntLiteral</tt></td>
1361
+ <td class="nd_field"><tt>format</tt></td>
1362
+ <td class="nd_values"><tt>:dec</tt>, <tt>:hex</tt>, <tt>:oct</tt></td>
1363
+ <td class="nd_default"><tt>:dec</tt></td>
1364
+ <td class="nd_comments" rowspan="3">
1365
+ <p>Also:</p>
1366
+ <ul>
1367
+ <li><tt>#dec?</tt> -- return true iff <tt>format == :dec</tt></li>
1368
+ <li><tt>#hex?</tt> -- return true iff <tt>format == :hex</tt></li>
1369
+ <li><tt>#oct?</tt> -- return true iff <tt>format == :oct</tt></li>
1370
+ </ul>
1371
+ </td>
1372
+ </tr>
1373
+ <tr>
1374
+ <td class="nd_field"><tt>val</tt></td>
1375
+ <td class="nd_values"><tt>Integer</tt></td>
1376
+ <td class="nd_default"></td>
1377
+ </tr>
1378
+ <tr>
1379
+ <td class="nd_field"><tt>suffix</tt></td>
1380
+ <td class="nd_values"><tt>String</tt></td>
1381
+ <td class="nd_default"></td>
1382
+ </tr>
1383
+
1384
+ <tr class="first_field">
1385
+ <td class="nd_class" rowspan="4"><tt>FloatLiteral</tt></td>
1386
+ <td class="nd_field"><tt>format</tt></td>
1387
+ <td class="nd_values"><tt>:dec</tt>, <tt>:hex</tt></td>
1388
+ <td class="nd_default"><tt>:dec</tt></td>
1389
+ <td class="nd_comments" rowspan="4">
1390
+ </td>
1391
+ </tr>
1392
+ <tr>
1393
+ <td class="nd_field"><tt>val</tt></td>
1394
+ <td class="nd_values"><tt>Float</tt></td>
1395
+ <td class="nd_default"></td>
1396
+ </tr>
1397
+ <tr>
1398
+ <td class="nd_field"><tt>exponent</tt></td>
1399
+ <td class="nd_values"><tt>Integer</tt></td>
1400
+ <td class="nd_default"></td>
1401
+ </tr>
1402
+ <tr>
1403
+ <td class="nd_field"><tt>suffix</tt></td>
1404
+ <td class="nd_values"><tt>String</tt></td>
1405
+ <td class="nd_default"></td>
1406
+ </tr>
1407
+
1408
+ <tr class="first_field">
1409
+ <td class="nd_class" rowspan="4"><tt>Pointer</tt></td>
1410
+ <td class="nd_field"><tt>const?</tt></td>
1411
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1412
+ <td class="nd_default"></td>
1413
+ <td class="nd_comments" rowspan="4">
1414
+ </td>
1415
+ </tr>
1416
+ <tr>
1417
+ <td class="nd_field"><tt>restrict?</tt></td>
1418
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1419
+ <td class="nd_default"></td>
1420
+ </tr>
1421
+ <tr>
1422
+ <td class="nd_field"><tt>volatile?</tt></td>
1423
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1424
+ <td class="nd_default"></td>
1425
+ </tr>
1426
+ <tr>
1427
+ <td class="nd_field"><tt>type *</tt></td>
1428
+ <td class="nd_values"><tt>Type</tt></td>
1429
+ <td class="nd_default"></td>
1430
+ </tr>
1431
+
1432
+ <tr class="first_field">
1433
+ <td class="nd_class" rowspan="5"><tt>Array</tt></td>
1434
+ <td class="nd_field"><tt>const?</tt></td>
1435
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1436
+ <td class="nd_default"></td>
1437
+ <td class="nd_comments" rowspan="5">
1438
+ </td>
1439
+ </tr>
1440
+ <tr>
1441
+ <td class="nd_field"><tt>restrict?</tt></td>
1442
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1443
+ <td class="nd_default"></td>
1444
+ </tr>
1445
+ <tr>
1446
+ <td class="nd_field"><tt>volatile?</tt></td>
1447
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1448
+ <td class="nd_default"></td>
1449
+ </tr>
1450
+ <tr>
1451
+ <td class="nd_field"><tt>type *</tt></td>
1452
+ <td class="nd_values"><tt>Type</tt></td>
1453
+ <td class="nd_default"></td>
1454
+ </tr>
1455
+ <tr>
1456
+ <td class="nd_field"><tt>length *</tt></td>
1457
+ <td class="nd_values"><tt>Expression</tt></td>
1458
+ <td class="nd_default"></td>
1459
+ </tr>
1460
+
1461
+ <tr class="first_field">
1462
+ <td class="nd_class" rowspan="6"><tt>Function</tt></td>
1463
+ <td class="nd_field"><tt>const?</tt></td>
1464
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1465
+ <td class="nd_default"></td>
1466
+ <td class="nd_comments" rowspan="6">
1467
+ </td>
1468
+ </tr>
1469
+ <tr>
1470
+ <td class="nd_field"><tt>restrict?</tt></td>
1471
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1472
+ <td class="nd_default"></td>
1473
+ </tr>
1474
+ <tr>
1475
+ <td class="nd_field"><tt>volatile?</tt></td>
1476
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1477
+ <td class="nd_default"></td>
1478
+ </tr>
1479
+ <tr>
1480
+ <td class="nd_field"><tt>type *</tt></td>
1481
+ <td class="nd_values"><tt>Type</tt></td>
1482
+ <td class="nd_default"></td>
1483
+ </tr>
1484
+ <tr>
1485
+ <td class="nd_field"><tt>params *</tt></td>
1486
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Parameter</tt></td>
1487
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
1488
+ </tr>
1489
+ <tr>
1490
+ <td class="nd_field"><tt>var_args?</tt></td>
1491
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1492
+ <td class="nd_default"></td>
1493
+ </tr>
1494
+
1495
+ <tr class="first_field">
1496
+ <td class="nd_class" rowspan="5"><tt>Struct</tt></td>
1497
+ <td class="nd_field"><tt>const?</tt></td>
1498
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1499
+ <td class="nd_default"></td>
1500
+ <td class="nd_comments" rowspan="5">
1501
+ </td>
1502
+ </tr>
1503
+ <tr>
1504
+ <td class="nd_field"><tt>restrict?</tt></td>
1505
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1506
+ <td class="nd_default"></td>
1507
+ </tr>
1508
+ <tr>
1509
+ <td class="nd_field"><tt>volatile?</tt></td>
1510
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1511
+ <td class="nd_default"></td>
1512
+ </tr>
1513
+ <tr>
1514
+ <td class="nd_field"><tt>name</tt></td>
1515
+ <td class="nd_values"><tt>String</tt></td>
1516
+ <td class="nd_default"></td>
1517
+ </tr>
1518
+ <tr>
1519
+ <td class="nd_field"><tt>members *</tt></td>
1520
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Member</tt></td>
1521
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
1522
+ </tr>
1523
+
1524
+ <tr class="first_field">
1525
+ <td class="nd_class" rowspan="5"><tt>Union</tt></td>
1526
+ <td class="nd_field"><tt>const?</tt></td>
1527
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1528
+ <td class="nd_default"></td>
1529
+ <td class="nd_comments" rowspan="5">
1530
+ </td>
1531
+ </tr>
1532
+ <tr>
1533
+ <td class="nd_field"><tt>restrict?</tt></td>
1534
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1535
+ <td class="nd_default"></td>
1536
+ </tr>
1537
+ <tr>
1538
+ <td class="nd_field"><tt>volatile?</tt></td>
1539
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1540
+ <td class="nd_default"></td>
1541
+ </tr>
1542
+ <tr>
1543
+ <td class="nd_field"><tt>name</tt></td>
1544
+ <td class="nd_values"><tt>String</tt></td>
1545
+ <td class="nd_default"></td>
1546
+ </tr>
1547
+ <tr>
1548
+ <td class="nd_field"><tt>members *</tt></td>
1549
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Member</tt></td>
1550
+ <td class="nd_default"><tt>NodeArray[]</tt></td>
1551
+ </tr>
1552
+
1553
+ <tr class="first_field">
1554
+ <td class="nd_class" rowspan="5"><tt>Enum</tt></td>
1555
+ <td class="nd_field"><tt>const?</tt></td>
1556
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1557
+ <td class="nd_default"></td>
1558
+ <td class="nd_comments" rowspan="5">
1559
+ </td>
1560
+ </tr>
1561
+ <tr>
1562
+ <td class="nd_field"><tt>restrict?</tt></td>
1563
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1564
+ <td class="nd_default"></td>
1565
+ </tr>
1566
+ <tr>
1567
+ <td class="nd_field"><tt>volatile?</tt></td>
1568
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1569
+ <td class="nd_default"></td>
1570
+ </tr>
1571
+ <tr>
1572
+ <td class="nd_field"><tt>name</tt></td>
1573
+ <td class="nd_values"><tt>String</tt></td>
1574
+ <td class="nd_default"></td>
1575
+ </tr>
1576
+ <tr>
1577
+ <td class="nd_field"><tt>members *</tt></td>
1578
+ <td class="nd_values"><tt>NodeList</tt> of <tt>Enumerator</tt></td>
1579
+ <td class="nd_default"></td>
1580
+ </tr>
1581
+
1582
+ <tr class="first_field">
1583
+ <td class="nd_class" rowspan="4"><tt>CustomType</tt></td>
1584
+ <td class="nd_field"><tt>const?</tt></td>
1585
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1586
+ <td class="nd_default"></td>
1587
+ <td class="nd_comments" rowspan="4">
1588
+ For <tt>typedef</tt>'d names.
1589
+ </td>
1590
+ </tr>
1591
+ <tr>
1592
+ <td class="nd_field"><tt>restrict?</tt></td>
1593
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1594
+ <td class="nd_default"></td>
1595
+ </tr>
1596
+ <tr>
1597
+ <td class="nd_field"><tt>volatile?</tt></td>
1598
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1599
+ <td class="nd_default"></td>
1600
+ </tr>
1601
+ <tr>
1602
+ <td class="nd_field"><tt>name</tt></td>
1603
+ <td class="nd_values"><tt>String</tt></td>
1604
+ <td class="nd_default"></td>
1605
+ </tr>
1606
+
1607
+ <tr class="first_field">
1608
+ <td class="nd_class" rowspan="3"><tt>Void</tt></td>
1609
+ <td class="nd_field"><tt>const?</tt></td>
1610
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1611
+ <td class="nd_default"></td>
1612
+ <td class="nd_comments" rowspan="3">
1613
+ <tt>const</tt> is for things like <tt>const void *</tt>.
1614
+ </td>
1615
+ </tr>
1616
+ <tr>
1617
+ <td class="nd_field"><tt>restrict?</tt></td>
1618
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1619
+ <td class="nd_default"></td>
1620
+ </tr>
1621
+ <tr>
1622
+ <td class="nd_field"><tt>volatile?</tt></td>
1623
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1624
+ <td class="nd_default"></td>
1625
+ </tr>
1626
+
1627
+ <tr class="first_field">
1628
+ <td class="nd_class" rowspan="5"><tt>Int</tt></td>
1629
+ <td class="nd_field"><tt>const?</tt></td>
1630
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1631
+ <td class="nd_default"></td>
1632
+ <td class="nd_comments" rowspan="5">
1633
+ Also:
1634
+ <ul>
1635
+ <li><tt>#short?</tt> -- return true iff <tt>longness == -1</tt></li>
1636
+ <li><tt>#plain?</tt> -- return true iff <tt>longness == 0</tt></li>
1637
+ <li><tt>#long?</tt> -- return true iff <tt>longness == 1</tt></li>
1638
+ <li><tt>#long_long?</tt> -- return true iff <tt>longness == 2</tt></li>
1639
+ <li><tt>#signed?</tt> -- same as <tt>!unsigned?</tt></li>
1640
+ <li><tt>#signed=(val)</tt> -- same as <tt>unsigned = !val</tt></li>
1641
+ </ul>
1642
+ </td>
1643
+ </tr>
1644
+ <tr>
1645
+ <td class="nd_field"><tt>restrict?</tt></td>
1646
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1647
+ <td class="nd_default"></td>
1648
+ </tr>
1649
+ <tr>
1650
+ <td class="nd_field"><tt>volatile?</tt></td>
1651
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1652
+ <td class="nd_default"></td>
1653
+ </tr>
1654
+ <tr>
1655
+ <td class="nd_field"><tt>longness</tt></td>
1656
+ <td class="nd_values"><tt>-1</tt>, <tt>0</tt>, <tt>1</tt>, <tt>2</tt></td>
1657
+ <td class="nd_default"><tt>0</tt></td>
1658
+ </tr>
1659
+ <tr>
1660
+ <td class="nd_field"><tt>unsigned?</tt></td>
1661
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1662
+ <td class="nd_default"></td>
1663
+ </tr>
1664
+
1665
+ <tr class="first_field">
1666
+ <td class="nd_class" rowspan="4"><tt>Float</tt></td>
1667
+ <td class="nd_field"><tt>const?</tt></td>
1668
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1669
+ <td class="nd_default"></td>
1670
+ <td class="nd_comments" rowspan="4">
1671
+ Also:
1672
+ <ul>
1673
+ <li><tt>#plain?</tt> -- return true iff <tt>longness == 0</tt></li>
1674
+ <li><tt>#double?</tt> -- return true iff <tt>longness == 1</tt></li>
1675
+ <li><tt>#long_double?</tt> -- return true iff <tt>longness == 2</tt></li>
1676
+ </ul>
1677
+ </td>
1678
+ </tr>
1679
+ <tr>
1680
+ <td class="nd_field"><tt>restrict?</tt></td>
1681
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1682
+ <td class="nd_default"></td>
1683
+ </tr>
1684
+ <tr>
1685
+ <td class="nd_field"><tt>volatile?</tt></td>
1686
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1687
+ <td class="nd_default"></td>
1688
+ </tr>
1689
+ <tr>
1690
+ <td class="nd_field"><tt>longness</tt></td>
1691
+ <td class="nd_values"><tt>0</tt>, <tt>1</tt>, <tt>2</tt></td>
1692
+ <td class="nd_default"><tt>0</tt></td>
1693
+ </tr>
1694
+
1695
+ <tr class="first_field">
1696
+ <td class="nd_class" rowspan="4"><tt>Char</tt></td>
1697
+ <td class="nd_field"><tt>const?</tt></td>
1698
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1699
+ <td class="nd_default"></td>
1700
+ <td class="nd_comments" rowspan="4">
1701
+ Also:
1702
+ <ul>
1703
+ <li><tt>#signed?</tt> -- return true iff <tt>signed == true</tt></li>
1704
+ <li><tt>#unsigned?</tt> -- return true iff <tt>signed == false</tt></li>
1705
+ <li><tt>#plain?</tt> -- return true iff <tt>signed == nil</tt></li>
1706
+ </ul>
1707
+ Yes, C99 says that <tt>char</tt>, <tt>signed char</tt>, and
1708
+ <tt>unsigned char</tt> are 3 distinct types (unlike with
1709
+ <tt>int</tt> -- go figure). Like Martian chalk and Venusian
1710
+ cheese: completely different, but you can fit 'em each in one
1711
+ byte.
1712
+ </td>
1713
+ </tr>
1714
+ <tr>
1715
+ <td class="nd_field"><tt>restrict?</tt></td>
1716
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1717
+ <td class="nd_default"></td>
1718
+ </tr>
1719
+ <tr>
1720
+ <td class="nd_field"><tt>volatile?</tt></td>
1721
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1722
+ <td class="nd_default"></td>
1723
+ </tr>
1724
+ <tr>
1725
+ <td class="nd_field"><tt>signed</tt></td>
1726
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt>, <tt>nil</tt></td>
1727
+ <td class="nd_default"></td>
1728
+ </tr>
1729
+
1730
+ <tr class="first_field">
1731
+ <td class="nd_class" rowspan="3"><tt>Bool</tt></td>
1732
+ <td class="nd_field"><tt>const?</tt></td>
1733
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1734
+ <td class="nd_default"></td>
1735
+ <td class="nd_comments" rowspan="3">
1736
+ This is the rarely seen <tt>_Bool</tt> type.
1737
+ </td>
1738
+ </tr>
1739
+ <tr>
1740
+ <td class="nd_field"><tt>restrict?</tt></td>
1741
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1742
+ <td class="nd_default"></td>
1743
+ </tr>
1744
+ <tr>
1745
+ <td class="nd_field"><tt>volatile?</tt></td>
1746
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1747
+ <td class="nd_default"></td>
1748
+ </tr>
1749
+
1750
+ <tr class="first_field">
1751
+ <td class="nd_class" rowspan="4"><tt>Complex</tt></td>
1752
+ <td class="nd_field"><tt>const?</tt></td>
1753
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1754
+ <td class="nd_default"></td>
1755
+ <td class="nd_comments" rowspan="4">
1756
+ <p>This is the rarely seen <tt>_Complex</tt> type.</p>
1757
+ <ul>
1758
+ <li><tt>#plain?</tt> -- return true iff <tt>longness == 0</tt></li>
1759
+ <li><tt>#double?</tt> -- return true iff <tt>longness == 1</tt></li>
1760
+ <li><tt>#long_double?</tt> -- return true iff <tt>longness == 2</tt></li>
1761
+ </ul>
1762
+ </td>
1763
+ </tr>
1764
+ <tr>
1765
+ <td class="nd_field"><tt>restrict?</tt></td>
1766
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1767
+ <td class="nd_default"></td>
1768
+ </tr>
1769
+ <tr>
1770
+ <td class="nd_field"><tt>volatile?</tt></td>
1771
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1772
+ <td class="nd_default"></td>
1773
+ </tr>
1774
+ <tr>
1775
+ <td class="nd_field"><tt>longness</tt></td>
1776
+ <td class="nd_values"><tt>0</tt>, <tt>1</tt>, <tt>2</tt></td>
1777
+ <td class="nd_default"><tt>0</tt></td>
1778
+ </tr>
1779
+
1780
+ <tr class="first_field">
1781
+ <td class="nd_class" rowspan="4"><tt>Imaginary</tt></td>
1782
+ <td class="nd_field"><tt>const?</tt></td>
1783
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1784
+ <td class="nd_default"></td>
1785
+ <td class="nd_comments" rowspan="4">
1786
+ <p>This is the rarely seen <tt>_Imaginary</tt> type.</p>
1787
+ <ul>
1788
+ <li><tt>#plain?</tt> -- return true iff <tt>longness == 0</tt></li>
1789
+ <li><tt>#double?</tt> -- return true iff <tt>longness == 1</tt></li>
1790
+ <li><tt>#long_double?</tt> -- return true iff <tt>longness == 2</tt></li>
1791
+ </ul>
1792
+ </td>
1793
+ </tr>
1794
+ <tr>
1795
+ <td class="nd_field"><tt>restrict?</tt></td>
1796
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1797
+ <td class="nd_default"></td>
1798
+ </tr>
1799
+ <tr>
1800
+ <td class="nd_field"><tt>volatile?</tt></td>
1801
+ <td class="nd_values"><tt>true</tt>, <tt>false</tt></td>
1802
+ <td class="nd_default"></td>
1803
+ </tr>
1804
+ <tr>
1805
+ <td class="nd_field"><tt>longness</tt></td>
1806
+ <td class="nd_values"><tt>0</tt>, <tt>1</tt>, <tt>2</tt></td>
1807
+ <td class="nd_default"><tt>0</tt></td>
1808
+ </tr>
1809
+ <tr class="first_field">
1810
+ <td class="nd_class" rowspan="1"><tt>BlockExpression</tt></td>
1811
+ <td class="nd_field"><tt>block *</tt></td>
1812
+ <td class="nd_values"><tt>Block</tt></td>
1813
+ <td class="nd_default"><tt>Block.new</tt></td>
1814
+ <td class="nd_comments" rowspan="1">
1815
+ Only if the <tt>block_expressions</tt> extension is enabled.
1816
+ See "Extensions" section below.
1817
+ </td>
1818
+ </tr>
1819
+ </tbody></table>
1820
+
1821
+ ## Parser
1822
+
1823
+ `C.parse` will use the default parser (`C.default_parser`), but you
1824
+ can also manage your own parser(s) if you need finer control over
1825
+ state. Parser state consists of:
1826
+
1827
+ * `type_names`: a Set of Strings. As a parser eats `typedef`s, this
1828
+ grows.
1829
+ * `pos`: the `Node::Pos` this parser will start parsing at.
1830
+
1831
+ A `Node::Pos` has three read-write attributes: `filename`, `line_num`,
1832
+ `col_num`. Default is nil, 1, 0.
1833
+
1834
+ Note that the type names the parser has seen affects the parser! For
1835
+ example, consider:
1836
+
1837
+ a * b;
1838
+
1839
+ * If only `a` is a type, this is a declaration.
1840
+ * If neither `a` nor `b` are types, this is a multiplication
1841
+ statement.
1842
+ * Otherwise, it's a syntax error.
1843
+
1844
+ You may append type names implicitly, by parsing `typedef`s, or
1845
+ explicitly like this:
1846
+
1847
+ parser.type_names << 'Thing' << 'OtherThing'
1848
+
1849
+ ### Parsing Snippets
1850
+
1851
+ `C.parse` will parse the toplevel C construct, a `C::TranslationUnit`,
1852
+ but you can also parse other snippets of C:
1853
+
1854
+ C::Statement.parse('while (not_looking) { paint_car(); }')
1855
+ C::Type.parse('void *(*)(int *(*)[][2], ...)')
1856
+
1857
+ This works for both concrete and abstract `Node` subclasses. A
1858
+ `Parser` may be given as an optional second argument.
1859
+
1860
+ ### Extensions to C99
1861
+
1862
+ * `Type`s are allowed as function arguments. This is needed to parse
1863
+ C99 macros like `va_arg()`.
1864
+ * `Block`s in parentheses are allowed as expressions ([a gcc
1865
+ extension][gcc-block-expressions]). You need to call
1866
+ `parser.enable_block_expressions` first. They appear as
1867
+ `BlockExpression` nodes.
1868
+
1869
+ [gcc-block-expressions]: http://gcc.gnu.org/onlinedocs/gcc-4.2.1/gcc/Statement-Exprs.html#Statement-Exprs
1870
+
1871
+ ## Parsing Full Programs
1872
+
1873
+ This can be tricky for a number of reasons. Here are the issues you'll
1874
+ likely encounter.
1875
+
1876
+ ### Preprocessing
1877
+
1878
+ Directives that start with `#` are not handled by the `Parser`, as
1879
+ they're external to the C grammar. CAST ships with a `Preprocessor`,
1880
+ which wraps the preprocessor used to build your Ruby interpreter.
1881
+
1882
+ cpp = C::Preprocessor.new
1883
+ cpp.include_path << '/usr/include' << /usr/local/include'
1884
+ cpp.macros['DEBUG'] = '1'
1885
+ cpp.macros['max(a, b)'] = '((a) > (b) ? (a) : (b))'
1886
+ cpp.preprocess(code)
1887
+
1888
+ Note however, that preprocessors tend to leave vendor-specific
1889
+ extensions in their output. GNU `cpp`, for example, leaves
1890
+ "linemarkers" (lines that begin with `#`) in the output which you'll
1891
+ need to filter out manually before feeding it to a `Parser`.
1892
+
1893
+ ### Built-in types
1894
+
1895
+ Mac OS 10.5's system `cpp` for instance assumes the compiler will
1896
+ recognize types such as `__darwin_va_list`.
1897
+
1898
+ ### Syntactic Extensions
1899
+
1900
+ Some code may take advantage of compiler-specific extensions to the
1901
+ syntax. For example, `gcc` supports inline assembly via directives
1902
+ like:
1903
+
1904
+ asm("movl %1, %%eax;
1905
+ "movl %%eax, %0;"
1906
+ :"=r"(y)
1907
+ :"r"(x)
1908
+ :"%eax");
1909
+
1910
+ Such code is fairly rare, so there is no direct support in CAST for
1911
+ this. You'll need to manually massage such constructs out of the
1912
+ `Parser` input. Or send me patches. Delicious patches.
1913
+
1914
+ ## Contributing
1915
+
1916
+ * [Bug reports](http://github.com/oggy/cast/issues)
1917
+ * [Source](http://github.com/oggy/cast)
1918
+ * Patches: Fork on Github, send pull request.
1919
+ * Include tests where practical.
1920
+ * Leave the version alone, or bump it in a separate commit.
1921
+
1922
+ ## Copyright
1923
+
1924
+ Copyright (c) George Ogata. See LICENSE for details.