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
33 * Declares gmx::SelectionOptionStorage.
35 * \author Teemu Murtola <teemu.murtola@cbr.su.se>
36 * \ingroup module_selection
38 #ifndef GMX_SELECTION_SELECTIONOPTIONSTORAGE_H
39 #define GMX_SELECTION_SELECTIONOPTIONSTORAGE_H
41 #include "../options/optionstoragetemplate.h"
42 #include "selection.h"
43 #include "selectionenums.h"
44 #include "selectionoptioninfo.h"
49 class SelectionOption
;
50 class SelectionOptionManager
;
53 * Converts, validates, and stores selection values.
55 * \ingroup module_selection
57 class SelectionOptionStorage
: public OptionStorageTemplate
<Selection
>
61 * Initializes the storage from option settings.
63 * \param[in] settings Storage settings.
65 SelectionOptionStorage(const SelectionOption
&settings
);
67 virtual OptionInfo
&optionInfo() { return info_
; }
68 virtual const char *typeString() const { return "sel"; }
69 virtual std::string
formatSingleValue(const Selection
&value
) const;
71 //! \copydoc SelectionOptionInfo::setManager()
72 void setManager(SelectionOptionManager
*manager
);
75 * Adds selections to the storage.
77 * \param[in] selections List of selections to add.
78 * \param[in] bFullValue If true, the provided selections are the full
79 * value of the option, and additional checks are performed.
80 * \throws std::bad_alloc if out of memory.
81 * \throws InvalidInputError if
82 * - There is an incorrect number of selections in \p selections.
83 * - Any selection in \p selections is not allowed for this
86 * This function is used to add selections from SelectionOptionManager
87 * (called with \p bFullValue set to true), as well as internally by
88 * the storage class (called with \p bFullValue set to false).
90 void addSelections(const SelectionList
&selections
,
93 // Required to access the number of values in selection requests.
94 // See SelectionCollection::Impl.
95 using MyBase::maxValueCount
;
96 //! \copydoc SelectionOptionInfo::setValueCount()
97 void setAllowedValueCount(int count
);
99 * Alters flags for the selections created by this option.
101 * \param[in] flag Flag to change.
102 * \param[in] bSet Whether to set or clear the flag.
103 * \throws std::bad_alloc if out of memory.
104 * \throws InvalidInputError if selections have already been
105 * provided and conflict with the given flags.
107 * If selections have already been provided, it is checked that they
108 * match the limitations enforced by the flags. Pending requests are
111 * Strong exception safety guarantee.
113 void setSelectionFlag(SelectionFlag flag
, bool bSet
);
116 virtual void convertValue(const std::string
&value
);
117 virtual void processSetValues(ValueList
*values
);
118 virtual void processAll();
120 SelectionOptionInfo info_
;
121 SelectionOptionManager
*manager_
;
122 SelectionFlags selectionFlags_
;