c429c6a120b14f91d3d536804db49e6cc53d009a
[pspp] / src / language / data-io / inpt-pgm.c
1 /* PSPP - a program for statistical analysis.
2    Copyright (C) 1997-9, 2000, 2009, 2010, 2011, 2012, 2013 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 <float.h>
20 #include <stdlib.h>
21
22 #include "data/case.h"
23 #include "data/caseinit.h"
24 #include "data/casereader-provider.h"
25 #include "data/dataset.h"
26 #include "data/dictionary.h"
27 #include "data/session.h"
28 #include "data/transformations.h"
29 #include "data/variable.h"
30 #include "language/command.h"
31 #include "language/data-io/data-reader.h"
32 #include "language/data-io/file-handle.h"
33 #include "language/data-io/inpt-pgm.h"
34 #include "language/expressions/public.h"
35 #include "language/lexer/lexer.h"
36 #include "libpspp/assertion.h"
37 #include "libpspp/compiler.h"
38 #include "libpspp/message.h"
39 #include "libpspp/misc.h"
40 #include "libpspp/str.h"
41
42 #include "gl/xalloc.h"
43
44 #include "gettext.h"
45 #define _(msgid) gettext (msgid)
46
47 /* Indicates how a `union value' should be initialized. */
48 struct input_program_pgm
49   {
50     struct session *session;
51     struct dataset *ds;
52
53     struct trns_chain xforms;
54     size_t idx;
55     bool eof;
56
57     casenumber case_nr;             /* Incremented by END CASE transformation. */
58
59     struct caseinit *init;
60     struct caseproto *proto;
61   };
62
63 static void destroy_input_program (struct input_program_pgm *);
64 static const struct trns_class end_case_trns_class;
65 static const struct trns_class reread_trns_class;
66 static const struct trns_class end_file_trns_class;
67
68 static const struct casereader_class input_program_casereader_class;
69
70 static bool inside_input_program;
71 static bool saw_END_CASE;
72 static bool saw_END_FILE;
73 static bool saw_DATA_LIST;
74
75 /* Returns true if we're parsing the inside of a INPUT
76    PROGRAM...END INPUT PROGRAM construct, false otherwise. */
77 bool
78 in_input_program (void)
79 {
80   return inside_input_program;
81 }
82
83 void
84 data_list_seen (void)
85 {
86   saw_DATA_LIST = true;
87 }
88
89 /* Emits an END CASE transformation for INP. */
90 static void
91 emit_END_CASE (struct dataset *ds)
92 {
93   add_transformation (ds, &end_case_trns_class, xzalloc (sizeof (bool)));
94 }
95
96 int
97 cmd_input_program (struct lexer *lexer, struct dataset *ds)
98 {
99   struct msg_location *location = lex_ofs_location (lexer, 0, 1);
100   if (!lex_match (lexer, T_ENDCMD))
101     {
102       msg_location_destroy (location);
103       return lex_end_of_command (lexer);
104     }
105
106   struct session *session = session_create (dataset_session (ds));
107   struct dataset *inp_ds = dataset_create (session, "INPUT PROGRAM");
108
109   struct input_program_pgm *inp = xmalloc (sizeof *inp);
110   *inp = (struct input_program_pgm) { .session = session, .ds = inp_ds };
111
112   proc_push_transformations (inp->ds);
113   inside_input_program = true;
114   saw_END_CASE = saw_END_FILE = saw_DATA_LIST = false;
115   while (!lex_match_phrase (lexer, "END INPUT PROGRAM"))
116     {
117       enum cmd_result result;
118
119       result = cmd_parse_in_state (lexer, inp->ds, CMD_STATE_INPUT_PROGRAM);
120       if (result == CMD_EOF
121           || result == CMD_FINISH
122           || result == CMD_CASCADING_FAILURE)
123         {
124           proc_pop_transformations (inp->ds, &inp->xforms);
125
126           if (result == CMD_EOF)
127             msg (SE, _("Unexpected end-of-file within %s."), "INPUT PROGRAM");
128           inside_input_program = false;
129           destroy_input_program (inp);
130           msg_location_destroy (location);
131           return result;
132         }
133     }
134   if (!saw_END_CASE)
135     emit_END_CASE (inp->ds);
136   inside_input_program = false;
137   proc_pop_transformations (inp->ds, &inp->xforms);
138
139   struct msg_location *end = lex_ofs_location (lexer, 0, 2);
140   msg_location_merge (&location, end);
141   location->omit_underlines = true;
142   msg_location_destroy (end);
143
144   if (!saw_DATA_LIST && !saw_END_FILE)
145     {
146       msg_at (SE, location, _("Input program does not contain %s or %s."),
147               "DATA LIST", "END FILE");
148       destroy_input_program (inp);
149       msg_location_destroy (location);
150       return CMD_FAILURE;
151     }
152   if (dict_get_next_value_idx (dataset_dict (inp->ds)) == 0)
153     {
154       msg_at (SE, location, _("Input program did not create any variables."));
155       destroy_input_program (inp);
156       msg_location_destroy (location);
157       return CMD_FAILURE;
158     }
159   msg_location_destroy (location);
160
161   /* Figure out how to initialize each input case. */
162   inp->init = caseinit_create ();
163   caseinit_mark_for_init (inp->init, dataset_dict (inp->ds));
164   inp->proto = caseproto_ref (dict_get_proto (dataset_dict (inp->ds)));
165
166   dataset_set_dict (ds, dict_clone (dataset_dict (inp->ds)));
167   dataset_set_source (
168     ds, casereader_create_sequential (NULL, inp->proto, CASENUMBER_MAX,
169                                       &input_program_casereader_class, inp));
170
171   return CMD_SUCCESS;
172 }
173
174 /* Reads and returns one case.
175    Returns the case if successful, null at end of file or if an
176    I/O error occurred. */
177 static struct ccase *
178 input_program_casereader_read (struct casereader *reader UNUSED, void *inp_)
179 {
180   struct input_program_pgm *inp = inp_;
181
182   if (inp->eof || !inp->xforms.n)
183     return NULL;
184
185   struct ccase *c = case_create (inp->proto);
186   caseinit_init_vars (inp->init, c);
187
188   for (size_t i = inp->idx < inp->xforms.n ? inp->idx : 0; ; i++)
189     {
190       if (i >= inp->xforms.n)
191         {
192           i = 0;
193           c = case_unshare (c);
194           caseinit_update_left_vars (inp->init, c);
195           caseinit_init_vars (inp->init, c);
196         }
197
198       const struct transformation *trns = &inp->xforms.xforms[i];
199       switch (trns->class->execute (trns->aux, &c, inp->case_nr))
200         {
201         case TRNS_END_CASE:
202           inp->case_nr++;
203           inp->idx = i;
204           return c;
205
206         case TRNS_ERROR:
207           casereader_force_error (reader);
208           /* Fall through. */
209         case TRNS_END_FILE:
210           inp->eof = true;
211           case_unref (c);
212           return NULL;
213
214         case TRNS_CONTINUE:
215           break;
216
217         default:
218           NOT_REACHED ();
219         }
220     }
221 }
222
223 static void
224 destroy_input_program (struct input_program_pgm *pgm)
225 {
226   if (pgm != NULL)
227     {
228       session_destroy (pgm->session);
229       trns_chain_uninit (&pgm->xforms);
230       caseinit_destroy (pgm->init);
231       caseproto_unref (pgm->proto);
232       free (pgm);
233     }
234 }
235
236 /* Destroys the casereader. */
237 static void
238 input_program_casereader_destroy (struct casereader *reader UNUSED, void *inp_)
239 {
240   struct input_program_pgm *inp = inp_;
241   destroy_input_program (inp);
242 }
243
244 static const struct casereader_class input_program_casereader_class =
245   {
246     input_program_casereader_read,
247     input_program_casereader_destroy,
248     NULL,
249     NULL,
250   };
251 \f
252 int
253 cmd_end_case (struct lexer *lexer UNUSED, struct dataset *ds)
254 {
255   assert (in_input_program ());
256   emit_END_CASE (ds);
257   saw_END_CASE = true;
258   return CMD_SUCCESS;
259 }
260
261 /* Outputs the current case */
262 static enum trns_result
263 end_case_trns_proc (void *resume_, struct ccase **c UNUSED,
264                     casenumber case_nr UNUSED)
265 {
266   bool *resume = resume_;
267   enum trns_result retval = *resume ? TRNS_CONTINUE : TRNS_END_CASE;
268   *resume = !*resume;
269   return retval;
270 }
271
272 static bool
273 end_case_trns_free (void *resume)
274 {
275   free (resume);
276   return true;
277 }
278
279 static const struct trns_class end_case_trns_class = {
280   .name = "END CASE",
281   .execute = end_case_trns_proc,
282   .destroy = end_case_trns_free,
283 };
284
285 /* REREAD transformation. */
286 struct reread_trns
287   {
288     struct dfm_reader *reader;  /* File to move file pointer back on. */
289     struct expression *column;  /* Column to reset file pointer to. */
290   };
291
292 /* Parses REREAD command. */
293 int
294 cmd_reread (struct lexer *lexer, struct dataset *ds)
295 {
296   struct file_handle *fh;       /* File to be re-read. */
297   struct expression *e;         /* Expression for column to set. */
298   struct reread_trns *t;        /* Created transformation. */
299   char *encoding = NULL;
300
301   fh = fh_get_default_handle ();
302   e = NULL;
303   while (lex_token (lexer) != T_ENDCMD)
304     {
305       if (lex_match_id (lexer, "COLUMN"))
306         {
307           lex_match (lexer, T_EQUALS);
308
309           if (e)
310             {
311               lex_sbc_only_once (lexer, "COLUMN");
312               goto error;
313             }
314
315           e = expr_parse (lexer, ds, VAL_NUMERIC);
316           if (!e)
317             goto error;
318         }
319       else if (lex_match_id (lexer, "FILE"))
320         {
321           lex_match (lexer, T_EQUALS);
322           fh_unref (fh);
323           fh = fh_parse (lexer, FH_REF_FILE | FH_REF_INLINE, NULL);
324           if (fh == NULL)
325             goto error;
326         }
327       else if (lex_match_id (lexer, "ENCODING"))
328         {
329           lex_match (lexer, T_EQUALS);
330           if (!lex_force_string (lexer))
331             goto error;
332
333           free (encoding);
334           encoding = ss_xstrdup (lex_tokss (lexer));
335
336           lex_get (lexer);
337         }
338       else
339         {
340           lex_error (lexer, NULL);
341           goto error;
342         }
343     }
344
345   t = xmalloc (sizeof *t);
346   t->reader = dfm_open_reader (fh, lexer, encoding);
347   t->column = e;
348   add_transformation (ds, &reread_trns_class, t);
349
350   fh_unref (fh);
351   free (encoding);
352   return CMD_SUCCESS;
353
354 error:
355   expr_free (e);
356   free (encoding);
357   return CMD_CASCADING_FAILURE;
358 }
359
360 /* Executes a REREAD transformation. */
361 static enum trns_result
362 reread_trns_proc (void *t_, struct ccase **c, casenumber case_num)
363 {
364   struct reread_trns *t = t_;
365
366   if (t->column == NULL)
367     dfm_reread_record (t->reader, 1);
368   else
369     {
370       double column = expr_evaluate_num (t->column, *c, case_num);
371       if (!isfinite (column) || column < 1)
372         {
373           msg (SE, _("REREAD: Column numbers must be positive finite "
374                "numbers.  Column set to 1."));
375           dfm_reread_record (t->reader, 1);
376         }
377       else
378         dfm_reread_record (t->reader, column);
379     }
380   return TRNS_CONTINUE;
381 }
382
383 /* Frees a REREAD transformation.
384    Returns true if successful, false if an I/O error occurred. */
385 static bool
386 reread_trns_free (void *t_)
387 {
388   struct reread_trns *t = t_;
389   expr_free (t->column);
390   dfm_close_reader (t->reader);
391   return true;
392 }
393
394 static const struct trns_class reread_trns_class = {
395   .name = "REREAD",
396   .execute = reread_trns_proc,
397   .destroy = reread_trns_free,
398 };
399
400 /* Parses END FILE command. */
401 int
402 cmd_end_file (struct lexer *lexer UNUSED, struct dataset *ds)
403 {
404   assert (in_input_program ());
405
406   add_transformation (ds, &end_file_trns_class, NULL);
407   saw_END_FILE = true;
408
409   return CMD_SUCCESS;
410 }
411
412 /* Executes an END FILE transformation. */
413 static enum trns_result
414 end_file_trns_proc (void *trns_ UNUSED, struct ccase **c UNUSED,
415                     casenumber case_num UNUSED)
416 {
417   return TRNS_END_FILE;
418 }
419
420 static const struct trns_class end_file_trns_class = {
421   .name = "END FILE",
422   .execute = end_file_trns_proc,
423 };