2 * This file is part of the GROMACS molecular simulation package.
4 * Copyright (c) 1991-2000, University of Groningen, The Netherlands.
5 * Copyright (c) 2001-2004, The GROMACS development team.
6 * Copyright (c) 2013,2014, by the GROMACS development team, led by
7 * Mark Abraham, David van der Spoel, Berk Hess, and Erik Lindahl,
8 * and including many others, as listed in the AUTHORS file in the
9 * top-level source directory and at http://www.gromacs.org.
11 * GROMACS is free software; you can redistribute it and/or
12 * modify it under the terms of the GNU Lesser General Public License
13 * as published by the Free Software Foundation; either version 2.1
14 * of the License, or (at your option) any later version.
16 * GROMACS is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 * Lesser General Public License for more details.
21 * You should have received a copy of the GNU Lesser General Public
22 * License along with GROMACS; if not, see
23 * http://www.gnu.org/licenses, or write to the Free Software Foundation,
24 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
26 * If you want to redistribute modifications to GROMACS, please
27 * consider that scientific software is very special. Version
28 * control is crucial - bugs must be traceable. We will be happy to
29 * consider code for inclusion in the official distribution, but
30 * derived work must not be called official GROMACS. Details are found
31 * in the README & COPYING files - if they are missing, get the
32 * official version at http://www.gromacs.org.
34 * To help us fund GROMACS development, we humbly ask that you cite
35 * the research papers on the package. Check out http://www.gromacs.org.
43 #include "gromacs/legacyheaders/warninp.h"
44 #include "gromacs/utility/basedefinitions.h"
51 int count
; /* sort order for output */
52 gmx_bool bObsolete
; /* whether it is an obsolete param value */
53 gmx_bool bSet
; /* whether it it has been read out */
54 char *name
; /* name of the parameter */
55 char *value
; /* parameter value string */
56 int inp_count
; /* number of einps read. Only valid for the first item
57 in the inpfile list. */
59 /* entry in input files (like .mdp files).
60 Initally read in with read_inpfile, then filled in with missing values
61 through get_eint, get_ereal, etc. */
63 t_inpfile
*read_inpfile(const char *fn
, int *ninp
,
65 /* Create & populate a t_inpfile struct from values in file fn.
67 ninp = the number of read parameters
68 cppopts = the cpp-style options for #include paths and #defines */
70 void write_inpfile(const char *fn
, int ninp
, t_inpfile inp
[],
71 gmx_bool bHaltOnUnknown
,
74 void replace_inp_entry(int ninp
, t_inpfile
*inp
,
75 const char *old_entry
, const char *new_entry
);
77 int search_einp(int ninp
, const t_inpfile
*inp
, const char *name
);
78 /* Return the index of an .mdp field with the given name within the
79 * inp array, if it exists. Return -1 if it does not exist. */
81 int get_eint(int *ninp
, t_inpfile
**inp
, const char *name
, int def
,
84 gmx_int64_t
get_eint64(int *ninp
, t_inpfile
**inp
,
85 const char *name
, gmx_int64_t def
,
88 double get_ereal(int *ninp
, t_inpfile
**inp
, const char *name
, double def
,
91 const char *get_estr(int *ninp
, t_inpfile
**inp
, const char *name
, const char *def
);
93 int get_eeenum(int *ninp
, t_inpfile
**inp
, const char *name
, const char **defs
,
95 /* defs must be NULL terminated */
97 int get_eenum(int *ninp
, t_inpfile
**inp
, const char *name
, const char **defs
);
98 /* defs must be NULL terminated */
100 /* Here are some dirty macros to extract data from the inp structures.
101 * Most macros assume the variables ninp, inp and wi are present.
102 * Elements are removed from the list after reading.
104 #define REM_TYPE(name) replace_inp_entry(ninp, inp, name, NULL)
105 #define REPL_TYPE(old, new) replace_inp_entry(ninp, inp, old, new)
106 #define STYPE(name, var, def) if ((tmp = get_estr(&ninp, &inp, name, def)) != NULL) strcpy(var, tmp)
107 #define STYPENC(name, def) get_estr(&ninp, &inp, name, def)
108 #define ITYPE(name, var, def) var = get_eint(&ninp, &inp, name, def, wi)
109 #define STEPTYPE(name, var, def) var = get_eint64(&ninp, &inp, name, def, wi)
110 #define RTYPE(name, var, def) var = get_ereal(&ninp, &inp, name, def, wi)
111 #define ETYPE(name, var, defs) var = get_eenum(&ninp, &inp, name, defs)
112 #define EETYPE(name, var, defs) var = get_eeenum(&ninp, &inp, name, defs, wi)
113 #define CCTYPE(s) STYPENC("\n; " s, NULL)
114 #define CTYPE(s) STYPENC("; " s, NULL)
115 /* This last one prints a comment line where you can add some explanation */