output: Add null sentinel automatically to parse_enum() arguments.
[pspp] / src / output / ascii.c
1 /* PSPP - a program for statistical analysis.
2    Copyright (C) 1997-9, 2000, 2007, 2009, 2010, 2011, 2012, 2013, 2014 Free Software Foundation, Inc.
3
4    This program is free software: you can redistribute it and/or modify
5    it under the terms of the GNU General Public License as published by
6    the Free Software Foundation, either version 3 of the License, or
7    (at your option) any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU General Public License for more details.
13
14    You should have received a copy of the GNU General Public License
15    along with this program.  If not, see <http://www.gnu.org/licenses/>. */
16
17 #include <config.h>
18
19 #include <ctype.h>
20 #include <errno.h>
21 #include <limits.h>
22 #include <signal.h>
23 #include <stdint.h>
24 #include <stdlib.h>
25 #include <unilbrk.h>
26 #include <unistd.h>
27 #include <unistr.h>
28 #include <uniwidth.h>
29
30 #ifdef HAVE_TERMIOS_H
31 # include <sys/ioctl.h>
32 # include <termios.h>
33 #endif
34
35 #include "data/file-name.h"
36 #include "data/file-handle-def.h"
37 #include "data/settings.h"
38 #include "libpspp/assertion.h"
39 #include "libpspp/cast.h"
40 #include "libpspp/compiler.h"
41 #include "libpspp/message.h"
42 #include "libpspp/start-date.h"
43 #include "libpspp/string-map.h"
44 #include "libpspp/u8-line.h"
45 #include "libpspp/version.h"
46 #include "output/ascii.h"
47 #include "output/cairo-chart.h"
48 #include "output/chart-provider.h"
49 #include "output/driver-provider.h"
50 #include "output/options.h"
51 #include "output/pivot-output.h"
52 #include "output/pivot-table.h"
53 #include "output/render.h"
54 #include "output/output-item.h"
55
56 #include "gl/minmax.h"
57 #include "gl/xalloc.h"
58 #include "gl/xsize.h"
59
60 #include "gettext.h"
61 #define _(msgid) gettext (msgid)
62
63 /* This file uses TABLE_HORZ and TABLE_VERT enough to warrant abbreviating. */
64 #define H TABLE_HORZ
65 #define V TABLE_VERT
66
67 enum
68   {
69     ASCII_LINE_NONE,
70     ASCII_LINE_DASHED,
71     ASCII_LINE_SINGLE,
72     ASCII_LINE_DOUBLE,
73     ASCII_N_LINES
74   };
75
76 struct box_chars
77   {
78     ucs4_t c[ASCII_N_LINES][ASCII_N_LINES][ASCII_N_LINES][ASCII_N_LINES];
79   };
80
81 static const struct box_chars *
82 get_ascii_box (void)
83 {
84   enum {
85     _ = ASCII_LINE_NONE,
86     d = ASCII_LINE_DASHED,
87     S = ASCII_LINE_SINGLE,
88     D = ASCII_LINE_DOUBLE,
89   };
90
91   static const struct box_chars ascii_box =
92     {
93       /* r  b  l   t:  _    d    S    D */
94       .c[_][_][_] = { ' ', '|', '|', '#', },
95       .c[_][_][d] = { '-', '+', '+', '#', },
96       .c[_][_][S] = { '-', '+', '+', '#', },
97       .c[_][_][D] = { '=', '#', '#', '#', },
98       .c[_][d][_] = { '|', '|', '|', '#', },
99       .c[_][d][d] = { '+', '+', '+', '#', },
100       .c[_][d][S] = { '+', '+', '+', '#', },
101       .c[_][d][D] = { '#', '#', '#', '#', },
102       .c[_][S][_] = { '|', '|', '|', '#', },
103       .c[_][S][d] = { '+', '+', '+', '#', },
104       .c[_][S][S] = { '+', '+', '+', '#', },
105       .c[_][S][D] = { '#', '#', '#', '#', },
106       .c[_][D][_] = { '#', '#', '#', '#', },
107       .c[_][D][d] = { '#', '#', '#', '#', },
108       .c[_][D][S] = { '#', '#', '#', '#', },
109       .c[_][D][D] = { '#', '#', '#', '#', },
110       .c[d][_][_] = { '-', '+', '+', '#', },
111       .c[d][_][d] = { '-', '+', '+', '#', },
112       .c[d][_][S] = { '-', '+', '+', '#', },
113       .c[d][_][D] = { '#', '#', '#', '#', },
114       .c[d][d][_] = { '+', '+', '+', '#', },
115       .c[d][d][d] = { '+', '+', '+', '#', },
116       .c[d][d][S] = { '+', '+', '+', '#', },
117       .c[d][d][D] = { '#', '#', '#', '#', },
118       .c[d][S][_] = { '+', '+', '+', '#', },
119       .c[d][S][d] = { '+', '+', '+', '#', },
120       .c[d][S][S] = { '+', '+', '+', '#', },
121       .c[d][S][D] = { '#', '#', '#', '#', },
122       .c[d][D][_] = { '#', '#', '#', '#', },
123       .c[d][D][d] = { '#', '#', '#', '#', },
124       .c[d][D][S] = { '#', '#', '#', '#', },
125       .c[d][D][D] = { '#', '#', '#', '#', },
126       .c[S][_][_] = { '-', '+', '+', '#', },
127       .c[S][_][d] = { '-', '+', '+', '#', },
128       .c[S][_][S] = { '-', '+', '+', '#', },
129       .c[S][_][D] = { '#', '#', '#', '#', },
130       .c[S][d][_] = { '+', '+', '+', '#', },
131       .c[S][d][d] = { '+', '+', '+', '#', },
132       .c[S][d][S] = { '+', '+', '+', '#', },
133       .c[S][d][D] = { '#', '#', '#', '#', },
134       .c[S][S][_] = { '+', '+', '+', '#', },
135       .c[S][S][d] = { '+', '+', '+', '#', },
136       .c[S][S][S] = { '+', '+', '+', '#', },
137       .c[S][S][D] = { '#', '#', '#', '#', },
138       .c[S][D][_] = { '#', '#', '#', '#', },
139       .c[S][D][d] = { '#', '#', '#', '#', },
140       .c[S][D][S] = { '#', '#', '#', '#', },
141       .c[S][D][D] = { '#', '#', '#', '#', },
142       .c[D][_][_] = { '=', '#', '#', '#', },
143       .c[D][_][d] = { '#', '#', '#', '#', },
144       .c[D][_][S] = { '#', '#', '#', '#', },
145       .c[D][_][D] = { '=', '#', '#', '#', },
146       .c[D][d][_] = { '#', '#', '#', '#', },
147       .c[D][d][d] = { '#', '#', '#', '#', },
148       .c[D][d][S] = { '#', '#', '#', '#', },
149       .c[D][d][D] = { '#', '#', '#', '#', },
150       .c[D][S][_] = { '#', '#', '#', '#', },
151       .c[D][S][d] = { '#', '#', '#', '#', },
152       .c[D][S][S] = { '#', '#', '#', '#', },
153       .c[D][S][D] = { '#', '#', '#', '#', },
154       .c[D][D][_] = { '#', '#', '#', '#', },
155       .c[D][D][d] = { '#', '#', '#', '#', },
156       .c[D][D][S] = { '#', '#', '#', '#', },
157       .c[D][D][D] = { '#', '#', '#', '#', },
158     };
159   return &ascii_box;
160 }
161
162 static const struct box_chars *
163 get_unicode_box (void)
164 {
165   enum {
166     _ = ASCII_LINE_NONE,
167     d = ASCII_LINE_DASHED,
168     S = ASCII_LINE_SINGLE,
169     D = ASCII_LINE_DOUBLE,
170   };
171
172   static const struct box_chars unicode_box =
173     {
174       /* r  b  l   t:   _       d       S       D */
175       .c[_][_][_] = { 0x0020, 0x2575, 0x2575, 0x2551, }, /*  ╵╵║ */
176       .c[_][_][d] = { 0x254c, 0x256f, 0x256f, 0x255c, }, /* ╴╯╯╜ */
177       .c[_][_][S] = { 0x2574, 0x256f, 0x256f, 0x255c, }, /* ╴╯╯╜ */
178       .c[_][_][D] = { 0x2550, 0x255b, 0x255b, 0x255d, }, /* ═╛╛╝ */
179       .c[_][S][_] = { 0x2577, 0x2502, 0x2502, 0x2551, }, /* ╷││║ */
180       .c[_][S][d] = { 0x256e, 0x2524, 0x2524, 0x2562, }, /* ╮┤┤╢ */
181       .c[_][S][S] = { 0x256e, 0x2524, 0x2524, 0x2562, }, /* ╮┤┤╢ */
182       .c[_][S][D] = { 0x2555, 0x2561, 0x2561, 0x2563, }, /* ╕╡╡╣ */
183       .c[_][d][_] = { 0x2577, 0x250a, 0x2502, 0x2551, }, /* ╷┊│║ */
184       .c[_][d][d] = { 0x256e, 0x2524, 0x2524, 0x2562, }, /* ╮┤┤╢ */
185       .c[_][d][S] = { 0x256e, 0x2524, 0x2524, 0x2562, }, /* ╮┤┤╢ */
186       .c[_][d][D] = { 0x2555, 0x2561, 0x2561, 0x2563, }, /* ╕╡╡╣ */
187       .c[_][D][_] = { 0x2551, 0x2551, 0x2551, 0x2551, }, /* ║║║║ */
188       .c[_][D][d] = { 0x2556, 0x2562, 0x2562, 0x2562, }, /* ╖╢╢╢ */
189       .c[_][D][S] = { 0x2556, 0x2562, 0x2562, 0x2562, }, /* ╖╢╢╢ */
190       .c[_][D][D] = { 0x2557, 0x2563, 0x2563, 0x2563, }, /* ╗╣╣╣ */
191       .c[d][_][_] = { 0x254c, 0x2570, 0x2570, 0x2559, }, /* ╶╰╰╙ */
192       .c[d][_][d] = { 0x254c, 0x2534, 0x2534, 0x2568, }, /* ╌┴┴╨ */
193       .c[d][_][S] = { 0x2500, 0x2534, 0x2534, 0x2568, }, /* ─┴┴╨ */
194       .c[d][_][D] = { 0x2550, 0x2567, 0x2567, 0x2569, }, /* ═╧╧╩ */
195       .c[d][d][_] = { 0x256d, 0x251c, 0x251c, 0x255f, }, /* ╭├├╟ */
196       .c[d][d][d] = { 0x252c, 0x002b, 0x253c, 0x256a, }, /* ┬+┼╪ */
197       .c[d][d][S] = { 0x252c, 0x253c, 0x253c, 0x256a, }, /* ┬┼┼╪ */
198       .c[d][d][D] = { 0x2564, 0x256a, 0x256a, 0x256c, }, /* ╤╪╪╬ */
199       .c[d][S][_] = { 0x256d, 0x251c, 0x251c, 0x255f, }, /* ╭├├╟ */
200       .c[d][S][d] = { 0x252c, 0x253c, 0x253c, 0x256a, }, /* ┬┼┼╪ */
201       .c[d][S][S] = { 0x252c, 0x253c, 0x253c, 0x256a, }, /* ┬┼┼╪ */
202       .c[d][S][D] = { 0x2564, 0x256a, 0x256a, 0x256c, }, /* ╤╪╪╬ */
203       .c[d][D][_] = { 0x2553, 0x255f, 0x255f, 0x255f, }, /* ╓╟╟╟ */
204       .c[d][D][d] = { 0x2565, 0x256b, 0x256b, 0x256b, }, /* ╥╫╫╫ */
205       .c[d][D][S] = { 0x2565, 0x256b, 0x256b, 0x256b, }, /* ╥╫╫╫ */
206       .c[d][D][D] = { 0x2566, 0x256c, 0x256c, 0x256c, }, /* ╦╬╬╬ */
207       .c[S][_][_] = { 0x2576, 0x2570, 0x2570, 0x2559, }, /* ╶╰╰╙ */
208       .c[S][_][d] = { 0x2500, 0x2534, 0x2534, 0x2568, }, /* ─┴┴╨ */
209       .c[S][_][S] = { 0x2500, 0x2534, 0x2534, 0x2568, }, /* ─┴┴╨ */
210       .c[S][_][D] = { 0x2550, 0x2567, 0x2567, 0x2569, }, /* ═╧╧╩ */
211       .c[S][d][_] = { 0x256d, 0x251c, 0x251c, 0x255f, }, /* ╭├├╟ */
212       .c[S][d][d] = { 0x252c, 0x253c, 0x253c, 0x256a, }, /* ┬┼┼╪ */
213       .c[S][d][S] = { 0x252c, 0x253c, 0x253c, 0x256a, }, /* ┬┼┼╪ */
214       .c[S][d][D] = { 0x2564, 0x256a, 0x256a, 0x256c, }, /* ╤╪╪╬ */
215       .c[S][S][_] = { 0x256d, 0x251c, 0x251c, 0x255f, }, /* ╭├├╟ */
216       .c[S][S][d] = { 0x252c, 0x253c, 0x253c, 0x256a, }, /* ┬┼┼╪ */
217       .c[S][S][S] = { 0x252c, 0x253c, 0x253c, 0x256a, }, /* ┬┼┼╪ */
218       .c[S][S][D] = { 0x2564, 0x256a, 0x256a, 0x256c, }, /* ╤╪╪╬ */
219       .c[S][D][_] = { 0x2553, 0x255f, 0x255f, 0x255f, }, /* ╓╟╟╟ */
220       .c[S][D][d] = { 0x2565, 0x256b, 0x256b, 0x256b, }, /* ╥╫╫╫ */
221       .c[S][D][S] = { 0x2565, 0x256b, 0x256b, 0x256b, }, /* ╥╫╫╫ */
222       .c[S][D][D] = { 0x2566, 0x256c, 0x256c, 0x256c, }, /* ╦╬╬╬ */
223       .c[D][_][_] = { 0x2550, 0x2558, 0x2558, 0x255a, }, /* ═╘╘╚ */
224       .c[D][_][d] = { 0x2550, 0x2567, 0x2567, 0x2569, }, /* ═╧╧╩ */
225       .c[D][_][S] = { 0x2550, 0x2567, 0x2567, 0x2569, }, /* ═╧╧╩ */
226       .c[D][_][D] = { 0x2550, 0x2567, 0x2567, 0x2569, }, /* ═╧╧╩ */
227       .c[D][d][_] = { 0x2552, 0x255e, 0x255e, 0x2560, }, /* ╒╞╞╠ */
228       .c[D][d][d] = { 0x2564, 0x256a, 0x256a, 0x256c, }, /* ╤╪╪╬ */
229       .c[D][d][S] = { 0x2564, 0x256a, 0x256a, 0x256c, }, /* ╤╪╪╬ */
230       .c[D][d][D] = { 0x2564, 0x256a, 0x256a, 0x256c, }, /* ╤╪╪╬ */
231       .c[D][S][_] = { 0x2552, 0x255e, 0x255e, 0x2560, }, /* ╒╞╞╠ */
232       .c[D][S][d] = { 0x2564, 0x256a, 0x256a, 0x256c, }, /* ╤╪╪╬ */
233       .c[D][S][S] = { 0x2564, 0x256a, 0x256a, 0x256c, }, /* ╤╪╪╬ */
234       .c[D][S][D] = { 0x2564, 0x256a, 0x256a, 0x256c, }, /* ╤╪╪╬ */
235       .c[D][D][_] = { 0x2554, 0x2560, 0x2560, 0x2560, }, /* ╔╠╠╠ */
236       .c[D][D][d] = { 0x2560, 0x256c, 0x256c, 0x256c, }, /* ╠╬╬╬ */
237       .c[D][D][S] = { 0x2560, 0x256c, 0x256c, 0x256c, }, /* ╠╬╬╬ */
238       .c[D][D][D] = { 0x2566, 0x256c, 0x256c, 0x256c, }, /* ╦╬╬╬ */
239     };
240   return &unicode_box;
241 }
242
243 static int
244 ascii_line_from_render_line (int render_line)
245 {
246   switch (render_line)
247     {
248     case TABLE_STROKE_NONE:
249       return ASCII_LINE_NONE;
250
251     case TABLE_STROKE_DASHED:
252       return ASCII_LINE_DASHED;
253
254     case TABLE_STROKE_SOLID:
255     case TABLE_STROKE_THICK:
256     case TABLE_STROKE_THIN:
257       return ASCII_LINE_SINGLE;
258
259     case TABLE_STROKE_DOUBLE:
260       return ASCII_LINE_DOUBLE;
261
262     default:
263       return ASCII_LINE_NONE;
264     }
265
266 }
267
268 static ucs4_t
269 box_get (const struct box_chars *box,
270          int left_, int right_, int top_, int bottom_)
271 {
272   bool rtl = render_direction_rtl ();
273   int left = ascii_line_from_render_line (rtl ? right_ : left_);
274   int right = ascii_line_from_render_line (rtl ? left_ : right_);
275   int top = ascii_line_from_render_line (top_);
276   int bottom = ascii_line_from_render_line (bottom_);
277
278   return box->c[right][bottom][left][top];
279 }
280
281 /* How the page width is determined. */
282 enum ascii_width_mode
283   {
284     FIXED_WIDTH,              /* Specified by configuration. */
285     VIEW_WIDTH,               /* From SET WIDTH. */
286     TERMINAL_WIDTH            /* From the terminal's width. */
287   };
288
289 /* ASCII output driver. */
290 struct ascii_driver
291   {
292     struct output_driver driver;
293
294     /* User parameters. */
295     bool emphasis;              /* Enable bold and underline in output? */
296     char *chart_file_name;      /* Name of files used for charts. */
297
298     /* Colours for charts */
299     struct cell_color fg;
300     struct cell_color bg;
301
302     /* How the page width is determined: */
303     enum ascii_width_mode width_mode;
304     int width;                  /* Page width. */
305
306     int min_hbreak;             /* Min cell size to break across pages. */
307
308     const struct box_chars *box; /* Line & box drawing characters. */
309
310     /* Internal state. */
311     struct file_handle *handle;
312     FILE *file;                 /* Output file. */
313     bool error;                 /* Output error? */
314     struct u8_line *lines;      /* Page content. */
315     int allocated_lines;        /* Number of lines allocated. */
316     int n_charts;               /* Number of charts so far. */
317     int n_objects;              /* Number of objects so far. */
318     const struct pivot_table *pt;
319     struct render_params params;
320   };
321
322 static const struct output_driver_class ascii_driver_class;
323
324 static void ascii_submit (struct output_driver *, const struct output_item *);
325
326 static int get_terminal_width (void);
327
328 static bool update_page_size (struct ascii_driver *, bool issue_error);
329 static int parse_page_size (struct driver_option);
330
331 static void ascii_draw_line (void *, int bb[TABLE_N_AXES][2],
332                              const struct table_border_style[TABLE_N_AXES][2]);
333 static void ascii_measure_cell_width (void *, const struct table_cell *,
334                                       int *min, int *max);
335 static int ascii_measure_cell_height (void *, const struct table_cell *,
336                                       int width);
337 static void ascii_draw_cell (void *, const struct table_cell *, int color_idx,
338                              int bb[TABLE_N_AXES][2], int valign_offset,
339                              int spill[TABLE_N_AXES][2],
340                              int clip[TABLE_N_AXES][2]);
341
342 static struct ascii_driver *
343 ascii_driver_cast (struct output_driver *driver)
344 {
345   assert (driver->class == &ascii_driver_class);
346   return UP_CAST (driver, struct ascii_driver, driver);
347 }
348
349 static struct driver_option
350 opt (struct driver_options *options, const char *key, const char *default_value)
351 {
352   return driver_option_get (options, key, default_value);
353 }
354
355 /* Return true iff the terminal appears to be an xterm with
356    UTF-8 capabilities */
357 static bool
358 term_is_utf8_xterm (void)
359 {
360   const char *term = getenv ("TERM");
361   const char *xterm_locale = getenv ("XTERM_LOCAL");
362   return (term && xterm_locale
363           && !strcmp (term, "xterm")
364           && (strcasestr (xterm_locale, "utf8")
365               || strcasestr (xterm_locale, "utf-8")));
366 }
367
368 static struct output_driver *
369 ascii_create (struct file_handle *fh, enum settings_output_devices device_type,
370               struct driver_options *o)
371 {
372   bool append = parse_boolean (opt (o, "append", "false"));
373   FILE *file = fn_open (fh, append ? "a" : "w");
374   if (!file)
375     {
376       msg_error (errno, _("ascii: opening output file `%s'"),
377                  fh_get_file_name (fh));
378       return NULL;
379     }
380
381   int width = parse_page_size (opt (o, "width", "-1"));
382   bool terminal = !strcmp (fh_get_file_name (fh), "-") && isatty (1);
383
384   const char *default_box = (terminal && (!strcmp (locale_charset (), "UTF-8")
385                                           || term_is_utf8_xterm ())
386                              ? "unicode" : "ascii");
387   enum { BOX_ASCII, BOX_UNICODE } box = parse_enum (opt (o, "box", default_box),
388                                                     "ascii", BOX_ASCII,
389                                                     "unicode", BOX_UNICODE);
390
391   static const struct render_ops ascii_render_ops = {
392     .draw_line = ascii_draw_line,
393     .measure_cell_width = ascii_measure_cell_width,
394     .measure_cell_height = ascii_measure_cell_height,
395     .adjust_break = NULL,
396     .draw_cell = ascii_draw_cell,
397   };
398
399   static const int ascii_line_widths[TABLE_N_STROKES] = {
400     [TABLE_STROKE_NONE] = 0,
401     [TABLE_STROKE_SOLID] = 1,
402     [TABLE_STROKE_DASHED] = 1,
403     [TABLE_STROKE_THICK] = 1,
404     [TABLE_STROKE_THIN] = 1,
405     [TABLE_STROKE_DOUBLE] = 1,
406   };
407
408   struct ascii_driver *a = xmalloc (sizeof *a);
409   *a = (struct ascii_driver) {
410     .driver = {
411       .class = &ascii_driver_class,
412       .name = xstrdup (fh_get_file_name (fh)),
413       .device_type = device_type
414     },
415
416     .emphasis = parse_boolean (opt (o, "emphasis", "false")),
417     .chart_file_name = parse_chart_file_name (opt (o, "charts",
418                                                    fh_get_file_name (fh))),
419
420     .fg = parse_color (opt (o, "foreground-color", "#000000000000")),
421     .bg = parse_color (opt (o, "background-color", "#FFFFFFFFFFFF")),
422
423     .width_mode = (width > 0 ? FIXED_WIDTH
424                    : terminal ? TERMINAL_WIDTH
425                    : VIEW_WIDTH),
426     .width = width,
427
428     .min_hbreak = parse_int (opt (o, "min-hbreak", "-1"), -1, INT_MAX),
429
430     .box = box == BOX_ASCII ? get_ascii_box () : get_unicode_box (),
431
432     .handle = fh,
433     .file = file,
434
435     .params = (struct render_params) {
436       .ops = &ascii_render_ops,
437       .aux = a,
438       .size = { [H] = a->width, [V] = INT_MAX },
439       .font_size = { [H] = 1, [V] = 1 },
440       .line_widths = ascii_line_widths,
441       .rtl = render_direction_rtl (),
442       .printing = true,
443     },
444   };
445
446   if (!update_page_size (a, true))
447     goto error;
448
449   return &a->driver;
450
451 error:
452   output_driver_destroy (&a->driver);
453   return NULL;
454 }
455
456 static int
457 parse_page_size (struct driver_option option)
458 {
459   int dim = atol (option.default_value);
460
461   if (option.value != NULL)
462     {
463       if (!strcmp (option.value, "auto"))
464         dim = -1;
465       else
466         {
467           int value;
468           char *tail;
469
470           errno = 0;
471           value = strtol (option.value, &tail, 0);
472           if (value >= 1 && errno != ERANGE && *tail == '\0')
473             dim = value;
474           else
475             msg (MW, _("%s: %s must be positive integer or `auto'"),
476                    option.driver_name, option.name);
477         }
478     }
479
480   return dim;
481 }
482
483 /* Re-calculates the page width based on settings, margins, and, if "auto" is
484    set, the size of the user's terminal window or GUI output window. */
485 static bool
486 update_page_size (struct ascii_driver *a, bool issue_error)
487 {
488   enum { MIN_WIDTH = 6 };
489
490   int want_width = (a->width_mode == VIEW_WIDTH ? settings_get_viewwidth ()
491                     : a->width_mode == TERMINAL_WIDTH ? get_terminal_width ()
492                     : a->width);
493   bool ok = want_width >= MIN_WIDTH;
494   if (!ok && issue_error)
495     msg (ME, _("ascii: page must be at least %d characters wide, but "
496                "as configured is only %d characters"),
497          MIN_WIDTH, want_width);
498
499   a->width = ok ? want_width : MIN_WIDTH;
500   a->params.size[H] = a->width;
501   a->params.min_break[H] = a->min_hbreak >= 0 ? a->min_hbreak : a->width / 2;
502
503   return ok;
504 }
505
506 static void
507 ascii_destroy (struct output_driver *driver)
508 {
509   struct ascii_driver *a = ascii_driver_cast (driver);
510   int i;
511
512   if (a->file != NULL)
513     fn_close (a->handle, a->file);
514   fh_unref (a->handle);
515   free (a->chart_file_name);
516   for (i = 0; i < a->allocated_lines; i++)
517     u8_line_destroy (&a->lines[i]);
518   free (a->lines);
519   free (a);
520 }
521
522 static void
523 ascii_flush (struct output_driver *driver)
524 {
525   struct ascii_driver *a = ascii_driver_cast (driver);
526   if (a->file)
527     fflush (a->file);
528 }
529
530 static void
531 ascii_output_lines (struct ascii_driver *a, size_t n_lines)
532 {
533   for (size_t y = 0; y < n_lines; y++)
534     {
535       if (y < a->allocated_lines)
536         {
537           struct u8_line *line = &a->lines[y];
538
539           while (ds_chomp_byte (&line->s, ' '))
540             continue;
541           fwrite (ds_data (&line->s), 1, ds_length (&line->s), a->file);
542           u8_line_clear (&a->lines[y]);
543         }
544       putc ('\n', a->file);
545     }
546 }
547
548 static void
549 ascii_output_table_item (struct ascii_driver *a,
550                          const struct output_item *item)
551 {
552   update_page_size (a, false);
553   a->pt = item->table;
554
555   size_t *layer_indexes;
556   PIVOT_OUTPUT_FOR_EACH_LAYER (layer_indexes, item->table, true)
557     {
558       struct render_pager *p = render_pager_create (&a->params, item->table,
559                                                     layer_indexes);
560       for (int i = 0; render_pager_has_next (p); i++)
561         {
562           if (a->n_objects++)
563             putc ('\n', a->file);
564
565           ascii_output_lines (a, render_pager_draw_next (p, INT_MAX));
566         }
567       render_pager_destroy (p);
568     }
569
570   a->pt = NULL;
571 }
572
573 static void
574 ascii_output_table_item_unref (struct ascii_driver *a,
575                                struct output_item *table_item)
576 {
577   ascii_output_table_item (a, table_item);
578   output_item_unref (table_item);
579 }
580
581 static void
582 ascii_submit (struct output_driver *driver, const struct output_item *item)
583 {
584   struct ascii_driver *a = ascii_driver_cast (driver);
585   if (a->error)
586     return;
587
588   switch (item->type)
589     {
590     case OUTPUT_ITEM_TABLE:
591       ascii_output_table_item (a, item);
592       break;
593
594     case OUTPUT_ITEM_IMAGE:
595       if (a->chart_file_name != NULL)
596         {
597           char *file_name = xr_write_png_image (
598             item->image, a->chart_file_name, ++a->n_charts);
599           if (file_name != NULL)
600             {
601               struct output_item *text_item = text_item_create_nocopy (
602                 TEXT_ITEM_LOG,
603                 xasprintf (_("See %s for an image."), file_name),
604                 NULL);
605
606               ascii_submit (driver, text_item);
607               output_item_unref (text_item);
608               free (file_name);
609             }
610         }
611       break;
612
613     case OUTPUT_ITEM_CHART:
614       if (a->chart_file_name != NULL)
615         {
616           char *file_name = xr_draw_png_chart (
617             item->chart, a->chart_file_name, ++a->n_charts, &a->fg, &a->bg);
618           if (file_name != NULL)
619             {
620               struct output_item *text_item = text_item_create_nocopy (
621                 TEXT_ITEM_LOG,
622                 xasprintf (_("See %s for a chart."), file_name),
623                 NULL);
624
625               ascii_submit (driver, text_item);
626               output_item_unref (text_item);
627               free (file_name);
628             }
629         }
630       break;
631
632     case OUTPUT_ITEM_TEXT:
633       if (item->text.subtype != TEXT_ITEM_PAGE_TITLE)
634         ascii_output_table_item_unref (
635           a, text_item_to_table_item (output_item_ref (item)));
636       break;
637
638     case OUTPUT_ITEM_MESSAGE:
639       ascii_output_table_item_unref (
640         a, text_item_to_table_item (
641           message_item_to_text_item (
642             output_item_ref (item))));
643       break;
644
645     case OUTPUT_ITEM_GROUP:
646       break;
647
648     case OUTPUT_ITEM_PAGE_BREAK:
649       break;
650     }
651 }
652
653 const struct output_driver_factory txt_driver_factory =
654   { "txt", "-", ascii_create };
655 const struct output_driver_factory list_driver_factory =
656   { "list", "-", ascii_create };
657
658 static const struct output_driver_class ascii_driver_class =
659   {
660     .name = "text",
661     .destroy = ascii_destroy,
662     .submit = ascii_submit,
663     .flush = ascii_flush,
664   };
665 \f
666 static char *ascii_reserve (struct ascii_driver *, int y, int x0, int x1,
667                             int n);
668 static void ascii_layout_cell (struct ascii_driver *,
669                                const struct table_cell *,
670                                int bb[TABLE_N_AXES][2],
671                                int clip[TABLE_N_AXES][2],
672                                int *width, int *height);
673
674 static void
675 ascii_draw_line (void *a_, int bb[TABLE_N_AXES][2],
676                  const struct table_border_style styles[TABLE_N_AXES][2])
677 {
678   struct ascii_driver *a = a_;
679   char mbchar[6];
680   int x0, y0, x1, y1;
681   ucs4_t uc;
682   int mblen;
683   int x, y;
684
685   /* Clip to the page. */
686   x0 = MAX (bb[H][0], 0);
687   y0 = MAX (bb[V][0], 0);
688   x1 = MIN (bb[H][1], a->width);
689   y1 = bb[V][1];
690   if (x1 <= 0 || y1 <= 0 || x0 >= a->width)
691     return;
692
693   /* Draw. */
694   enum table_stroke v0 = styles[V][0].stroke;
695   enum table_stroke v1 = styles[V][1].stroke;
696   enum table_stroke h0 = styles[H][0].stroke;
697   enum table_stroke h1 = styles[H][1].stroke;
698   uc = box_get (a->box, v0, v1, h0, h1);
699   mblen = u8_uctomb (CHAR_CAST (uint8_t *, mbchar), uc, 6);
700   for (y = y0; y < y1; y++)
701     {
702       char *p = ascii_reserve (a, y, x0, x1, mblen * (x1 - x0));
703       for (x = x0; x < x1; x++)
704         {
705           memcpy (p, mbchar, mblen);
706           p += mblen;
707         }
708     }
709 }
710
711 static void
712 ascii_measure_cell_width (void *a_, const struct table_cell *cell,
713                           int *min_width, int *max_width)
714 {
715   struct ascii_driver *a = a_;
716   int bb[TABLE_N_AXES][2];
717   int clip[TABLE_N_AXES][2];
718   int h;
719
720   bb[H][0] = 0;
721   bb[H][1] = INT_MAX;
722   bb[V][0] = 0;
723   bb[V][1] = INT_MAX;
724   clip[H][0] = clip[H][1] = clip[V][0] = clip[V][1] = 0;
725   ascii_layout_cell (a, cell, bb, clip, max_width, &h);
726
727   bb[H][1] = 1;
728   ascii_layout_cell (a, cell, bb, clip, min_width, &h);
729 }
730
731 static int
732 ascii_measure_cell_height (void *a_, const struct table_cell *cell, int width)
733 {
734   struct ascii_driver *a = a_;
735   int bb[TABLE_N_AXES][2];
736   int clip[TABLE_N_AXES][2];
737   int w, h;
738
739   bb[H][0] = 0;
740   bb[H][1] = width;
741   bb[V][0] = 0;
742   bb[V][1] = INT_MAX;
743   clip[H][0] = clip[H][1] = clip[V][0] = clip[V][1] = 0;
744   ascii_layout_cell (a, cell, bb, clip, &w, &h);
745   return h;
746 }
747
748 static void
749 ascii_draw_cell (void *a_, const struct table_cell *cell, int color_idx UNUSED,
750                  int bb[TABLE_N_AXES][2], int valign_offset,
751                  int spill[TABLE_N_AXES][2] UNUSED,
752                  int clip[TABLE_N_AXES][2])
753 {
754   struct ascii_driver *a = a_;
755   int w, h;
756
757   bb[V][0] += valign_offset;
758   ascii_layout_cell (a, cell, bb, clip, &w, &h);
759 }
760
761 static char *
762 ascii_reserve (struct ascii_driver *a, int y, int x0, int x1, int n)
763 {
764   if (y >= a->allocated_lines)
765     {
766       size_t new_alloc = MAX (25, a->allocated_lines);
767       while (new_alloc <= y)
768         new_alloc = xtimes (new_alloc, 2);
769       a->lines = xnrealloc (a->lines, new_alloc, sizeof *a->lines);
770       for (size_t i = a->allocated_lines; i < new_alloc; i++)
771         u8_line_init (&a->lines[i]);
772       a->allocated_lines = new_alloc;
773     }
774   return u8_line_reserve (&a->lines[y], x0, x1, n);
775 }
776
777 static void
778 text_draw (struct ascii_driver *a, enum table_halign halign, bool numeric,
779            bool bold, bool underline,
780            int bb[TABLE_N_AXES][2], int clip[TABLE_N_AXES][2],
781            int y, const uint8_t *string, int n, size_t width)
782 {
783   int x0 = MAX (0, clip[H][0]);
784   int y0 = MAX (0, clip[V][0]);
785   int x1 = MIN (a->width, clip[H][1]);
786   int y1 = clip[V][1];
787   int x;
788
789   if (y < y0 || y >= y1)
790     return;
791
792   switch (table_halign_interpret (halign, numeric))
793     {
794     case TABLE_HALIGN_LEFT:
795       x = bb[H][0];
796       break;
797     case TABLE_HALIGN_CENTER:
798       x = (bb[H][0] + bb[H][1] - width + 1) / 2;
799       break;
800     case TABLE_HALIGN_RIGHT:
801     case TABLE_HALIGN_DECIMAL:
802       x = bb[H][1] - width;
803       break;
804     default:
805       NOT_REACHED ();
806     }
807   if (x >= x1)
808     return;
809
810   while (x < x0)
811     {
812       ucs4_t uc;
813       int mblen;
814       int w;
815
816       if (n == 0)
817         return;
818       mblen = u8_mbtouc (&uc, string, n);
819
820       string += mblen;
821       n -= mblen;
822
823       w = uc_width (uc, "UTF-8");
824       if (w > 0)
825         {
826           x += w;
827           width -= w;
828         }
829     }
830   if (n == 0)
831     return;
832
833   if (x + width > x1)
834     {
835       int ofs;
836
837       ofs = width = 0;
838       for (ofs = 0; ofs < n;)
839         {
840           ucs4_t uc;
841           int mblen;
842           int w;
843
844           mblen = u8_mbtouc (&uc, string + ofs, n - ofs);
845
846           w = uc_width (uc, "UTF-8");
847           if (w > 0)
848             {
849               if (width + w > x1 - x)
850                 break;
851               width += w;
852             }
853           ofs += mblen;
854         }
855       n = ofs;
856       if (n == 0)
857         return;
858     }
859
860   if (!a->emphasis || (!bold && !underline))
861     memcpy (ascii_reserve (a, y, x, x + width, n), string, n);
862   else
863     {
864       size_t n_out;
865       size_t ofs;
866       char *out;
867       int mblen;
868
869       /* First figure out how many bytes need to be inserted. */
870       n_out = n;
871       for (ofs = 0; ofs < n; ofs += mblen)
872         {
873           ucs4_t uc;
874           int w;
875
876           mblen = u8_mbtouc (&uc, string + ofs, n - ofs);
877           w = uc_width (uc, "UTF-8");
878
879           if (w > 0)
880             {
881               if (bold)
882                 n_out += 1 + mblen;
883               if (underline)
884                 n_out += 2;
885             }
886         }
887
888       /* Then insert them. */
889       out = ascii_reserve (a, y, x, x + width, n_out);
890       for (ofs = 0; ofs < n; ofs += mblen)
891         {
892           ucs4_t uc;
893           int w;
894
895           mblen = u8_mbtouc (&uc, string + ofs, n - ofs);
896           w = uc_width (uc, "UTF-8");
897
898           if (w > 0)
899             {
900               if (bold)
901                 {
902                   out = mempcpy (out, string + ofs, mblen);
903                   *out++ = '\b';
904                 }
905               if (underline)
906                 {
907                   *out++ = '_';
908                   *out++ = '\b';
909                 }
910             }
911           out = mempcpy (out, string + ofs, mblen);
912         }
913     }
914 }
915
916 static void
917 ascii_layout_cell (struct ascii_driver *a, const struct table_cell *cell,
918                    int bb[TABLE_N_AXES][2], int clip[TABLE_N_AXES][2],
919                    int *widthp, int *heightp)
920 {
921   *widthp = 0;
922   *heightp = 0;
923
924   struct string body = DS_EMPTY_INITIALIZER;
925   bool numeric = pivot_value_format (cell->value, a->pt, &body);
926
927   /* Calculate length; if it's zero, then there's nothing to do. */
928   if (ds_is_empty (&body))
929     {
930       ds_destroy (&body);
931       return;
932     }
933
934   size_t length = ds_length (&body);
935   const uint8_t *text = CHAR_CAST (uint8_t *, ds_cstr (&body));
936
937   char *breaks = xmalloc (length + 1);
938   u8_possible_linebreaks (text, length, "UTF-8", breaks);
939   breaks[length] = (breaks[length - 1] == UC_BREAK_MANDATORY
940                     ? UC_BREAK_PROHIBITED : UC_BREAK_POSSIBLE);
941
942   size_t pos = 0;
943   int bb_width = bb[H][1] - bb[H][0];
944   for (int y = bb[V][0]; y < bb[V][1] && pos < length; y++)
945     {
946       const uint8_t *line = text + pos;
947       const char *b = breaks + pos;
948       size_t n = length - pos;
949
950       size_t last_break_ofs = 0;
951       int last_break_width = 0;
952       int width = 0;
953       size_t graph_ofs;
954       size_t ofs;
955
956       for (ofs = 0; ofs < n;)
957         {
958           ucs4_t uc;
959           int mblen;
960           int w;
961
962           mblen = u8_mbtouc (&uc, line + ofs, n - ofs);
963           if (b[ofs] == UC_BREAK_MANDATORY)
964             break;
965           else if (b[ofs] == UC_BREAK_POSSIBLE)
966             {
967               last_break_ofs = ofs;
968               last_break_width = width;
969             }
970
971           w = uc_width (uc, "UTF-8");
972           if (w > 0)
973             {
974               if (width + w > bb_width)
975                 {
976                   if (isspace (line[ofs]))
977                     break;
978                   else if (last_break_ofs != 0)
979                     {
980                       ofs = last_break_ofs;
981                       width = last_break_width;
982                       break;
983                     }
984                 }
985               width += w;
986             }
987           ofs += mblen;
988         }
989
990       /* Trim any trailing spaces off the end of the text to be drawn. */
991       for (graph_ofs = ofs; graph_ofs > 0; graph_ofs--)
992         if (!isspace (line[graph_ofs - 1]))
993           break;
994       width -= ofs - graph_ofs;
995
996       /* Draw text. */
997       text_draw (a, cell->cell_style->halign, numeric,
998                  cell->font_style->bold,
999                  cell->font_style->underline,
1000                  bb, clip, y, line, graph_ofs, width);
1001
1002       /* If a new-line ended the line, just skip the new-line.  Otherwise, skip
1003          past any spaces past the end of the line (but not past a new-line). */
1004       if (b[ofs] == UC_BREAK_MANDATORY)
1005         ofs++;
1006       else
1007         while (ofs < n && isspace (line[ofs]) && b[ofs] != UC_BREAK_MANDATORY)
1008           ofs++;
1009
1010       if (width > *widthp)
1011         *widthp = width;
1012       ++*heightp;
1013       pos += ofs;
1014     }
1015
1016   free (breaks);
1017   ds_destroy (&body);
1018 }
1019
1020 void
1021 ascii_test_write (struct output_driver *driver,
1022                   const char *s, int x, int y, bool bold, bool underline)
1023 {
1024   struct ascii_driver *a = ascii_driver_cast (driver);
1025   int bb[TABLE_N_AXES][2];
1026   int width, height;
1027
1028   if (!a->file)
1029     return;
1030
1031   struct cell_style cell_style = { .halign = TABLE_HALIGN_LEFT };
1032   struct font_style font_style = {
1033     .bold = bold,
1034     .underline = underline,
1035   };
1036   const struct pivot_value value = {
1037     .text = {
1038       .type = PIVOT_VALUE_TEXT,
1039       .local = CONST_CAST (char *, s),
1040       .c = CONST_CAST (char *, s),
1041       .id = CONST_CAST (char *, s),
1042       .user_provided = true,
1043     },
1044   };
1045   struct table_cell cell = {
1046     .value = &value,
1047     .font_style = &font_style,
1048     .cell_style = &cell_style,
1049   };
1050
1051   bb[TABLE_HORZ][0] = x;
1052   bb[TABLE_HORZ][1] = a->width;
1053   bb[TABLE_VERT][0] = y;
1054   bb[TABLE_VERT][1] = INT_MAX;
1055
1056   struct pivot_table pt = {
1057     .show_values = SETTINGS_VALUE_SHOW_DEFAULT,
1058     .show_variables = SETTINGS_VALUE_SHOW_DEFAULT,
1059   };
1060   a->pt = &pt;
1061   ascii_layout_cell (a, &cell, bb, bb, &width, &height);
1062   a->pt = NULL;
1063 }
1064
1065 void
1066 ascii_test_set_length (struct output_driver *driver, int y, int length)
1067 {
1068   struct ascii_driver *a = ascii_driver_cast (driver);
1069
1070   if (!a->file)
1071     return;
1072
1073   if (y < 0)
1074     return;
1075   u8_line_set_length (&a->lines[y], length);
1076 }
1077
1078 void
1079 ascii_test_flush (struct output_driver *driver)
1080 {
1081   struct ascii_driver *a = ascii_driver_cast (driver);
1082
1083   for (size_t i = a->allocated_lines; i-- > 0;)
1084     if (a->lines[i].width)
1085       {
1086         ascii_output_lines (a, i + 1);
1087         break;
1088       }
1089 }
1090 \f
1091 static sig_atomic_t terminal_changed = true;
1092 static int terminal_width;
1093
1094 #if HAVE_DECL_SIGWINCH
1095 static void
1096 winch_handler (int signum UNUSED)
1097 {
1098   terminal_changed = true;
1099 }
1100 #endif
1101
1102 int
1103 get_terminal_width (void)
1104 {
1105 #if HAVE_DECL_SIGWINCH
1106   static bool setup_signal;
1107   if (!setup_signal)
1108     {
1109       setup_signal = true;
1110
1111       struct sigaction action = { .sa_handler = winch_handler };
1112       sigemptyset (&action.sa_mask);
1113       sigaction (SIGWINCH, &action, NULL);
1114     }
1115 #endif
1116
1117   if (terminal_changed)
1118     {
1119       terminal_changed = false;
1120
1121 #ifdef HAVE_TERMIOS_H
1122       struct winsize ws;
1123       if (!ioctl (0, TIOCGWINSZ, &ws))
1124         terminal_width = ws.ws_col;
1125       else
1126 #endif
1127         {
1128           if (getenv ("COLUMNS"))
1129             terminal_width = atoi (getenv ("COLUMNS"));
1130         }
1131
1132       if (terminal_width <= 0 || terminal_width > 1024)
1133         terminal_width = 79;
1134     }
1135
1136   return terminal_width;
1137 }