variable.h

   1 /* Definitions for using variables in GNU Make.
   2 Copyright (C) 1988, 1989, 1990, 1991, 1992 Free Software Foundation, Inc.
   3 This file is part of GNU Make.
   4
   5 GNU Make is free software; you can redistribute it and/or modify
   6 it under the terms of the GNU General Public License as published by
   7 the Free Software Foundation; either version 2, or (at your option)
   8 any later version.
   9
  10 GNU Make is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU General Public License for more details.
  14
  15 You should have received a copy of the GNU General Public License
  16 along with GNU Make; see the file COPYING.  If not, write to
  17 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18 Boston, MA 02111-1307, USA.  */
  19
  20 /* Codes in a variable definition saying where the definition came from.
  21    Increasing numeric values signify less-overridable definitions.  */
  22 enum variable_origin
  23   {
  24     o_default,          /* Variable from the default set.  */
  25     o_env,              /* Variable from environment.  */
  26     o_file,             /* Variable given in a makefile.  */
  27     o_env_override,     /* Variable from environment, if -e.  */
  28     o_command,          /* Variable given by user.  */
  29     o_override,         /* Variable from an `override' directive.  */
  30     o_automatic,        /* Automatic variable -- cannot be set.  */
  31     o_invalid           /* Core dump time.  */
  32   };
  33
  34 /* Structure that represents one variable definition.
  35    Each bucket of the hash table is a chain of these,
  36    chained through `next'.  */
  37
  38 struct variable
  39   {
  40     struct variable *next;      /* Link in the chain.  */
  41     char *name;                 /* Variable name.  */
  42     char *value;                /* Variable value.  */
  43     enum variable_origin
  44       origin ENUM_BITFIELD (3); /* Variable origin.  */
  45     unsigned int recursive:1;   /* Gets recursively re-evaluated.  */
  46     unsigned int expanding:1;   /* Nonzero if currently being expanded.  */
  47     unsigned int per_target:1;  /* Nonzero if a target-specific variable.  */
  48     enum variable_export
  49       {
  50         v_export,               /* Export this variable.  */
  51         v_noexport,             /* Don't export this variable.  */
  52         v_ifset,                /* Export it if it has a non-default value.  */
  53         v_default               /* Decide in target_environment.  */
  54       } export ENUM_BITFIELD (2);
  55   };
  56
  57 /* Structure that represents a variable set.  */
  58
  59 struct variable_set
  60   {
  61     struct variable **table;    /* Hash table of variables.  */
  62     unsigned int buckets;       /* Number of hash buckets in `table'.  */
  63   };
  64
  65 /* Structure that represents a list of variable sets.  */
  66
  67 struct variable_set_list
  68   {
  69     struct variable_set_list *next;     /* Link in the chain.  */
  70     struct variable_set *set;           /* Variable set.  */
  71   };
  72
  73 extern char *variable_buffer;
  74 extern struct variable_set_list *current_variable_set_list;
  75
  76 /* expand.c */
  77 extern char *variable_buffer_output PARAMS ((char *ptr, char *string, unsigned int length));
  78 extern char *variable_expand PARAMS ((char *line));
  79 extern char *allocated_variable_expand_for_file PARAMS ((char *line, struct file *file));
  80 #define allocated_variable_expand(line) \
  81   allocated_variable_expand_for_file (line, (struct file *) 0)
  82 extern char *expand_argument PARAMS ((char *str, char *end));
  83 extern char *variable_expand_string PARAMS ((char *line, char *string,
  84                                              long length));
  85
  86 /* function.c */
  87 extern int handle_function PARAMS ((char **op, char **stringp));
  88 extern int pattern_matches PARAMS ((char *pattern, char *percent, char *str));
  89 extern char *subst_expand PARAMS ((char *o, char *text, char *subst, char *replace,
  90                 unsigned int slen, unsigned int rlen, int by_word, int suffix_only));
  91 extern char *patsubst_expand PARAMS ((char *o, char *text, char *pattern, char *replace,
  92                 char *pattern_percent, char *replace_percent));
  93
  94 /* expand.c */
  95 extern char *recursively_expand PARAMS ((struct variable *v));
  96
  97 /* variable.c */
  98 extern struct variable_set_list *create_new_variable_set PARAMS ((void));
  99 extern struct variable_set_list *push_new_variable_scope PARAMS ((void));
 100 extern void pop_variable_scope PARAMS ((void));
 101 extern void define_automatic_variables PARAMS ((void));
 102 extern void initialize_file_variables PARAMS ((struct file *file));
 103 extern void print_file_variables PARAMS ((struct file *file));
 104 extern void print_variable_set PARAMS ((struct variable_set *set, char *prefix));
 105 extern void merge_variable_set_lists PARAMS ((struct variable_set_list **setlist0, struct variable_set_list *setlist1));
 106 extern struct variable *try_variable_definition PARAMS ((const struct floc *flocp, char *line, enum variable_origin origin));
 107
 108 extern struct variable *lookup_variable PARAMS ((char *name, unsigned int length));
 109 extern struct variable *define_variable PARAMS ((char *name, unsigned int length, char *value,
 110                 enum variable_origin origin, int recursive));
 111 extern struct variable *define_variable_in_set PARAMS ((char *name, unsigned int length,
 112                 char *value, enum variable_origin origin, int recursive, struct variable_set *set));
 113 extern struct variable *define_variable_for_file PARAMS ((char *name, unsigned int length,
 114                 char *value, enum variable_origin origin, int recursive, struct file *file));
 115 extern char **target_environment PARAMS ((struct file *file));
 116
 117 extern int export_all_variables;