CASM
AClustersApproachtoStatisticalMechanics
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules
Public Types | Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | List of all members
CASM::RandomAccessEnumeratorBase< ValueType, IsConst > Class Template Referenceabstract

#include <RandomAccessEnumerator.hh>

+ Inheritance diagram for CASM::RandomAccessEnumeratorBase< ValueType, IsConst >:

Detailed Description

template<typename ValueType, bool IsConst = true>
class CASM::RandomAccessEnumeratorBase< ValueType, IsConst >

Base class for implementing specialized random access enumerators.

InputEnumerator allow random access iteration over some objects of ValueType. The specialized class should document any guaranteed properties of the enumerated objects. For instance, some enumerators may guarantee that objects will be unique, others may not. Some may guarantee objects will be primitive or in canonical form, others may not. Etc.

Derived classes (ex. MyDerivedEnumClass) must implement:

  • constructors
    • Must call _initialize or _set_current_ptr to set pointer to first valid object
    • Ensure that the current step value = 0, via _initialize or _set_step
    • Ensure that the size of the enumerator is set, via _set_size
    • If due to the constructor arguments there are no valid objects, then call _invalidate
  • virtual destructor
  • void goto_step(step_type n)
    • Should do work to determine the 'n'-th object and then call goto_step(step_type n, value_type* ptr) setting a pointer to that object
    • If 'n' equals the current step, can immediately return

Derived classes should contain ENUMERATOR_MEMBERS(MyDerivedClass) in the class definition to automatically implement:

  • name

In CASM namespace near the derived class definition, include:

  • For enumerators only meant to be used internally:
    • In header:
      • ENUMERATOR_TRAITS(MyDerivedEnumClass)
    • In the source code file:
      • const std::string CASM_TMP::traits<MyDerivedEnumClass>::name = "MyDerivedEnumClass";
  • For enumerators only meant to be added to the API:
    • In header:
      • ENUMERATOR_INTERFACE_TRAITS(MyDerivedClass)
    • In the source code file:
      • const std::string CASM_TMP::traits<MyDerivedEnumClass>::name = "MyDerivedEnumClass";
        const std::string CASM_TMP::traits<MyDerivedEnumClass>::help =
        "MyDerivedEnumClass: \n\n"
        " kwarg1: type (default=X) \n"
        " Description of kwarg1... \n\n"
        " kwarg2: type (default=X) \n"
        " Description of kwarg2... \n\n"
        " ... \n";
        int EnumInterface<MyDerivedEnumClass>::run(PrimClex &primclex, const jsonParser &kwargs) const {
        ...
        implementation to run a MyDerivedEnumClass enumerator constructed
        using the JSON input in 'kwargs' and store & save results in primclex
        ...
        return (returncode);
        }

Definition at line 15 of file RandomAccessEnumerator.hh.

Public Types

typedef
RandomAccessEnumIterator
< ValueType, IsConst > 		iterator
 
typedef std::reverse_iterator
< iterator > 		reverse_iterator
 
typedef step_type size_type
 
typedef ValueType value_type
 
typedef CASM_TMP::ConstSwitch
< IsConst, ValueType > & 		reference
 
typedef long step_type
 

Public Member Functions

 RandomAccessEnumeratorBase (size_type size=0)
 
 ~RandomAccessEnumeratorBase ()
 
iterator begin ()
 
iterator end ()
 
reverse_iterator rbegin ()
 
reverse_iterator rend ()
 
size_type size () const
 Number of elements in enumerator. More...
 
reference front ()
 Reference to first element in enumerator. More...
 
reference back ()
 Reference to last element in enumerator. More...
 
reference initial ()
 Reference to first element in enumerator. More...
 
reference final ()
 Reference to last element in enumerator. More...
 
reference operator[] (size_type n)
 Reference an element in enumerator. More...
 
reference current () const
 Access the current ObjectType by reference. More...
 
step_type step () const
 Increments with each enumerated object. More...
 
bool valid () const
 Returns false if enumeration is complete. More...
 
virtual jsonParser source (step_type step) const
 
virtual std::string name () const =0
 Derived enumerators must implement name, via ENUM_MEMBERS. More...
 

Protected Member Functions

void _set_size (size_type val)
 Set size value. More...
 
void _initialize (value_type *_initial)
 
void _initialize ()
 
void _set_current_ptr (value_type *_new)
 Change the pointer. More...
 
value_type & _current ()
 Access the current ObjectType by reference. More...
 
void _set_step (step_type val)
 Set current step value. More...
 
void _increment_step ()
 Increment current step value. More...
 
void _decrement_step ()
 Decrement current step value. More...
 
void _invalidate ()
 Call if enumeration complete. More...
 
void _validate ()
 Used if random access enumerator step is moved into valid range. More...
 

Private Member Functions

virtual value_type * at_step (step_type n)=0
 
void goto_step (step_type n)
 
void increment () override
 

Private Attributes

friend RandomAccessEnumIteratorBase< ValueType, IsConst >
 
size_type m_size
 

Member Typedef Documentation

template<typename ValueType, bool IsConst = true>
typedef RandomAccessEnumIterator<ValueType, IsConst> CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::iterator

Definition at line 287 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
typedef CASM_TMP::ConstSwitch<IsConst, ValueType>& CASM::ValEnumerator< ValueType, IsConst >::reference
inherited

Definition at line 192 of file Enumerator.hh.

template<typename ValueType, bool IsConst = true>
typedef std::reverse_iterator<iterator> CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::reverse_iterator

Definition at line 288 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
typedef step_type CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::size_type

Definition at line 289 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
typedef long CASM::EnumeratorBase::step_type
inherited

Definition at line 103 of file Enumerator.hh.

template<typename ValueType, bool IsConst = true>
typedef ValueType CASM::ValEnumerator< ValueType, IsConst >::value_type
inherited

Definition at line 191 of file Enumerator.hh.

Constructor & Destructor Documentation

template<typename ValueType, bool IsConst = true>
CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::RandomAccessEnumeratorBase ( size_type  size = 0)
inline

Definition at line 292 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::~RandomAccessEnumeratorBase ( )
inline

Definition at line 296 of file RandomAccessEnumerator.hh.

Member Function Documentation

template<typename ValueType, bool IsConst = true>
value_type& CASM::ValEnumerator< ValueType, IsConst >::_current ( )
inlineprotectedinherited

Access the current ObjectType by reference.

Definition at line 244 of file Enumerator.hh.

void CASM::EnumeratorBase::_decrement_step ( )
inlineprotectedinherited

Decrement current step value.

Definition at line 164 of file Enumerator.hh.

void CASM::EnumeratorBase::_increment_step ( )
inlineprotectedinherited

Increment current step value.

Definition at line 159 of file Enumerator.hh.

void CASM::EnumeratorBase::_initialize ( )
inlineprotectedinherited

Initialize

  • Sets step to 0
  • Sets valid to true

Definition at line 148 of file Enumerator.hh.

template<typename ValueType, bool IsConst = true>
void CASM::ValEnumerator< ValueType, IsConst >::_initialize ( value_type *  _initial)
inlineprotectedinherited

Initialize

  • Sets current to point at _initial
  • Sets step to 0
  • Sets valid to true

Definition at line 216 of file Enumerator.hh.

void CASM::EnumeratorBase::_invalidate ( )
inlineprotectedinherited

Call if enumeration complete.

Definition at line 169 of file Enumerator.hh.

template<typename ValueType, bool IsConst = true>
void CASM::ValEnumerator< ValueType, IsConst >::_set_current_ptr ( value_type *  _new)
inlineprotectedinherited

Change the pointer.

Definition at line 239 of file Enumerator.hh.

template<typename ValueType, bool IsConst = true>
void CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::_set_size ( size_type  val)
inlineprotected

Set size value.

Definition at line 365 of file RandomAccessEnumerator.hh.

void CASM::EnumeratorBase::_set_step ( step_type  val)
inlineprotectedinherited

Set current step value.

Definition at line 154 of file Enumerator.hh.

void CASM::EnumeratorBase::_validate ( )
inlineprotectedinherited

Used if random access enumerator step is moved into valid range.

Definition at line 174 of file Enumerator.hh.

template<typename ValueType, bool IsConst = true>
virtual value_type* CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::at_step ( step_type  n)
privatepure virtual

Must be implemented in derived enumerator

  • Should return a pointer to the object 'at' step n
  • May be implemented by returning pointers to different objects, or by modifying the object being pointed at and returning the same pointer

Implemented in CASM::ScelEnumByNameT< IsConst >, and CASM::ConfigEnumInterpolation.

template<typename ValueType, bool IsConst = true>
reference CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::back ( )
inline

Reference to last element in enumerator.

Definition at line 333 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
iterator CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::begin ( )
inline

Definition at line 305 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
reference CASM::ValEnumerator< ValueType, IsConst >::current ( ) const
inlineinherited

Access the current ObjectType by reference.

Definition at line 232 of file Enumerator.hh.

template<typename ValueType, bool IsConst = true>
iterator CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::end ( )
inline

Definition at line 309 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
reference CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::final ( )
inline

Reference to last element in enumerator.

Definition at line 344 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
reference CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::front ( )
inline

Reference to first element in enumerator.

Definition at line 327 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
void CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::goto_step ( step_type  n)
inlineprivate

Sets step, current pointer via call to 'at_step', and enumerator validity

  • If n in valid range, calls at_step to set the current object and sets the enumerator state to valid
  • If n not in valid range, will set enumerator state to not valid

Definition at line 382 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
void CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::increment ( )
inlineoverrideprivatevirtual

Pure virtual function inherited from InputEnumeratorBase, needed when incrementing from InputEnumeratorBase*

Implements CASM::InputEnumeratorBase< ValueType, IsConst >.

Definition at line 398 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
reference CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::initial ( )
inline

Reference to first element in enumerator.

Definition at line 339 of file RandomAccessEnumerator.hh.

virtual std::string CASM::EnumeratorBase::name ( ) const
pure virtualinherited

Derived enumerators must implement name, via ENUM_MEMBERS.

Implemented in CASM::ScelEnumT< IsConst >, CASM::ScelEnumByPropsT< IsConst >, CASM::ScelEnumByNameT< IsConst >, CASM::SuperConfigEnum, CASM::ConfigEnumRandomOccupations, CASM::ConfigEnumEquivalents, CASM::ConfigEnumAllOccupations, CASM::TestEnum, CASM::ConfigEnumStrain, CASM::ScelEnumEquivalents, CASM::ConfigEnumInterpolation, and CASM::LatticeEnumEquivalents.

template<typename ValueType, bool IsConst = true>
reference CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::operator[] ( size_type  n)
inline

Reference an element in enumerator.

Definition at line 349 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
reverse_iterator CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::rbegin ( )
inline

Definition at line 313 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
reverse_iterator CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::rend ( )
inline

Definition at line 317 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
size_type CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::size ( ) const
inline

Number of elements in enumerator.

Definition at line 322 of file RandomAccessEnumerator.hh.

virtual jsonParser CASM::EnumeratorBase::source ( step_type  step) const
inlinevirtualinherited

Default Object source just uses step#

Returns:

{
"enumerated_by": "<enumerator_type>",
"step": <step #>
}

Definition at line 131 of file Enumerator.hh.

step_type CASM::EnumeratorBase::step ( ) const
inlineinherited

Increments with each enumerated object.

Definition at line 113 of file Enumerator.hh.

bool CASM::EnumeratorBase::valid ( ) const
inlineinherited

Returns false if enumeration is complete.

Definition at line 118 of file Enumerator.hh.

Member Data Documentation

template<typename ValueType, bool IsConst = true>
size_type CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::m_size
private

Definition at line 402 of file RandomAccessEnumerator.hh.

template<typename ValueType, bool IsConst = true>
friend CASM::RandomAccessEnumeratorBase< ValueType, IsConst >::RandomAccessEnumIteratorBase< ValueType, IsConst >
private

Definition at line 280 of file RandomAccessEnumerator.hh.

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