Page 160	Table of Contents	Index	Page 162
	Chapters
	1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 A, B, C, D, E

---

CHAPTER 17. TABLE FORMATTING

x-spacing specifies the number of units of spacing to be inserted between columns of the table;
the default is the width of a space character in the current text style. y-spacing specifies the
number of units of spacing to be inserted between rows in the table; the default is the default
vertical spacing of the stream. Possible values for these two options option are:

• An integer - a size in the current units to be used for spacing.
  
  
• A string or character - the spacing is the width or height of the string or character in the
  current text style.
  
  
• A function - the spacing is the amount of horizontal or vertical space the function would
  consume when called on the stream.
  
  
• A list - the list is of the form (number unit), where unit is one of :point, :pixel, :mm,
  :character, or :line. When unit is :character, the width of an "M" in the current text
  style is used as the width of one character.

multiple-columns is either nil, t, or an integer. If it is t or an integer, the table rows will
be broken up into a multiple columns. If it is t, CLIM will determine the optimal number of
columns. If it is an integer, it will be interpreted as the desired number of columns. multiple-
columns-x-spacing has the same format as x-spacing. It controls the spacing between the multiple
columns. It defaults to the value of the x-spacing option.

When the boolean equalize-column-widths is true, CLIM will make all of the columns have the
same width (the width of the widest cell in any column in the entire table).

record-type specifies the class of output record to create. The default is standard-table-output-
record. This argument should only be supplied by a programmer if there is a new class of output
record that supports the table formatting protocol.

=> formatting-row (&optional stream &key record-type) &body body [Macro]
Binds the local environment in such a way the output of body will be grouped into a table row.
All of the output performed by body becomes the contents of one row. This must be used inside
of formatting-table, and in conjunction with formatting-cell.

stream is an output recording stream to which output will be done. The stream argument is
not evaluated, and must be a symbol that is bound to a stream. If stream is t (the default),
*standard-output* is used. body may have zero or more declarations as its first forms.

Once a table has had a row added to it via formatting-row, no columns may be added to it.

record-type specifies the class of output record to create. The default is standard-row-output-
record. This argument should only be supplied by a programmer if there is a new class of
output record that supports the row formatting protocol.

=> formatting-column (&optional stream &key record-type) &body body [Macro]
Binds the local environment in such a way the output of body will be grouped into a table column.
All of the output performed by body becomes the contents of one column. This must be used
inside of formatting-table, and in conjunction with formatting-cell.

---

Page 160	Table of Contents	Index	Page 162
	Chapters
	1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 A, B, C, D, E