Changed all the licence notices in all the files.
[pspp-builds.git] / src / repeat.c
1 /* PSPP - computes sample statistics.
2    Copyright (C) 1997-9, 2000 Free Software Foundation, Inc.
3    Written by Ben Pfaff <blp@gnu.org>.
4
5    This program is free software; you can redistribute it and/or
6    modify it under the terms of the GNU General Public License as
7    published by the Free Software Foundation; either version 2 of the
8    License, or (at your option) any later version.
9
10    This program is distributed in the hope that it will be useful, but
11    WITHOUT ANY WARRANTY; without even the implied warranty of
12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13    General Public License for more details.
14
15    You should have received a copy of the GNU General Public License
16    along with this program; if not, write to the Free Software
17    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
18    02110-1301, USA. */
19
20 #include <config.h>
21 #include "repeat.h"
22 #include "error.h"
23 #include <ctype.h>
24 #include <math.h>
25 #include <stdlib.h>
26 #include "alloc.h"
27 #include "command.h"
28 #include "dictionary.h"
29 #include "error.h"
30 #include "getline.h"
31 #include "lexer.h"
32 #include "misc.h"
33 #include "settings.h"
34 #include "str.h"
35 #include "var.h"
36
37 #include "debug-print.h"
38
39 /* Describes one DO REPEAT macro. */
40 struct repeat_entry
41   {
42     int type;                   /* 1=variable names, 0=any other. */
43     char id[LONG_NAME_LEN + 1]; /* Macro identifier. */
44     char **replacement;         /* Macro replacement. */
45     struct repeat_entry *next;
46   };
47
48 /* List of macro identifiers. */
49 static struct repeat_entry *repeat_tab;
50
51 /* Number of substitutions for each macro. */
52 static int count;
53
54 /* List of lines before it's actually assigned to a file. */
55 static struct getl_line_list *line_buf_head;
56 static struct getl_line_list *line_buf_tail;
57
58 static int parse_ids (struct repeat_entry *);
59 static int parse_numbers (struct repeat_entry *);
60 static int parse_strings (struct repeat_entry *);
61 static void clean_up (void);
62 static int internal_cmd_do_repeat (void);
63
64 int
65 cmd_do_repeat (void)
66 {
67   if (internal_cmd_do_repeat ())
68     return CMD_SUCCESS;
69
70   clean_up ();
71   return CMD_FAILURE;
72 }
73
74 /* Garbage collects all the allocated memory that's no longer
75    needed. */
76 static void
77 clean_up (void)
78 {
79   struct repeat_entry *iter, *next;
80   int i;
81
82   iter = repeat_tab;
83   repeat_tab = NULL;
84
85   while (iter)
86     {
87       if (iter->replacement)
88         {
89           for (i = 0; i < count; i++)
90             free (iter->replacement[i]);
91           free (iter->replacement);
92         }
93       next = iter->next;
94       free (iter);
95       iter = next;
96     }
97 }
98
99 /* Allocates & appends another record at the end of the line_buf_tail
100    chain. */
101 static inline void
102 append_record (void)
103 {
104   struct getl_line_list *new = xmalloc (sizeof *new);
105   
106   if (line_buf_head == NULL)
107     line_buf_head = line_buf_tail = new;
108   else
109     line_buf_tail = line_buf_tail->next = new;
110 }
111
112 /* Returns nonzero if KEYWORD appears beginning at CONTEXT. */
113 static int
114 recognize_keyword (const char *context, const char *keyword)
115 {
116   const char *end = context;
117   while (isalpha ((unsigned char) *end))
118     end++;
119   return lex_id_match_len (keyword, strlen (keyword), context, end - context);
120 }
121
122 /* Does the real work of parsing the DO REPEAT command and its nested
123    commands. */
124 static int
125 internal_cmd_do_repeat (void)
126 {
127   /* Name of first DO REPEAT macro. */
128   char first_name[LONG_NAME_LEN + 1];
129
130   /* Current filename. */
131   const char *current_filename = NULL;
132
133   /* 1=Print lines after preprocessing. */
134   int print;
135
136   /* The first step is parsing the DO REPEAT command itself. */
137   count = 0;
138   line_buf_head = NULL;
139   do
140     {
141       struct repeat_entry *e;
142       struct repeat_entry *iter;
143       int result;
144
145       /* Get a stand-in variable name and make sure it's unique. */
146       if (!lex_force_id ())
147         return 0;
148       for (iter = repeat_tab; iter; iter = iter->next)
149         if (!strcmp (iter->id, tokid))
150           {
151             msg (SE, _("Identifier %s is given twice."), tokid);
152             return 0;
153           }
154
155       /* Make a new stand-in variable entry and link it into the
156          list. */
157       e = xmalloc (sizeof *e);
158       e->type = 0;
159       e->next = repeat_tab;
160       strcpy (e->id, tokid);
161       repeat_tab = e;
162
163       /* Skip equals sign. */
164       lex_get ();
165       if (!lex_force_match ('='))
166         return 0;
167
168       /* Get the details of the variable's possible values. */
169       
170       if (token == T_ID)
171         result = parse_ids (e);
172       else if (lex_is_number ())
173         result = parse_numbers (e);
174       else if (token == T_STRING)
175         result = parse_strings (e);
176       else
177         {
178           lex_error (NULL);
179           return 0;
180         }
181       if (!result)
182         return 0;
183
184       /* If this is the first variable then it defines how many
185          replacements there must be; otherwise enforce this number of
186          replacements. */
187       if (!count)
188         {
189           count = result;
190           strcpy (first_name, e->id);
191         }
192       else if (count != result)
193         {
194           msg (SE, _("There must be the same number of substitutions "
195                      "for each dummy variable specified.  Since there "
196                      "were %d substitutions for %s, there must be %d "
197                      "for %s as well, but %d were specified."),
198                count, first_name, count, e->id, result);
199           return 0;
200         }
201
202       /* Next! */
203       lex_match ('/');
204     }
205   while (token != '.');
206
207   /* Read all the lines inside the DO REPEAT ... END REPEAT. */
208   {
209     int nest = 1;
210
211     for (;;)
212       {
213         if (!getl_read_line ())
214           msg (FE, _("Unexpected end of file."));
215
216         /* If the current file has changed then record the fact. */
217         {
218           const char *curfn;
219           int curln;
220
221           getl_location (&curfn, &curln);
222           if (current_filename != curfn)
223             {
224               assert (curln > 0 && curfn != NULL);
225             
226               append_record ();
227               line_buf_tail->len = -curln;
228               line_buf_tail->line = xstrdup (curfn);
229               current_filename = curfn;
230             }
231         }
232         
233         /* FIXME?  This code is not strictly correct, however if you
234            have begun a line with DO REPEAT or END REPEAT and it's
235            *not* a command name, then you are obviously *trying* to
236            break this mechanism.  And you will.  Also, the entire
237            command names must appear on a single line--they can't be
238            spread out. */
239         {
240           char *cp = ds_c_str (&getl_buf);
241
242           /* Skip leading indentors and any whitespace. */
243           if (*cp == '+' || *cp == '-' || *cp == '.')
244             cp++;
245           while (isspace ((unsigned char) *cp))
246             cp++;
247
248           /* Find END REPEAT. */
249           if (recognize_keyword (cp, "end"))
250             {
251               while (isalpha ((unsigned char) *cp))
252                 cp++;
253               while (isspace ((unsigned char) *cp))
254                 cp++;
255               if (recognize_keyword (cp, "repeat"))
256                 {
257                   nest--;
258
259                   if (!nest)
260                   {
261                     while (isalpha ((unsigned char) *cp))
262                       cp++;
263                     while (isspace ((unsigned char) *cp))
264                       cp++;
265
266                     print = recognize_keyword (cp, "print");
267                     break;
268                   }
269                 }
270             }
271           else /* Find DO REPEAT. */
272             if (!strncasecmp (cp, "do", 2))
273               {
274                 cp += 2;
275                 while (isspace ((unsigned char) *cp))
276                   cp++;
277                 if (!strncasecmp (cp, "rep", 3))
278                   nest++;
279               }
280         }
281
282         append_record ();
283         line_buf_tail->len = ds_length (&getl_buf);
284         line_buf_tail->line = xmalloc (ds_length (&getl_buf) + 1);
285         memcpy (line_buf_tail->line,
286                 ds_c_str (&getl_buf), ds_length (&getl_buf) + 1);
287       }
288   }
289
290   /* FIXME: For the moment we simply discard the contents of the END
291      REPEAT line.  We should actually check for the PRINT specifier.
292      This can be done easier when we buffer entire commands instead of
293      doing it token by token; see TODO. */
294   lex_discard_line ();  
295   
296   /* Tie up the loose end of the chain. */
297   if (line_buf_head == NULL)
298     {
299       msg (SW, _("No commands in scope."));
300       return 1;
301     }
302   line_buf_tail->next = NULL;
303
304   /* Make new variables. */
305   {
306     struct repeat_entry *iter;
307     for (iter = repeat_tab; iter; iter = iter->next)
308       if (iter->type == 1)
309         {
310           int i;
311           for (i = 0; i < count; i++)
312             {
313               /* Note that if the variable already exists there is no
314                  harm done. */
315               dict_create_var (default_dict, iter->replacement[i], 0);
316             }
317         }
318   }
319
320   /* Create the DO REPEAT virtual input file. */
321   {
322     struct getl_script *script = xmalloc (sizeof *script);
323
324     script->first_line = line_buf_head;
325     script->cur_line = NULL;
326     script->remaining_loops = count;
327     script->loop_index = -1;
328     script->macros = repeat_tab;
329     script->print = print;
330
331     getl_add_DO_REPEAT_file (script);
332   }
333
334   return 1;
335 }
336
337 /* Parses a set of ids for DO REPEAT. */
338 static int
339 parse_ids (struct repeat_entry * e)
340 {
341   int i;
342   int n = 0;
343
344   e->type = 1;
345   e->replacement = NULL;
346
347   do
348     {
349       char **names;
350       int nnames;
351
352       if (!parse_mixed_vars (&names, &nnames, PV_NONE))
353         return 0;
354
355       e->replacement = xrealloc (e->replacement,
356                                  (nnames + n) * sizeof *e->replacement);
357       for (i = 0; i < nnames; i++)
358         {
359           e->replacement[n + i] = xstrdup (names[i]);
360           free (names[i]);
361         }
362       free (names);
363       n += nnames;
364     }
365   while (token != '/' && token != '.');
366
367   return n;
368 }
369
370 /* Stores VALUE into *REPL. */
371 static inline void
372 store_numeric (char **repl, long value)
373 {
374   *repl = xmalloc (INT_DIGITS + 1);
375   sprintf (*repl, "%ld", value);
376 }
377
378 /* Parses a list of numbers for DO REPEAT. */
379 static int
380 parse_numbers (struct repeat_entry *e)
381 {
382   /* First and last numbers for TO, plus the step factor. */
383   long a, b;
384
385   /* Alias to e->replacement. */
386   char **array;
387
388   /* Number of entries in array; maximum number for this allocation
389      size. */
390   int n, m;
391
392   n = m = 0;
393   e->type = 0;
394   e->replacement = array = NULL;
395
396   do
397     {
398       /* Parse A TO B into a, b. */
399       if (!lex_force_int ())
400         return 0;
401       a = lex_integer ();
402
403       lex_get ();
404       if (token == T_TO)
405         {
406           lex_get ();
407           if (!lex_force_int ())
408             return 0;
409           b = lex_integer ();
410
411           lex_get ();
412         }
413       else b = a;
414
415       if (n + (abs (b - a) + 1) > m)
416         {
417           m = n + (abs (b - a) + 1) + 16;
418           e->replacement = array = xrealloc (array,
419                                              m * sizeof *e->replacement);
420         }
421
422       if (a == b)
423         store_numeric (&array[n++], a);
424       else
425         {
426           long iter;
427
428           if (a < b)
429             for (iter = a; iter <= b; iter++)
430               store_numeric (&array[n++], iter);
431           else
432             for (iter = a; iter >= b; iter--)
433               store_numeric (&array[n++], iter);
434         }
435
436       lex_match (',');
437     }
438   while (token != '/' && token != '.');
439   e->replacement = xrealloc (array, n * sizeof *e->replacement);
440
441   return n;
442 }
443
444 /* Parses a list of strings for DO REPEAT. */
445 int
446 parse_strings (struct repeat_entry * e)
447 {
448   char **string;
449   int n, m;
450
451   e->type = 0;
452   string = e->replacement = NULL;
453   n = m = 0;
454
455   do
456     {
457       if (token != T_STRING)
458         {
459           int i;
460           msg (SE, _("String expected."));
461           for (i = 0; i < n; i++)
462             free (string[i]);
463           free (string);
464           return 0;
465         }
466
467       if (n + 1 > m)
468         {
469           m += 16;
470           e->replacement = string = xrealloc (string,
471                                               m * sizeof *e->replacement);
472         }
473       string[n++] = lex_token_representation ();
474       lex_get ();
475
476       lex_match (',');
477     }
478   while (token != '/' && token != '.');
479   e->replacement = xrealloc (string, n * sizeof *e->replacement);
480
481   return n;
482 }
483 \f
484 int
485 cmd_end_repeat (void)
486 {
487   msg (SE, _("No matching DO REPEAT."));
488   return CMD_FAILURE;
489 }
490 \f
491 /* Finds a DO REPEAT macro with name MACRO_NAME and returns the
492    appropriate subsitution if found, or NULL if not. */
493 static char *
494 find_DO_REPEAT_substitution (char *macro_name)
495 {
496   struct getl_script *s;
497             
498   for (s = getl_head; s; s = s->included_from)
499     {
500       struct repeat_entry *e;
501       
502       if (s->first_line == NULL)
503         continue;
504
505       for (e = s->macros; e; e = e->next)
506         if (!strcasecmp (e->id, macro_name))
507           return e->replacement[s->loop_index];
508     }
509   
510   return NULL;
511 }
512
513 /* Makes appropriate DO REPEAT macro substitutions within getl_buf. */
514 void
515 perform_DO_REPEAT_substitutions (void)
516 {
517   /* Are we in an apostrophized string or a quoted string? */
518   int in_apos = 0, in_quote = 0;
519
520   /* Source pointer. */
521   char *cp;
522
523   /* Output buffer, size, pointer. */
524   struct string output;
525
526   /* Terminal dot. */
527   int dot = 0;
528
529   ds_init (&output, ds_capacity (&getl_buf));
530
531   /* Strip trailing whitespace, check for & remove terminal dot. */
532   while (ds_length (&getl_buf) > 0
533          && isspace ((unsigned char) ds_end (&getl_buf)[-1]))
534     ds_truncate (&getl_buf, ds_length (&getl_buf) - 1);
535   if (ds_length (&getl_buf) > 0 && ds_end (&getl_buf)[-1] == get_endcmd() )
536     {
537       dot = 1;
538       ds_truncate (&getl_buf, ds_length (&getl_buf) - 1);
539     }
540   
541   for (cp = ds_c_str (&getl_buf); cp < ds_end (&getl_buf); )
542     {
543       if (*cp == '\'' && !in_quote)
544         in_apos ^= 1;
545       else if (*cp == '"' && !in_apos)
546         in_quote ^= 1;
547       
548       if (in_quote || in_apos || !CHAR_IS_ID1 (*cp))
549         {
550           ds_putc (&output, *cp++);
551           continue;
552         }
553
554       /* Collect an identifier. */
555       {
556         char name[LONG_NAME_LEN + 1];
557         char *start = cp;
558         char *np = name;
559         char *substitution;
560
561         while (CHAR_IS_IDN (*cp) && np < &name[LONG_NAME_LEN])
562           *np++ = *cp++;
563         while (CHAR_IS_IDN (*cp))
564           cp++;
565         *np = 0;
566
567         substitution = find_DO_REPEAT_substitution (name);
568         if (!substitution)
569           {
570             ds_concat (&output, start, cp - start);
571             continue;
572           }
573
574         /* Force output buffer size, copy substitution. */
575         ds_puts (&output, substitution);
576       }
577     }
578   if (dot)
579     ds_putc (&output, get_endcmd() );
580
581   ds_destroy (&getl_buf);
582   getl_buf = output;
583 }