src/data/value.c

   1 /* PSPP - a program for statistical analysis.
   2    Copyright (C) 1997-9, 2000 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 #include <data/value.h>
  19
  20 #include <data/val-type.h>
  21 #include <libpspp/hash.h>
  22 #include <libpspp/str.h>
  23 #include "variable.h"
  24
  25 #include "xalloc.h"
  26
  27 /* Duplicate a value.
  28    The caller is responsible for freeing the returned value. */
  29 union value *
  30 value_dup (const union value *val, int width)
  31 {
  32   return xmemdup (val, MAX (width, sizeof *val));
  33 }
  34
  35
  36 /* Create a value of specified width.
  37    The caller is responsible for freeing the returned value. */
  38 union value *
  39 value_create (int width)
  40 {
  41   return xnmalloc (value_cnt_from_width (width), sizeof (union value));
  42 }
  43
  44
  45 /* Compares A and B, which both have the given WIDTH, and returns
  46    a strcmp()-type result.
  47    Only the short string portion of longer strings are
  48    compared. */
  49 int
  50 compare_values (const void *a_, const void *b_, const void *var_)
  51 {
  52   const union value *a = a_;
  53   const union value *b = b_;
  54   const struct variable *var = var_;
  55   int width = var_get_width (var);
  56   return (width == 0
  57           ? (a->f < b->f ? -1 : a->f > b->f)
  58           : memcmp (a->s, b->s, MIN (MAX_SHORT_STRING, width)));
  59 }
  60
  61 /* Create a hash of V, which has the given WIDTH.
  62    Only the short string portion of a longer string is hashed. */
  63 unsigned
  64 hash_value (const void *v_, const void *var_)
  65 {
  66   const union value *v = v_;
  67   const struct variable *var = var_;
  68   int width = var_get_width (var);
  69   return (width == 0
  70           ? hsh_hash_double (v->f)
  71           : hsh_hash_bytes (v->s, width));
  72 }
  73
  74
  75 /* Copies SRC to DST, given that they both contain data of the
  76    given WIDTH. */
  77 void
  78 value_copy (union value *dst, const union value *src, int width)
  79 {
  80   if (width == 0)
  81     dst->f = src->f;
  82   else
  83     memcpy (dst->s, src->s, width);
  84 }
  85
  86 /* Sets V to the system-missing value for data of the given
  87    WIDTH. */
  88 void
  89 value_set_missing (union value *v, int width)
  90 {
  91   if (width == 0)
  92     v->f = SYSMIS;
  93   else
  94     memset (v->s, ' ', width);
  95 }
  96
  97 /* Tests whether VALUE may be resized from OLD_WIDTH to
  98    NEW_WIDTH, using the following rules that match those for
  99    resizing missing values and value labels.  First, OLD_WIDTH
 100    and NEW_WIDTH must be both numeric or both string.  Second, if
 101    NEW_WIDTH is less than OLD_WIDTH, then the bytes that would be
 102    trimmed off the right end of VALUE must be all spaces. */
 103 bool
 104 value_is_resizable (const union value *value, int old_width, int new_width)
 105 {
 106   int i;
 107
 108   if (val_type_from_width (old_width) != val_type_from_width (new_width))
 109     return false;
 110   for (i = new_width; i < old_width; i++)
 111     if (value->s[i] != ' ')
 112       return false;
 113   return true;
 114 }
 115
 116 /* Resizes VALUE from OLD_WIDTH to NEW_WIDTH.  The arguments must
 117    satisfy the rules specified above for value_is_resizable. */
 118 void
 119 value_resize (union value *value, int old_width, int new_width)
 120 {
 121   assert (value_is_resizable (value, old_width, new_width));
 122   if (new_width > old_width)
 123     memset (&value->s[old_width], ' ', new_width - old_width);
 124 }