3 * This source code is part of
7 * GROningen MAchine for Chemical Simulations
9 * Written by David van der Spoel, Erik Lindahl, Berk Hess, and others.
10 * Copyright (c) 1991-2000, University of Groningen, The Netherlands.
11 * Copyright (c) 2001-2009, The GROMACS development team,
12 * check out http://www.gromacs.org for more information.
14 * This program is free software; you can redistribute it and/or
15 * modify it under the terms of the GNU General Public License
16 * as published by the Free Software Foundation; either version 2
17 * of the License, or (at your option) any later version.
19 * If you want to redistribute modifications, please consider that
20 * scientific software is very special. Version control is crucial -
21 * bugs must be traceable. We will be happy to consider code for
22 * inclusion in the official distribution, but derived work must not
23 * be called official GROMACS. Details are found in the README & COPYING
24 * files - if they are missing, get the official version at www.gromacs.org.
26 * To help us fund GROMACS development, we humbly ask that you cite
27 * the papers on the package - you can find them in the top README file.
29 * For more info, check our website at http://www.gromacs.org
32 * \brief Declaration of \c gmx_ana_selvalue_t.
34 * There should be no need to use the data structures in this file directly
35 * unless implementing a custom selection routine.
47 //! Defines the value type of a different selection objects.
50 NO_VALUE
, //!< No value; either an error condition or an boolean parameter.
51 INT_VALUE
, //!< One or more integer values.
52 REAL_VALUE
, //!< One or more real values.
53 STR_VALUE
, //!< One or more string values.
54 POS_VALUE
, //!< One or more position values.
55 GROUP_VALUE
, //!< One group of atoms.
59 * Describes a value of a selection expression or of a selection method
62 * Which field in the union is used depends on the \p type.
64 typedef struct gmx_ana_selvalue_t
66 //! Type of the value.
69 * Number of values in the array pointed by the union.
71 * Note that for position and group values, it is the number of
72 * data structures in the array, not the number of positions or
73 * the number of atoms in the group.
76 //! Pointer to the value.
78 //! Integer value(s) (type \ref INT_VALUE).
80 //! Real value(s) (type \ref REAL_VALUE).
82 //! String value(s) (type \ref STR_VALUE).
84 //! Structure for the position value(s) (type \ref POS_VALUE).
85 struct gmx_ana_pos_t
*p
;
86 //! Group value (type \ref GROUP_VALUE).
87 struct gmx_ana_index_t
*g
;
88 //! Boolean value (only parameters of type \ref NO_VALUE);
90 //! Generic pointer for operations that do not need type information.
94 * Number of elements allocated for the value array.
99 //! Initializes an empty selection value structure.
101 _gmx_selvalue_clear(gmx_ana_selvalue_t
*val
);
102 //! Reserve memory for storing selection values.
104 _gmx_selvalue_reserve(gmx_ana_selvalue_t
*val
, int n
);
105 //! Sets the memory for storing selection values.
107 _gmx_selvalue_setstore(gmx_ana_selvalue_t
*val
, void *ptr
);
108 //! Sets the memory for storing selection values and marks it for automatic freeing.
110 _gmx_selvalue_setstore_alloc(gmx_ana_selvalue_t
*val
, void *ptr
, int nalloc
);