pintos-os.org Git - pspp/blob - src/language/lexer/variable-parser.h

   1 /* PSPP - a program for statistical analysis.
   2    Copyright (C) 1997-9, 2000, 2006, 2007, 2010 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 #ifndef VARIABLE_PARSER_H
  18 #define VARIABLE_PARSER_H 1
  19
  20 #include <stdbool.h>
  21 #include <stddef.h>
  22
  23 struct pool;
  24 struct dictionary;
  25 struct var_set;
  26 struct const_var_set;
  27 struct variable;
  28 struct lexer ;
  29
  30 struct var_set *var_set_create_from_dict (const struct dictionary *d);
  31 struct var_set *var_set_create_from_array (struct variable *const *var,
  32                                            size_t);
  33
  34 size_t var_set_get_n (const struct var_set *vs);
  35
  36 void var_set_destroy (struct var_set *vs);
  37
  38 \f
  39 /* Variable parsers. */
  40
  41 enum
  42   {
  43     PV_NONE = 0,                /* No options. */
  44     PV_SINGLE = 0001,           /* Restrict to a single name or TO use. */
  45     PV_DUPLICATE = 0002,        /* Don't merge duplicates. */
  46     PV_APPEND = 0004,           /* Append to existing list. */
  47     PV_NO_DUPLICATE = 0010,     /* Error on duplicates. */
  48     PV_NUMERIC = 0020,          /* Vars must be numeric. */
  49     PV_STRING = 0040,           /* Vars must be string. */
  50     PV_SAME_TYPE = 00100,       /* All vars must be the same type. */
  51     PV_SAME_WIDTH = 00200,      /* All vars must be the same type and width. */
  52     PV_NO_SCRATCH = 00400       /* Disallow scratch variables. */
  53   };
  54
  55 struct variable *parse_variable (struct lexer *, const struct dictionary *);
  56 bool parse_variables (struct lexer *, const struct dictionary *, struct variable ***, size_t *,
  57                      int opts);
  58 bool parse_variables_pool (struct lexer *, struct pool *, const struct dictionary *,
  59                           struct variable ***, size_t *, int opts);
  60 bool parse_var_set_vars (struct lexer *, const struct var_set *, struct variable ***, size_t *,
  61                         int opts);
  62
  63 char *parse_DATA_LIST_var (struct lexer *, const struct dictionary *);
  64 bool parse_DATA_LIST_vars (struct lexer *, const struct dictionary *,
  65                            char ***names, size_t *cnt, int opts);
  66 bool parse_DATA_LIST_vars_pool (struct lexer *, const struct dictionary *,
  67                                 struct pool *,
  68                                 char ***names, size_t *cnt, int opts);
  69 bool parse_mixed_vars (struct lexer *, const struct dictionary *dict,
  70                        char ***names, size_t *cnt, int opts);
  71 bool parse_mixed_vars_pool (struct lexer *, const struct dictionary *dict,
  72                             struct pool *,
  73                            char ***names, size_t *cnt, int opts);
  74 \f
  75 /* This variable parser supports the unusual situation where set of variables
  76    has to be parsed before the associated dictionary is available.  Thus,
  77    parsing proceeds in two phases: first, the variables are parsed in a vector
  78    of "struct var_syntax"; second, when the dictionary becomes available, the
  79    structs are turned into "struct variable"s. */
  80
  81 struct var_syntax
  82   {
  83     char *first;                /* Always nonnull. */
  84     char *last;                 /* Nonnull for var ranges (e.g. "a TO b"). */
  85   };
  86 void var_syntax_destroy (struct var_syntax *, size_t n);
  87
  88 bool var_syntax_parse (struct lexer *, struct var_syntax **, size_t *);
  89 bool var_syntax_evaluate (const struct var_syntax *, size_t,
  90                           const struct dictionary *,
  91                           struct variable ***, size_t *, int opts);
  92
  93 /* Const wrappers */
  94
  95 static inline const struct variable *
  96 parse_variable_const (struct lexer *l, const struct dictionary *d)
  97 {
  98   return parse_variable (l, d);
  99 }
 100
 101 static inline bool
 102 parse_variables_const (struct lexer *l, const struct dictionary *d,
 103                        const struct variable ***v, size_t *s,
 104                        int opts)
 105 {
 106   return parse_variables (l, d, (struct variable ***) v, s, opts);
 107 }
 108
 109 static inline bool
 110 parse_variables_const_pool (struct lexer *l, struct pool *p,
 111                             const struct dictionary *d,
 112                             const struct variable ***v, size_t *s, int opts)
 113 {
 114   return parse_variables_pool (l, p, d, (struct variable ***) v, s, opts);
 115 }
 116
 117
 118
 119 static inline struct const_var_set *
 120 const_var_set_create_from_dict (const struct dictionary *d)
 121 {
 122   return (struct const_var_set *) var_set_create_from_dict (d);
 123 }
 124
 125 static inline struct const_var_set *
 126 const_var_set_create_from_array (const struct variable *const *var,
 127                                  size_t s)
 128 {
 129   return (struct const_var_set *) var_set_create_from_array ((struct variable *const *) var, s);
 130 }
 131
 132
 133 static inline bool
 134 parse_const_var_set_vars (struct lexer *l, const struct const_var_set *vs,
 135                           const struct variable ***v, size_t *s, int opts)
 136 {
 137   return parse_var_set_vars (l, (const struct var_set *) vs,
 138                              (struct variable ***) v, s, opts);
 139 }
 140
 141 static inline void
 142 const_var_set_destroy (struct const_var_set *vs)
 143 {
 144   var_set_destroy ((struct var_set *) vs);
 145 }
 146
 147 /* Match a variable.
 148    If the match succeeds, the variable will be placed in VAR.
 149    Returns true if successful */
 150 bool
 151 lex_match_variable (struct lexer *lexer, const struct dictionary *dict, const struct variable **var);
 152
 153 struct interaction;
 154
 155 /* Parse an interaction.
 156    If not successful return false.
 157    Otherwise, a newly created interaction will be placed in IACT.
 158    It is the caller's responsibility to destroy this interaction.
 159  */
 160 bool
 161 parse_design_interaction (struct lexer *lexer, const struct dictionary *dict, struct interaction **iact);
 162
 163
 164
 165 #endif /* variable-parser.h */