src/data/dataset-reader.c

   1 /* PSPP - a program for statistical analysis.
   2    Copyright (C) 2006, 2010, 2011 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 "data/dataset-reader.h"
  20
  21 #include <stdlib.h>
  22
  23 #include "data/case.h"
  24 #include "data/casereader.h"
  25 #include "data/dataset.h"
  26 #include "data/dictionary.h"
  27 #include "data/file-handle-def.h"
  28 #include "libpspp/assertion.h"
  29 #include "libpspp/message.h"
  30
  31 #include "gl/xalloc.h"
  32
  33 #include "gettext.h"
  34 #define _(msgid) gettext (msgid)
  35
  36 /* Opens FH, which must have referent type FH_REF_DATASET, and returns a
  37    dataset_reader for it, or a null pointer on failure.  Stores a copy of the
  38    dictionary for the dataset file into *DICT.  The caller takes ownership of
  39    the casereader and the dictionary.  */
  40 struct casereader *
  41 dataset_reader_open (struct file_handle *fh, struct dictionary **dict)
  42 {
  43   struct dataset *ds;
  44
  45   /* We don't bother doing fh_lock or fh_ref on the file handle,
  46      as there's no advantage in this case, and doing these would
  47      require us to keep track of the "struct file_handle" and
  48      "struct fh_lock" and undo our work later. */
  49   assert (fh_get_referent (fh) == FH_REF_DATASET);
  50
  51   ds = fh_get_dataset (fh);
  52   if (ds == NULL || !dataset_has_source (ds))
  53     {
  54       msg (SE, _("Cannot read from dataset %s because no dictionary or data "
  55                  "has been written to it yet."),
  56            fh_get_name (fh));
  57       return NULL;
  58     }
  59
  60   *dict = dict_clone (dataset_dict (ds));
  61   return casereader_clone (dataset_source (ds));
  62 }