Back to index

tetex-bin  3.0
variable.h
Go to the documentation of this file.
00001 /* variable.h: Declare variable expander.
00002 
00003 Copyright (C) 1993, 95 Karl Berry.
00004 
00005 This library is free software; you can redistribute it and/or
00006 modify it under the terms of the GNU Library General Public
00007 License as published by the Free Software Foundation; either
00008 version 2 of the License, or (at your option) any later version.
00009 
00010 This library is distributed in the hope that it will be useful,
00011 but WITHOUT ANY WARRANTY; without even the implied warranty of
00012 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00013 Library General Public License for more details.
00014 
00015 You should have received a copy of the GNU Library General Public
00016 License along with this library; if not, write to the Free Software
00017 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
00018 
00019 #ifndef KPATHSEA_VARIABLE_H
00020 #define KPATHSEA_VARIABLE_H
00021 
00022 #include <kpathsea/c-proto.h>
00023 #include <kpathsea/types.h>
00024 
00025 
00026 /* Return the (variable-expanded) environment variable value or config
00027    file value, or NULL.  */
00028 extern KPSEDLL string kpse_var_value P1H(const_string var);
00029 
00030 /* Expand $VAR and ${VAR} references in SRC, returning the (always newly
00031    dynamically-allocated) result.  An unterminated ${ or any other
00032    character following $ produce error messages, and that part of SRC is
00033    ignored.  In the $VAR form, the variable name consists of consecutive
00034    letters, digits, and underscores.  In the ${VAR} form, the variable
00035    name consists of whatever is between the braces.
00036    
00037    In any case, ``expansion'' means calling `getenv'; if the variable is not
00038    set, look in texmf.cnf files for a definition.  If not set there, either,
00039    the expansion is the empty string (no error).  */
00040 extern KPSEDLL string kpse_var_expand P1H(const_string src);
00041 
00042 #endif /* not KPATHSEA_VARIABLE_H */