#include <deal.II/base/patterns.h>

Inheritance diagram for Patterns::Tuple:

Public Member Functions
	Tuple (const std::vector< std::unique_ptr< PatternBase >> &patterns, const std::string &separator=":")

	Tuple (const std::vector< std::unique_ptr< PatternBase >> &patterns, const char *separator)

template<class... PatternTypes>
	Tuple (const std::string &separator, const PatternTypes &...patterns)

template<class... PatternTypes>
	Tuple (const char *separator, const PatternTypes &...patterns)

template<typename... Patterns>
	Tuple (const Patterns &...patterns)

	Tuple (const Tuple &other)

virtual bool	match (const std::string &test_string) const override

virtual std::string	description (const OutputStyle style=Machine) const override

virtual std::unique_ptr< PatternBase >	clone () const override

std::size_t	memory_consumption () const override

const PatternBase &	get_pattern (const unsigned int &i) const

const std::string &	get_separator () const

Public Member Functions inherited from Patterns::PatternBase
virtual	~PatternBase ()=default

Static Public Member Functions
static std::unique_ptr< Tuple >	create (const std::string &description)

Private Attributes
std::vector< std::unique_ptr< PatternBase > >	patterns

const std::string	separator

Static Private Attributes
static const char *	description_init = "[Tuple"

Additional Inherited Members
Public Types inherited from Patterns::PatternBase

Detailed Description

This pattern matches colon-separated values of arbitrary types. Each type has to match a pattern given to the constructor.

An example usage is the following:

std::vector< std::unique_ptr<Patterns::PatternBase> > ps;
ps.push_back(std::unique_ptr<Patterns::Integer>());
ps.push_back(std::unique_ptr<Patterns::Double>());
ps.push_back(std::unique_ptr<Patterns::Anything>());
Patterns::Tuple pattern(ps, ":");
bool check = ps.match("5 : 3.14 : Ciao"); // check = true

or, if you want to exploit ParameterHandler::add_parameter():

using T = std::tuple<std::string, Point<3>, unsigned int>;
T a = Patterns::Tools::Convert<T>::to_value("Ciao : 1.0, 2.0, 3.0 : 33");
ParameterHandler prm;
prm.add_parameter("A tuple", a);
prm.log_parameters(deallog);
// DEAL:parameters::A tuple: Ciao : 1.000000, 2.000000, 3.000000 : 33
prm.set("A tuple", "Mondo : 2.0, 3.0, 4.0 : 34");
prm.log_parameters(deallog);
// DEAL:parameters::A tuple: Mondo : 2.0, 3.0, 4.0 : 34
deallog << Patterns::Tools::Convert<T>::to_string(a) << std::endl;
// DEAL::Mondo : 2.000000, 3.000000, 4.000000 : 34

The constructor expects a vector of Patterns, and optionally a string specifying the separator to use when parsing the Tuple from a string.

The default separator is a colon, owing to the fact that a pair is in fact a tuple with two elements.

Author: Luca Heltai, 2017.

Definition at line 766 of file patterns.h.

Constructor & Destructor Documentation

Patterns::Tuple::Tuple	(	const std::vector< std::unique_ptr< PatternBase >> &	patterns,
		const std::string &	separator = `":"`
	)

Constructor. Use a vector of unique pointers to Patterns to construct the tuple.

Parameters

patterns	The pattern each object of the Tuple should match
separator	An optional string used to delimit each element Constructor.

Definition at line 1053 of file patterns.cc.

Patterns::Tuple::Tuple	(	const std::vector< std::unique_ptr< PatternBase >> &	patterns,
		const char *	separator
	)

Constructor. Same as above, specialized for const char *. This is necessary to avoid compilers errors due to the variadic constructors provided below.

Definition at line 1068 of file patterns.cc.

template<class... PatternTypes>

Patterns::Tuple::Tuple	(	const std::string &	separator,
		const PatternTypes &...	patterns
	)

Constructor. Creates a Tuple from more than one class derived from PatternBase.

Parameters

separator	What separator to use.
patterns	The list of patterns to use

Definition at line 1426 of file patterns.h.

template<class... PatternTypes>

Patterns::Tuple::Tuple	(	const char *	separator,
		const PatternTypes &...	patterns
	)

Constructor. This is needed to allow users to specify directly the separator without using std::string(";").

Since we support a pure variadic templates version, without this specialization, the compiler will fail with cryptic errors.

Definition at line 1418 of file patterns.h.

template<class... PatternTypes>

Patterns::Tuple::Tuple ( const PatternTypes &... patterns )

Constructor. Same as above, using the default separator.

Parameters

patterns The list of patterns to use

Definition at line 1442 of file patterns.h.

Patterns::Tuple::Tuple ( const Tuple & other )

Copy constructor.

Definition at line 1075 of file patterns.cc.

Member Function Documentation

bool Patterns::Tuple::match ( const std::string & test_string ) const

overridevirtual

Return true if the string is a list of strings each of which matches the patterns given to the constructor.

Implements Patterns::PatternBase.

Definition at line 1086 of file patterns.cc.

std::string Patterns::Tuple::description ( const OutputStyle style = Machine ) const

overridevirtual

Return a description of the pattern that valid strings are expected to match.

Implements Patterns::PatternBase.

Definition at line 1105 of file patterns.cc.

std::unique_ptr< PatternBase > Patterns::Tuple::clone ( ) const

overridevirtual

Return a copy of the present object, which is newly allocated on the heap. Ownership of that object is transferred to the caller of this function.

Implements Patterns::PatternBase.

Definition at line 1155 of file patterns.cc.

std::unique_ptr< Tuple > Patterns::Tuple::create ( const std::string & description )

static

Create a new object if the start of description matches description_init. Ownership of that object is transferred to the caller of this function.

Definition at line 1171 of file patterns.cc.

std::size_t Patterns::Tuple::memory_consumption ( ) const

overridevirtual

Determine an estimate for the memory consumption (in bytes) of this object.

Reimplemented from Patterns::PatternBase.

Definition at line 1162 of file patterns.cc.

const PatternBase & Patterns::Tuple::get_pattern ( const unsigned int & i ) const

Return a reference to the i-th pattern in the tuple.

Definition at line 1219 of file patterns.cc.

const std::string & Patterns::Tuple::get_separator ( ) const

Return the separator of the tuple entries.

Definition at line 1227 of file patterns.cc.

Member Data Documentation

std::vector<std::unique_ptr<PatternBase> > Patterns::Tuple::patterns

private

Copy of the patterns stored in the Tuple.

Definition at line 875 of file patterns.h.

const std::string Patterns::Tuple::separator

private

Separator between elements of the list.

Definition at line 880 of file patterns.h.

const char * Patterns::Tuple::description_init = "[Tuple"

staticprivate

Initial part of description.

Definition at line 885 of file patterns.h.

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

deal.II/base/patterns.h
/mnt/data/darndt/Sources/dealii-clang-6.0.0/source/base/patterns.cc

Public Member Functions

Static Public Member Functions

Private Attributes

Static Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation