gmx::OptionSectionHandle Class Reference

#include <gromacs/options/optionsection.h>

Inheritance diagram for gmx::OptionSectionHandle:

Collaboration diagram for gmx::OptionSectionHandle:

Description

Allows adding options to an OptionSection.

An instance of this class is returned from IOptionsContainerWithSections::addSection(), and supports adding options and subsections to a section created with OptionSection.

Public Member Functions
	OptionSectionHandle (internal::OptionSectionImpl *section)
	Wraps a given section storage object.
IOptionsContainer &	addGroup () override
	Creates a subgroup of options within the current options. More...
template<class SectionType >
SectionType::HandleType	addSection (const SectionType &section)
	Adds a section to this collection. More...
template<class OptionType >
OptionType::InfoType *	addOption (const OptionType &settings)
	Adds a recognized option. More...

Protected Member Functions
	GMX_DEFAULT_CONSTRUCTORS (IOptionsContainerWithSections)
	GMX_DEFAULT_CONSTRUCTORS (IOptionsContainer)

Static Protected Member Functions
template<typename StorageType >
static StorageType *	getStorage (internal::OptionSectionImpl *section)
	Returns the storage for a particular type of section. More...

Member Function Documentation

IOptionsContainer & gmx::AbstractOptionSectionHandle::addGroup ( )

overridevirtualinherited

Creates a subgroup of options within the current options.

To add options to the group, use the returned interface.

Currently, this is only used to influence the order of options: all options in a group appear before options in a group added after it, no matter in which order the options are added to the groups. In the future, the groups could also be used to influence the help output.

Implements gmx::IOptionsContainer.

template<class OptionType >

OptionType::InfoType* gmx::IOptionsContainer::addOption ( const OptionType &  settings )

inlineinherited

Adds a recognized option.

Template Parameters

OptionType

Type of the options description object.

Parameters

[in]

settings

Option description.

Returns

OptionInfo object for the created option (never NULL).

Exceptions

APIError

if invalid option settings are provided.

The return value is a pointer for more convenient use in callers: often callers need to declare the variable that will hold the return value in wider scope than would be achieved by declaring it at the site where addOption() is called. The returned pointer must not be freed.

See class documentation for example usage.

OptionType::InfoType must specify a type that derives from OptionInfo and matches the type that is returned by AbstractOptionStorage::optionInfo() for the storage object that corresponds to OptionType.

Examples:

template.cpp.

template<class SectionType >

SectionType::HandleType gmx::IOptionsContainerWithSections::addSection ( const SectionType &  section )

inlineinherited

Adds a section to this collection.

Template Parameters

SectionType

Type of the section description object.

Parameters

[in]

section

Section description.

Returns

AbstractOptionSectionHandle object for the created option.

Exceptions

APIError

if invalid option settings are provided.

Options can be added to the section through the returned handle.

template<typename StorageType >

IOptionSectionStorage * gmx::AbstractOptionSectionHandle::getStorage ( internal::OptionSectionImpl *  section )

inlinestaticprotectedinherited

Returns the storage for a particular type of section.

This is intended for use in derived class constructors, where the handle needs access to the actual storage. The handle should know the type of storage created for the section type it deals with, so the cast should always be successful.

---

The documentation for this class was generated from the following file:

• src/gromacs/options/optionsection.h