pintos-os.org Git - pspp/blob - src/output/table-item.c

   1 /* PSPP - a program for statistical analysis.
   2    Copyright (C) 2009, 2011, 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 "output/table-provider.h"
  20
  21 #include <assert.h>
  22
  23 #include "libpspp/assertion.h"
  24 #include "libpspp/cast.h"
  25 #include "output/driver.h"
  26 #include "output/output-item-provider.h"
  27 #include "output/table-item.h"
  28
  29 #include "gl/xalloc.h"
  30
  31 /* Initializes ITEM as a table item for rendering TABLE.  The new table item
  32    initially has the specified TITLE and CAPTION, which may each be NULL.  The
  33    caller retains ownership of TITLE and CAPTION. */
  34 struct table_item *
  35 table_item_create (struct table *table, const char *title, const char *caption)
  36 {
  37   struct table_item *item = xmalloc (sizeof *item);
  38   output_item_init (&item->output_item, &table_item_class);
  39   item->table = table;
  40   item->title = title != NULL ? xstrdup (title) : NULL;
  41   item->caption = caption != NULL ? xstrdup (caption) : NULL;
  42   return item;
  43 }
  44
  45 /* Returns the table contained by TABLE_ITEM.  The caller must not modify or
  46    unref the returned table. */
  47 const struct table *
  48 table_item_get_table (const struct table_item *table_item)
  49 {
  50   return table_item->table;
  51 }
  52
  53 /* Returns ITEM's title, which is a null pointer if no title has been
  54    set. */
  55 const char *
  56 table_item_get_title (const struct table_item *item)
  57 {
  58   return item->title;
  59 }
  60
  61 /* Sets ITEM's title to TITLE, replacing any previous title.  Specify NULL for
  62    TITLE to clear any title from ITEM.  The caller retains ownership of TITLE.
  63
  64    This function may only be used on a table_item that is unshared. */
  65 void
  66 table_item_set_title (struct table_item *item, const char *title)
  67 {
  68   assert (!table_item_is_shared (item));
  69   free (item->title);
  70   item->title = title != NULL ? xstrdup (title) : NULL;
  71 }
  72
  73 /* Returns ITEM's caption, which is a null pointer if no caption has been
  74    set. */
  75 const char *
  76 table_item_get_caption (const struct table_item *item)
  77 {
  78   return item->caption;
  79 }
  80
  81 /* Sets ITEM's caption to CAPTION, replacing any previous caption.  Specify
  82    NULL for CAPTION to clear any caption from ITEM.  The caller retains
  83    ownership of CAPTION.
  84
  85    This function may only be used on a table_item that is unshared. */
  86 void
  87 table_item_set_caption (struct table_item *item, const char *caption)
  88 {
  89   assert (!table_item_is_shared (item));
  90   free (item->caption);
  91   item->caption = caption != NULL ? xstrdup (caption) : NULL;
  92 }
  93
  94 /* Submits TABLE_ITEM to the configured output drivers, and transfers ownership
  95    to the output subsystem. */
  96 void
  97 table_item_submit (struct table_item *table_item)
  98 {
  99   output_submit (&table_item->output_item);
 100 }
 101 \f
 102 static void
 103 table_item_destroy (struct output_item *output_item)
 104 {
 105   struct table_item *item = to_table_item (output_item);
 106   free (item->title);
 107   free (item->caption);
 108   table_unref (item->table);
 109   free (item);
 110 }
 111
 112 const struct output_item_class table_item_class =
 113   {
 114     table_item_destroy,
 115   };