ExecFlagEnum Class Reference

A MultiMooseEnum object to hold "execute_on" flags. More...

#include <ExecFlagEnum.h>

Inheritance diagram for ExecFlagEnum:

Public Member Functions
	ExecFlagEnum ()
	ExecFlagEnum (const ExecFlagEnum &other)
	ExecFlagEnum (const MultiMooseEnum &other)
std::string	getDocString () const
	Generate a documentation string for the "execute_on" parameter. More...
const std::set< ExecFlagType > &	items () const
	Reference the all the available items. More...
const std::string &	operator[] (unsigned int i) const
	Indexing operator Operator to retrieve an item from the MultiMooseEnum. More...
unsigned int	get (unsigned int i) const
	Indexing operator Operator to retrieve an item from the MultiMooseEnum. More...
void	clear ()
	Clear the MultiMooseEnum. More...
unsigned int	size () const
	Return the number of items in the MultiMooseEnum. More...
virtual bool	isValid () const override
	IsValid. More...
virtual void	deprecate (const std::string &name, const std::string &raw_name="")
	Deprecates various options in the MOOSE enum. More...
std::vector< std::string >	getNames () const
	Method for returning a vector of all valid enumeration names for this instance. More...
std::string	getRawNames () const
	Method for returning the raw name strings for this instance. More...
std::vector< int >	getIDs () const
	Method for returning a vector of ids for this instance. More...
bool	isOutOfRangeAllowed () const
	isOutOfRangeAllowed More...
const std::set< MooseEnumItem > &	items ()
	Return the complete set of available flags. More...
int	getNextValidID () const
	Compute the next valid ID. More...
template<typename... Args>
void	addAvailableFlags (const ExecFlagType &flag, Args... flags)
	Add additional execute_on flags to the list of possible flags. More...
void	addAvailableFlags (const ExecFlagType &flag)
ExecFlagEnum &	operator= (const std::initializer_list< ExecFlagType > &flags)
ExecFlagEnum &	operator= (const ExecFlagType &flags)
ExecFlagEnum &	operator+= (const std::initializer_list< ExecFlagType > &flags)
ExecFlagEnum &	operator+= (const ExecFlagType &flags)
MultiMooseEnum &	operator= (const std::string &names)
	Assignment operators for setting the current flags. More...
MultiMooseEnum &	operator= (const std::vector< std::string > &names)
	Assignment operators for setting the current flags. More...
MultiMooseEnum &	operator= (const std::set< std::string > &names)
	Assignment operators for setting the current flags. More...
template<typename... Args>
void	removeAvailableFlags (const ExecFlagType &flag, Args... flags)
	Remove flags from being available. More...
void	removeAvailableFlags (const ExecFlagType &flag)
bool	operator== (const MultiMooseEnum &value) const
	Comparison operators for comparing with character constants, MultiMooseEnums or integer values. More...
bool	operator!= (const MultiMooseEnum &value) const
bool	contains (const std::string &value) const
	Contains methods for seeing if a value is in the MultiMooseEnum. More...
bool	contains (int value) const
bool	contains (unsigned short value) const
bool	contains (const MultiMooseEnum &value) const
bool	contains (const MooseEnumItem &value) const
void	erase (const std::string &names)
	Un-assign a value. More...
void	erase (const std::vector< std::string > &names)
void	erase (const std::set< std::string > &names)
void	push_back (const std::string &names)
	Insert operators Operator to insert (push_back) values into the enum. More...
void	push_back (const std::vector< std::string > &names)
void	push_back (const std::set< std::string > &names)
MooseEnumIterator	begin () const
	Returns a begin/end iterator to all of the items in the enum. More...
MooseEnumIterator	end () const
std::set< MooseEnumItem >::const_iterator	find (const MooseEnumItem &other) const
	Locate an item. More...
std::set< MooseEnumItem >::const_iterator	find (const std::string &name) const
std::set< MooseEnumItem >::const_iterator	find (int id) const

Protected Member Functions
void	appendCurrent (const ExecFlagType &item)
	Append the list of current flags. More...
virtual void	checkDeprecated () const override
	Check whether any of the current values are deprecated when called. More...
void	checkDeprecated (const MooseEnumItem &item) const
	Check and warn deprecated values. More...
template<typename InputIterator >
MultiMooseEnum &	assign (InputIterator first, InputIterator last, bool append)
	Helper method for all inserts and assignment operators. More...
template<typename InputIterator >
void	remove (InputIterator first, InputIterator last)
	Helper method for un-assigning enumeration values. More...
void	setCurrentItems (const std::vector< MooseEnumItem > &current)
	Set the current items. More...
void	addEnumerationNames (const std::string &names)
	Methods to add possible enumeration value to the enum. More...
void	addEnumerationName (const std::string &raw_name)
void	addEnumerationName (const std::string &name, const int &value)
void	addEnumerationItem (const MooseEnumItem &item)

Protected Attributes
std::vector< MooseEnumItem >	_current
	The current id. More...
std::set< MooseEnumItem >	_items
	Storage for the assigned items. More...
std::map< MooseEnumItem, MooseEnumItem >	_deprecated_items
	The map of deprecated names and optional replacements. More...
bool	_allow_out_of_range
	Flag to enable enumeration items not previously defined. More...

Detailed Description

A MultiMooseEnum object to hold "execute_on" flags.

This object allows available flags to be added or removed thus each object can control the flags that are available.

Definition at line 25 of file ExecFlagEnum.h.

Constructor & Destructor Documentation

ExecFlagEnum() [1/3]

ExecFlagEnum::ExecFlagEnum

(

)

Definition at line 14 of file ExecFlagEnum.C.

: MultiMooseEnum() {}

ExecFlagEnum() [2/3]

ExecFlagEnum::ExecFlagEnum

(

const ExecFlagEnum &

other

)

Definition at line 16 of file ExecFlagEnum.C.

: MultiMooseEnum(other) {}

ExecFlagEnum() [3/3]

ExecFlagEnum::ExecFlagEnum

(

const MultiMooseEnum &

other

)

Definition at line 15 of file ExecFlagEnum.C.

: MultiMooseEnum(other) {}

Member Function Documentation

addAvailableFlags() [1/2]

template<typename... Args>

void ExecFlagEnum::addAvailableFlags	(	const ExecFlagType &	flag,
		Args...	flags
	)

Add additional execute_on flags to the list of possible flags.

Use a recursive variadic template function to allow for an arbitrary number arguments: addAvaiableFlags(EXEC_INITIAL); addAvaiableFlags(EXEC_INITIAL, EXEC_TIMESTEP_END);

Definition at line 85 of file ExecFlagEnum.h.

Referenced by MooseApp::addExecFlag(), AdvancedOutput::addValidParams(), Output::getDefaultExecFlagEnum(), MooseUtils::getDefaultExecFlagEnum(), Output::getExecuteOptions(), validParams< AuxKernel >(), and validParams< MultiAppTransfer >().

{
  addAvailableFlags(flag);
  addAvailableFlags(flags...);
}

addAvailableFlags() [2/2]

void ExecFlagEnum::addAvailableFlags

(

const ExecFlagType &

flag

)

Definition at line 19 of file ExecFlagEnum.C.

{
  addEnumerationItem(flag);
}

addEnumerationItem()

void MooseEnumBase::addEnumerationItem ( const MooseEnumItem &  item )

protectedinherited

Definition at line 117 of file MooseEnumBase.C.

Referenced by addAvailableFlags(), MooseEnumBase::addEnumerationName(), and MultiMooseEnum::assign().

{
  if (_items.count(item) > 0) // do nothing for identical insertions
    return;

  if (find(item.id()) != _items.end())
    mooseError("The supplied id ",
               item.id(),
               " already exists in the enumeration, cannot not add '",
               item,
               "'.");
  if (find(item.name()) != _items.end())
    mooseError("The name '", item.name(), "' already exists in the enumeration.");

  _items.insert(item);
}

addEnumerationName() [1/2]

void MooseEnumBase::addEnumerationName ( const std::string &  raw_name )

protectedinherited

Definition at line 73 of file MooseEnumBase.C.

Referenced by MooseEnumBase::addEnumerationNames().

{
  // Make sure the option is not malformed
  if (raw_name.find_first_of('=') == 0 || raw_name.find_last_of('=') == raw_name.length() - 1)
    mooseError("You cannot place whitespace around the '=' character in MooseEnumBase");

  // Split on equals sign
  std::vector<std::string> name_value;
  MooseUtils::tokenize(MooseUtils::trim(raw_name), name_value, 1, "=");

  // There should be one or two items in the name_value
  if (name_value.size() < 1 || name_value.size() > 2)
    mooseError("Invalid option supplied in MooseEnumBase: ", raw_name);

  // Remove un-wanted space around string
  name_value[0] = MooseUtils::trim(name_value[0]);

  // See if there is a value supplied for this option
  // strtol allows for proper conversions of both int and hex strings
  int value;
  if (name_value.size() == 2)
    value = std::strtol(name_value[1].c_str(), NULL, 0);
  else
    value = getNextValidID();

  addEnumerationName(name_value[0], value);
}

addEnumerationName() [2/2]

void MooseEnumBase::addEnumerationName ( const std::string &  name, const int &  value  )

protectedinherited

Definition at line 111 of file MooseEnumBase.C.

{
  addEnumerationItem(MooseEnumItem(name, value));
}

addEnumerationNames()

void MooseEnumBase::addEnumerationNames ( const std::string &  names )

protectedinherited

Methods to add possible enumeration value to the enum.

The MooseEnum/MultiMooseEnum are not designed to be modified, with respect to the list of possible values. However, this is not the case for the ExecFlagEnum which is a special type of MultiMooseEnum for managing the "execute_on" flags. These methods are used by ExecFlagEnum to allow users to modify the available execute flags for their object.

Definition at line 64 of file MooseEnumBase.C.

Referenced by MooseEnumBase::MooseEnumBase().

{
  std::vector<std::string> elements;
  MooseUtils::tokenize(names, elements, 1, " ");
  for (const std::string & raw_name : elements)
    addEnumerationName(raw_name);
}

appendCurrent()

void ExecFlagEnum::appendCurrent ( const ExecFlagType &  item )

protected

Append the list of current flags.

Definition at line 82 of file ExecFlagEnum.C.

Referenced by operator+=().

{
  if (find(item) == _items.end())
    mooseError("The supplied item '",
               item,
               "' is not an available item for the "
               "ExecFlagEnum object, thus it cannot be set as current.");
  _current.push_back(item);
}

assign()

template<typename InputIterator >

MultiMooseEnum & MultiMooseEnum::assign ( InputIterator  first, InputIterator  last, bool  append  )

protectedinherited

Helper method for all inserts and assignment operators.

Definition at line 183 of file MultiMooseEnum.C.

Referenced by MultiMooseEnum::operator=(), and MultiMooseEnum::push_back().

{
  if (!append)
    clear();

  for (InputIterator it = first; it != last; ++it)
  {
    const auto iter = find(*it);
    if (iter == _items.end())
    {
      if (!_allow_out_of_range) // Are out of range values allowed?
        mooseError("Invalid option \"",
                   *it,
                   "\" in MultiMooseEnum.  Valid options (not case-sensitive) are \"",
                   getRawNames(),
                   "\".");
      else
      {
        MooseEnumItem created(*it, getNextValidID());
        addEnumerationItem(created);
        _current.push_back(created);
      }
    }
    else
      _current.push_back(*iter);
  }
  checkDeprecated();
  return *this;
}

begin()

MooseEnumIterator MultiMooseEnum::begin ( ) const

inlineinherited

Returns a begin/end iterator to all of the items in the enum.

Items will always be capitalized.

Definition at line 139 of file MultiMooseEnum.h.

Referenced by ExecuteMooseObjectWarehouse< Transfer >::addObjectMask().

{ return _current.begin(); }

checkDeprecated() [1/2]

void MooseEnumBase::checkDeprecated ( const MooseEnumItem &  item ) const

protectedinherited

Check and warn deprecated values.

Definition at line 135 of file MooseEnumBase.C.

{
  std::map<MooseEnumItem, MooseEnumItem>::const_iterator it = _deprecated_items.find(item);
  if (it != _deprecated_items.end())
  {
    if (it->second.name().empty())
      mooseWarning(item.name() + " is deprecated");
    else
      mooseWarning(item.name() + " is deprecated, consider using " + it->second.name());
  }
}

checkDeprecated() [2/2]

void MultiMooseEnum::checkDeprecated ( ) const

overrideprotectedvirtualinherited

Check whether any of the current values are deprecated when called.

Implements MooseEnumBase.

Definition at line 240 of file MultiMooseEnum.C.

Referenced by MultiMooseEnum::assign(), and operator+=().

{
  for (const auto & item : _current)
    MooseEnumBase::checkDeprecated(item);
}

clear()

void MultiMooseEnum::clear ( )

inherited

Clear the MultiMooseEnum.

Definition at line 228 of file MultiMooseEnum.C.

Referenced by MultiMooseEnum::assign(), AdvancedOutput::initExecutionTypes(), operator=(), and SetupInterface::SetupInterface().

{
  _current.clear();
}

contains() [1/5]

bool MultiMooseEnum::contains ( const std::string &  value ) const

inherited

Contains methods for seeing if a value is in the MultiMooseEnum.

Returns

bool - the truth value indicating whether the value is present

Definition at line 62 of file MultiMooseEnum.C.

Referenced by FEProblemBase::addTransfer(), AdvancedOutput::addValidParams(), ChangeOverTimePostprocessor::ChangeOverTimePostprocessor(), MultiMooseEnum::contains(), EigenExecutionerBase::init(), Console::initialSetup(), AdvancedOutput::initPostprocessorOrVectorPostprocessorLists(), EigenExecutionerBase::inversePowerIteration(), MultiMooseEnum::operator==(), Console::output(), Console::outputSystemInformation(), EigenExecutionerBase::postExecute(), removeAvailableFlags(), Output::shouldOutput(), and PetscOutput::solveSetup().

{
  return std::find_if(_current.begin(), _current.end(), [&value](const MooseEnumItem & item) {
           return item == value;
         }) != _current.end();
}

contains() [2/5]

bool MultiMooseEnum::contains ( int  value ) const

inherited

Definition at line 70 of file MultiMooseEnum.C.

{
  return std::find_if(_current.begin(), _current.end(), [&value](const MooseEnumItem & item) {
           return item == value;
         }) != _current.end();
}

contains() [3/5]

bool MultiMooseEnum::contains ( unsigned short  value ) const

inherited

Definition at line 78 of file MultiMooseEnum.C.

{
  return std::find_if(_current.begin(), _current.end(), [&value](const MooseEnumItem & item) {
           return item == value;
         }) != _current.end();
}

contains() [4/5]

bool MultiMooseEnum::contains ( const MultiMooseEnum &  value ) const

inherited

Definition at line 86 of file MultiMooseEnum.C.

{
  for (const auto & item : value._current)
    if (!contains(item))
      return false;
  return true;
}

contains() [5/5]

bool MultiMooseEnum::contains ( const MooseEnumItem &  value ) const

inherited

Definition at line 95 of file MultiMooseEnum.C.

{
  return std::find_if(_current.begin(), _current.end(), [&value](const MooseEnumItem & item) {
           return item == value;
         }) != _current.end();
}

deprecate()

void MooseEnumBase::deprecate ( const std::string &  name, const std::string &  raw_name = ""  )

virtualinherited

Deprecates various options in the MOOSE enum.

For each deprecated option, you may supply an optional new option that will be used in a message telling the user which new option replaces the old one.

Definition at line 45 of file MooseEnumBase.C.

{
  std::set<MooseEnumItem>::const_iterator deprecated = find(name);
  if (deprecated == _items.end())
    mooseError("Cannot deprecate the enum item ", name, ", is not an available value.");

  std::set<MooseEnumItem>::const_iterator replaced = find(raw_name);
  if (replaced == _items.end())
    mooseError("Cannot deprecate the enum item ",
               name,
               ", since the replaced item ",
               raw_name,
               " it is not an available value.");

  _deprecated_items.emplace(std::make_pair(*deprecated, *replaced));
  checkDeprecated();
}

end()

MooseEnumIterator MultiMooseEnum::end ( ) const

inlineinherited

Definition at line 140 of file MultiMooseEnum.h.

{ return _current.end(); }

erase() [1/3]

void MultiMooseEnum::erase ( const std::string &  names )

inherited

Un-assign a value.

Parameters

names

- a string, set, or vector giving the name to erase from the enumeration values

Definition at line 123 of file MultiMooseEnum.C.

Referenced by Console::Console().

{
  std::vector<std::string> names_vector;
  MooseUtils::tokenize(names, names_vector, 1, " ");
  remove(names_vector.begin(), names_vector.end());
}

erase() [2/3]

void MultiMooseEnum::erase ( const std::vector< std::string > &  names )

inherited

Definition at line 131 of file MultiMooseEnum.C.

{
  remove(names.begin(), names.end());
}

erase() [3/3]

void MultiMooseEnum::erase ( const std::set< std::string > &  names )

inherited

Definition at line 137 of file MultiMooseEnum.C.

{
  remove(names.begin(), names.end());
}

find() [1/3]

std::set< MooseEnumItem >::const_iterator MooseEnumBase::find ( const MooseEnumItem &  other ) const

inherited

Locate an item.

Definition at line 190 of file MooseEnumBase.C.

Referenced by MooseEnumBase::addEnumerationItem(), MooseApp::addExecFlag(), appendCurrent(), MultiMooseEnum::assign(), MooseEnumBase::deprecate(), MooseEnum::operator=(), MooseEnum::operator==(), and removeAvailableFlags().

{
  return std::find_if(_items.begin(), _items.end(), [&other](MooseEnumItem const & item) {
    return item.id() == other.id();
  });
}

find() [2/3]

std::set< MooseEnumItem >::const_iterator MooseEnumBase::find ( const std::string &  name ) const

inherited

Definition at line 174 of file MooseEnumBase.C.

{
  std::string upper = MooseUtils::toUpper(name);
  return std::find_if(_items.begin(), _items.end(), [&upper](MooseEnumItem const & item) {
    return item.name() == upper;
  });
}

find() [3/3]

std::set< MooseEnumItem >::const_iterator MooseEnumBase::find ( int  id ) const

inherited

Definition at line 183 of file MooseEnumBase.C.

{
  return std::find_if(
      _items.begin(), _items.end(), [&id](MooseEnumItem const & item) { return item.id() == id; });
}

get()

unsigned int MultiMooseEnum::get ( unsigned int  i ) const

inherited

Indexing operator Operator to retrieve an item from the MultiMooseEnum.

Parameters

i

index

Returns

the id of the MooseEnumItem at the supplied index

Definition at line 172 of file MultiMooseEnum.C.

Referenced by InputParameters::getParamHelper(), PiecewiseMulticonstant::sample(), and Parser::setScalarParameter().

{
  mooseAssert(i < _current.size(),
              "Access out of bounds in MultiMooseEnum (i: " << i << " size: " << _current.size()
                                                            << ")");

  return _current[i].id();
}

getDocString()

std::string ExecFlagEnum::getDocString

(

)

const

Generate a documentation string for the "execute_on" parameter.

Definition at line 39 of file ExecFlagEnum.C.

Referenced by validParams< CommonOutputAction >(), validParams< Output >(), and validParams< SetupInterface >().

{
  std::string doc("The list of flag(s) indicating when this object should be executed, the "
                  "available options include ");
  doc += Moose::stringify(getNames(), ", ");
  doc += ".";
  return doc;
}

getIDs()

std::vector< int > MooseEnumBase::getIDs ( ) const

inherited

Method for returning a vector of ids for this instance.

Returns

a vector of ints containing the possible ids for this enumeration

Definition at line 164 of file MooseEnumBase.C.

Referenced by MooseEnum::operator=().

{
  std::vector<int> out;
  out.reserve(_items.size());
  for (const auto & item : _items)
    out.push_back(item.id());
  return out;
}

getNames()

std::vector< std::string > MooseEnumBase::getNames ( ) const

inherited

Method for returning a vector of all valid enumeration names for this instance.

Returns

a vector of names

Definition at line 148 of file MooseEnumBase.C.

Referenced by getDocString().

{
  std::vector<std::string> out;
  out.reserve(_items.size());
  for (const auto & item : _items)
    out.push_back(item.name());
  return out;
}

getNextValidID()

int MooseEnumBase::getNextValidID ( ) const

inherited

Compute the next valid ID.

Definition at line 102 of file MooseEnumBase.C.

Referenced by MooseEnumBase::addEnumerationName(), MooseApp::addExecFlag(), MultiMooseEnum::assign(), and MooseEnum::operator=().

{
  int value = -1; // Use -1 so if no values exist the first will be zero
  for (const auto & item : _items)
    value = std::max(value, item.id());
  return ++value;
}

getRawNames()

std::string MooseEnumBase::getRawNames ( ) const

inherited

Method for returning the raw name strings for this instance.

Returns

a space separated list of names

Definition at line 158 of file MooseEnumBase.C.

Referenced by MultiMooseEnum::assign(), AdvancedOutput::enableOutputTypes(), MooseEnum::operator=(), MooseEnum::operator==(), validParams< ComparisonPostprocessor >(), validParams< LeastSquaresFit >(), validParams< PiecewiseConstant >(), and validParams< Residual >().

{
  return Moose::stringify(_items, " ");
}

isOutOfRangeAllowed()

bool MooseEnumBase::isOutOfRangeAllowed ( ) const

inlineinherited

isOutOfRangeAllowed

Returns

- a Boolean indicating whether enum names out of range are allowed

Definition at line 83 of file MooseEnumBase.h.

{ return _allow_out_of_range; }

isValid()

virtual bool MultiMooseEnum::isValid ( ) const

inlineoverridevirtualinherited

IsValid.

Returns

- a Boolean indicating whether this Enumeration has been set

Implements MooseEnumBase.

Definition at line 157 of file MultiMooseEnum.h.

{ return !_current.empty(); }

items() [1/2]

const std::set<ExecFlagType>& ExecFlagEnum::items ( ) const

inline

Reference the all the available items.

Definition at line 74 of file ExecFlagEnum.h.

Referenced by MooseApp::addExecFlag(), ExecuteMooseObjectWarehouse< Transfer >::ExecuteMooseObjectWarehouse(), EigenExecutionerBase::normalizeSolution(), and MooseApp::setupOptions().

{ return _items; }

items() [2/2]

const std::set<MooseEnumItem>& MooseEnumBase::items ( )

inlineinherited

Return the complete set of available flags.

Definition at line 88 of file MooseEnumBase.h.

{ return _items; }

operator!=()

bool MultiMooseEnum::operator!= ( const MultiMooseEnum &  value ) const

inherited

Definition at line 56 of file MultiMooseEnum.C.

{
  return !(*this == value);
}

operator+=() [1/2]

ExecFlagEnum & ExecFlagEnum::operator+=

(

const std::initializer_list< ExecFlagType > &

flags

)

Definition at line 65 of file ExecFlagEnum.C.

{
  for (const ExecFlagType & flag : flags)
    appendCurrent(flag);
  checkDeprecated();
  return *this;
}

operator+=() [2/2]

ExecFlagEnum & ExecFlagEnum::operator+=

(

const ExecFlagType &

flags

)

Definition at line 74 of file ExecFlagEnum.C.

{
  appendCurrent(flag);
  checkDeprecated();
  return *this;
}

operator=() [1/5]

MultiMooseEnum & MultiMooseEnum::operator=

Assignment operators for setting the current flags.

Definition at line 111 of file MultiMooseEnum.C.

{
  return assign(names.begin(), names.end(), false);
}

operator=() [2/5]

MultiMooseEnum & MultiMooseEnum::operator=

Assignment operators for setting the current flags.

Definition at line 103 of file MultiMooseEnum.C.

{
  std::vector<std::string> names_vector;
  MooseUtils::tokenize(names, names_vector, 1, " ");
  return assign(names_vector.begin(), names_vector.end(), false);
}

operator=() [3/5]

MultiMooseEnum & MultiMooseEnum::operator=

Assignment operators for setting the current flags.

Definition at line 117 of file MultiMooseEnum.C.

{
  return assign(names.begin(), names.end(), false);
}

operator=() [4/5]

ExecFlagEnum & ExecFlagEnum::operator=

(

const std::initializer_list< ExecFlagType > &

flags

)

Definition at line 49 of file ExecFlagEnum.C.

{
  clear();
  *this += flags;
  return *this;
}

operator=() [5/5]

ExecFlagEnum & ExecFlagEnum::operator=

(

const ExecFlagType &

flags

)

Definition at line 57 of file ExecFlagEnum.C.

{
  clear();
  *this += flag;
  return *this;
}

operator==()

bool MultiMooseEnum::operator== ( const MultiMooseEnum &  value ) const

inherited

Comparison operators for comparing with character constants, MultiMooseEnums or integer values.

Parameters

value

- RHS value to compare against

Returns

bool - the truth value for the comparison

Definition at line 44 of file MultiMooseEnum.C.

{
  // Not the same if the lengths are different
  if (value.size() != size())
    return false;

  // Return false if this enum does not contain an item from the other, since they are the same
  // size at this point if this is true then they are equal.
  return contains(value);
}

operator[]()

const std::string & MultiMooseEnum::operator[] ( unsigned int  i ) const

inherited

Indexing operator Operator to retrieve an item from the MultiMooseEnum.

The reference may not be used to change the item.

Parameters

i

index

Returns

a read/read-write reference to the item as a string.

Definition at line 162 of file MultiMooseEnum.C.

{
  mooseAssert(i < _current.size(),
              "Access out of bounds in MultiMooseEnum (i: " << i << " size: " << _current.size()
                                                            << ")");

  return _current[i].rawName();
}

push_back() [1/3]

void MultiMooseEnum::push_back ( const std::string &  names )

inherited

Insert operators Operator to insert (push_back) values into the enum.

Existing values are preserved and duplicates are stored.

Parameters

names

- a string, set, or vector representing one of the enumeration values.

Definition at line 143 of file MultiMooseEnum.C.

Referenced by Console::Console(), Output::Output(), PetscOutput::PetscOutput(), and Split::setup().

{
  std::vector<std::string> names_vector;
  MooseUtils::tokenize(names, names_vector, 1, " ");
  assign(names_vector.begin(), names_vector.end(), true);
}

push_back() [2/3]

void MultiMooseEnum::push_back ( const std::vector< std::string > &  names )

inherited

Definition at line 151 of file MultiMooseEnum.C.

{
  assign(names.begin(), names.end(), true);
}

push_back() [3/3]

void MultiMooseEnum::push_back ( const std::set< std::string > &  names )

inherited

Definition at line 157 of file MultiMooseEnum.C.

{
  assign(names.begin(), names.end(), true);
}

remove()

template<typename InputIterator >

void MultiMooseEnum::remove ( InputIterator  first, InputIterator  last  )

protectedinherited

Helper method for un-assigning enumeration values.

Definition at line 215 of file MultiMooseEnum.C.

{
  // Create a new list of enumerations by striping out the supplied values
  for (InputIterator it = first; it != last; ++it)
  {
    std::vector<MooseEnumItem>::iterator iter = std::find_if(
        _current.begin(), _current.end(), [it](const MooseEnumItem & item) { return item == *it; });
    if (iter != _current.end())
      _current.erase(iter);
  }
}

removeAvailableFlags() [1/2]

template<typename... Args>

void ExecFlagEnum::removeAvailableFlags	(	const ExecFlagType &	flag,
		Args...	flags
	)

Remove flags from being available.

Definition at line 93 of file ExecFlagEnum.h.

{
  removeAvailableFlags(flag);
  removeAvailableFlags(flags...);
}

removeAvailableFlags() [2/2]

void ExecFlagEnum::removeAvailableFlags

(

const ExecFlagType &

flag

)

Definition at line 25 of file ExecFlagEnum.C.

{
  if (find(flag) == _items.end())
    mooseError("The supplied item '",
               flag,
               "' is not an available enum item for the "
               "MultiMooseEnum object, thus it cannot be removed.");
  else if (contains(flag))
    mooseError("The supplied item '", flag, "' is a selected item, thus it can not be removed.");

  _items.erase(flag);
}

setCurrentItems()

void MultiMooseEnum::setCurrentItems ( const std::vector< MooseEnumItem > &  current )

protectedinherited

Set the current items.

size()

unsigned int MultiMooseEnum::size ( ) const

inherited

Return the number of items in the MultiMooseEnum.

Definition at line 234 of file MultiMooseEnum.C.

Referenced by InterfaceKernel::InterfaceKernel(), MultiMooseEnum::operator==(), PiecewiseMulticonstant::PiecewiseMulticonstant(), and FEProblemBase::setCoordSystem().

{
  return _current.size();
}

Member Data Documentation

_allow_out_of_range

bool MooseEnumBase::_allow_out_of_range

protectedinherited

Flag to enable enumeration items not previously defined.

Definition at line 139 of file MooseEnumBase.h.

Referenced by MultiMooseEnum::assign(), MooseEnumBase::isOutOfRangeAllowed(), MooseEnum::operator=(), and MooseEnum::operator==().

_current

std::vector<MooseEnumItem> MultiMooseEnum::_current

protectedinherited

The current id.

Definition at line 188 of file MultiMooseEnum.h.

Referenced by appendCurrent(), MultiMooseEnum::assign(), MultiMooseEnum::begin(), MultiMooseEnum::checkDeprecated(), MultiMooseEnum::clear(), MultiMooseEnum::contains(), MultiMooseEnum::end(), MultiMooseEnum::get(), MultiMooseEnum::isValid(), operator<<(), MultiMooseEnum::operator[](), MultiMooseEnum::remove(), and MultiMooseEnum::size().

_deprecated_items

std::map<MooseEnumItem, MooseEnumItem> MooseEnumBase::_deprecated_items

protectedinherited

The map of deprecated names and optional replacements.

Definition at line 136 of file MooseEnumBase.h.

Referenced by MooseEnumBase::checkDeprecated(), and MooseEnumBase::deprecate().

_items

std::set<MooseEnumItem> MooseEnumBase::_items

protectedinherited

Storage for the assigned items.

Definition at line 133 of file MooseEnumBase.h.

Referenced by MooseEnumBase::addEnumerationItem(), appendCurrent(), MultiMooseEnum::assign(), MooseEnumBase::deprecate(), MooseEnumBase::find(), MooseEnumBase::getIDs(), MooseEnumBase::getNames(), MooseEnumBase::getNextValidID(), MooseEnumBase::getRawNames(), items(), MooseEnumBase::items(), MooseEnum::operator=(), MooseEnum::operator==(), and removeAvailableFlags().

---

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

• include/utils/ExecFlagEnum.h
• src/utils/ExecFlagEnum.C