Generated on Tue Feb 11 2025 17:33:26 for Gecode by doxygen 1.12.0

Singleton set view. More...

#include <view.hpp>

Static Protected Member Functions

static PropCond pc_settoint (PropCond pc)
 Convert set variable PropCond pc to a PropCond for integer variables.
 
static ModEvent me_inttoset (ModEvent me)
 Convert integer variable ModEvent me to a ModEvent for set variables.
 
static ModEvent me_settoint (ModEvent me)
 Convert set variable ModEvent me to a ModEvent for integer variables.
 

Constructors and initialization

 SingletonView (void)
 Default constructor.
 
 SingletonView (Gecode::Int::IntView &y)
 Initialize with integer view y.
 
 SingletonView (const Gecode::IntVar &y)
 Initialize with integer variable y.
 

Value access

unsigned int cardMin (void) const
 Return minimum cardinality.
 
unsigned int cardMax (void) const
 Return maximum cardinality.
 
int lubMin (void) const
 Return minimum of the least upper bound.
 
int lubMax (void) const
 Return maximum of the least upper bound.
 
int lubMinN (unsigned int n) const
 Return n-th smallest element of the least upper bound.
 
int glbMin (void) const
 Return minimum of the greatest lower bound.
 
int glbMax (void) const
 Return maximum of the greatest lower bound.
 
unsigned int glbSize (void) const
 Return the number of elements in the greatest lower bound.
 
unsigned int lubSize (void) const
 Return the number of elements in the least upper bound.
 
unsigned int unknownSize (void) const
 Return the number of unknown elements.
 

Domain tests

bool contains (int i) const
 Test whether i is in the greatest lower bound.
 
bool notContains (int i) const
 Test whether i is not in the least upper bound.
 

Domain update by value

ModEvent cardMin (Space &home, unsigned int m)
 Restrict cardinality to be greater than or equal to m.
 
ModEvent cardMax (Space &home, unsigned int m)
 Restrict cardinality to be less than or equal to m.
 
ModEvent include (Space &home, int i, int j)
 Update greatest lower bound to include all elements between and including i and j.
 
ModEvent exclude (Space &home, int i, int j)
 Restrict least upper bound to not contain all elements between and including i and j.
 
ModEvent include (Space &home, int i)
 Update greatest lower bound to contain i.
 
ModEvent exclude (Space &home, int i)
 Restrict least upper bound to not contain i.
 
ModEvent intersect (Space &home, int i, int j)
 Update least upper bound to contain at most all elements between and including i and j.
 
ModEvent intersect (Space &home, int i)
 Update least upper bound to contain at most the element i.
 

Domain update by range iterator

template<class I >
ModEvent excludeI (Space &home, I &i)
 Remove range sequence described by i from least upper bound.
 
template<class I >
ModEvent includeI (Space &home, I &i)
 Include range sequence described by i in greatest lower bound.
 
template<class I >
ModEvent intersectI (Space &home, I &iter)
 Intersect least upper bound with range sequence described by i.
 

Dependencies

void subscribe (Space &home, Propagator &p, PropCond pc, bool schedule=true)
 Subscribe propagator p with propagation condition pc to view.
 
void cancel (Space &home, Propagator &p, PropCond pc)
 Cancel subscription of propagator p with propagation condition pc to view.
 
void reschedule (Space &home, Propagator &p, PropCond pc)
 Re-schedule propagator p with propagation condition pc.
 
void subscribe (Space &home, Advisor &a)
 Subscribe advisor a to view.
 
void cancel (Space &home, Advisor &a)
 Cancel subscription of advisor a.
 

Delta information for advisors

int glbMin (const Delta &d) const
 Return minimum value just pruned from glb.
 
int glbMax (const Delta &d) const
 Return maximum value just pruned from glb.
 
bool glbAny (const Delta &d) const
 Test whether arbitrary values got pruned from glb.
 
int lubMin (const Delta &d) const
 Return minimum value just pruned from lub.
 
int lubMax (const Delta &d) const
 Return maximum value just pruned from lub.
 
bool lubAny (const Delta &d) const
 Test whether arbitrary values got pruned from lub.
 
static ModEvent modevent (const Delta &d)
 Return modification event.
 

View-dependent propagator support

static void schedule (Space &home, Propagator &p, ModEvent me)
 Schedule propagator p with modification event me.
 
static ModEvent me (const ModEventDelta &med)
 Return modification event for view type in med.
 
static ModEventDelta med (ModEvent)
 Translate modification event me to modification event delta for view.
 

View comparison

template<class Char , class Traits >
std::basic_ostream< Char, Traits > & operator<< (std::basic_ostream< Char, Traits > &os, const SingletonView &x)
 Print singleton set view.
 
bool operator== (const SingletonView &x, const SingletonView &y)
 Test whether views x and y are the same.
 
bool operator!= (const SingletonView &x, const SingletonView &y)
 Test whether views x and y are the not same.
 

Additional Inherited Members

- Public Types inherited from Gecode::DerivedView< Gecode::Int::IntView >
typedef Gecode::Int::IntView::VarImpType VarImpType
 The variable implementation type belonging to the View.
 
typedef Gecode::Int::IntView::VarType VarType
 The variable type belonging to the View.
 
- Public Member Functions inherited from Gecode::DerivedView< Gecode::Int::IntView >
 DerivedView (const Gecode::Int::IntView &y)
 Initialize with view y.
 
VarImpTypevarimp (void) const
 Return variable implementation of view.
 
Gecode::Int::IntView base (void) const
 Return view from which this view is derived.
 
unsigned int degree (void) const
 Return degree (number of subscribed propagators)
 
double afc (void) const
 Return accumulated failure count.
 
bool assigned (void) const
 Test whether view is assigned.
 
void subscribe (Space &home, Propagator &p, PropCond pc, bool schedule=true)
 Subscribe propagator p with propagation condition pc to view.
 
void subscribe (Space &home, Advisor &a, bool fail=false)
 Subscribe advisor a to view.
 
void cancel (Space &home, Propagator &p, PropCond pc)
 Cancel subscription of propagator p with propagation condition pc to view.
 
void cancel (Space &home, Advisor &a, bool fail=false)
 Cancel subscription of advisor a.
 
void reschedule (Space &home, Propagator &p, PropCond pc)
 Re-schedule propagator p with propagation condition pc.
 
void update (Space &home, DerivedView< Gecode::Int::IntView > &y)
 Update this view to be a clone of view y.
 
bool operator< (const DerivedView< Gecode::Int::IntView > &y) const
 Whether this view comes before view y (arbitray order)
 
- Static Public Member Functions inherited from Gecode::DerivedView< Gecode::Int::IntView >
static bool varderived (void)
 Return whether this view is derived from a VarImpView.
 
static void schedule (Space &home, Propagator &p, ModEvent me)
 Schedule propagator p with modification event me.
 
static ModEvent me (const ModEventDelta &med)
 Return modification event for view type in med.
 
static ModEventDelta med (ModEvent)
 Translate modification event me to modification event delta for view.
 
static ModEvent modevent (const Delta &d)
 Return modification event.
 
- Protected Member Functions inherited from Gecode::DerivedView< Gecode::Int::IntView >
 DerivedView (void)
 Default constructor.
 
- Protected Attributes inherited from Gecode::DerivedView< Gecode::Int::IntView >
Gecode::Int::IntView x
 View from which this view is derived.
 

Detailed Description

Singleton set view.

A singleton set view $s$ for an integer view $x$ provides operations such that $s$ behaves like the singleton set $\{x\}$.

Definition at line 594 of file view.hpp.

Constructor & Destructor Documentation

◆ SingletonView() [1/3]

Gecode::Set::SingletonView::SingletonView ( void )
inline

Default constructor.

Definition at line 41 of file singleton.hpp.

◆ SingletonView() [2/3]

Gecode::Set::SingletonView::SingletonView ( Gecode::Int::IntView & y)
inline

Initialize with integer view y.

Definition at line 44 of file singleton.hpp.

◆ SingletonView() [3/3]

Gecode::Set::SingletonView::SingletonView ( const Gecode::IntVar & y)
inline

Initialize with integer variable y.

Definition at line 48 of file singleton.hpp.

Member Function Documentation

◆ pc_settoint()

PropCond Gecode::Set::SingletonView::pc_settoint ( PropCond pc)
inlinestaticprotected

Convert set variable PropCond pc to a PropCond for integer variables.

Definition at line 52 of file singleton.hpp.

◆ me_inttoset()

ModEvent Gecode::Set::SingletonView::me_inttoset ( ModEvent me)
inlinestaticprotected

Convert integer variable ModEvent me to a ModEvent for set variables.

Definition at line 64 of file singleton.hpp.

◆ me_settoint()

ModEvent Gecode::Set::SingletonView::me_settoint ( ModEvent me)
inlinestaticprotected

Convert set variable ModEvent me to a ModEvent for integer variables.

Definition at line 80 of file singleton.hpp.

◆ cardMin() [1/2]

unsigned int Gecode::Set::SingletonView::cardMin ( void ) const
inline

Return minimum cardinality.

Definition at line 114 of file singleton.hpp.

◆ cardMax() [1/2]

unsigned int Gecode::Set::SingletonView::cardMax ( void ) const
inline

Return maximum cardinality.

Definition at line 117 of file singleton.hpp.

◆ lubMin() [1/2]

int Gecode::Set::SingletonView::lubMin ( void ) const
inline

Return minimum of the least upper bound.

Definition at line 120 of file singleton.hpp.

◆ lubMax() [1/2]

int Gecode::Set::SingletonView::lubMax ( void ) const
inline

Return maximum of the least upper bound.

Definition at line 123 of file singleton.hpp.

◆ lubMinN()

int Gecode::Set::SingletonView::lubMinN ( unsigned int n) const

Return n-th smallest element of the least upper bound.

◆ glbMin() [1/2]

int Gecode::Set::SingletonView::glbMin ( void ) const
inline

Return minimum of the greatest lower bound.

Definition at line 126 of file singleton.hpp.

◆ glbMax() [1/2]

int Gecode::Set::SingletonView::glbMax ( void ) const
inline

Return maximum of the greatest lower bound.

Definition at line 130 of file singleton.hpp.

◆ glbSize()

unsigned int Gecode::Set::SingletonView::glbSize ( void ) const
inline

Return the number of elements in the greatest lower bound.

Definition at line 94 of file singleton.hpp.

◆ lubSize()

unsigned int Gecode::Set::SingletonView::lubSize ( void ) const
inline

Return the number of elements in the least upper bound.

Definition at line 99 of file singleton.hpp.

◆ unknownSize()

unsigned int Gecode::Set::SingletonView::unknownSize ( void ) const
inline

Return the number of unknown elements.

Definition at line 102 of file singleton.hpp.

◆ contains()

bool Gecode::Set::SingletonView::contains ( int i) const
inline

Test whether i is in the greatest lower bound.

Definition at line 107 of file singleton.hpp.

◆ notContains()

bool Gecode::Set::SingletonView::notContains ( int i) const
inline

Test whether i is not in the least upper bound.

Definition at line 111 of file singleton.hpp.

◆ cardMin() [2/2]

ModEvent Gecode::Set::SingletonView::cardMin ( Space & home,
unsigned int m )
inline

Restrict cardinality to be greater than or equal to m.

Definition at line 134 of file singleton.hpp.

◆ cardMax() [2/2]

ModEvent Gecode::Set::SingletonView::cardMax ( Space & home,
unsigned int m )
inline

Restrict cardinality to be less than or equal to m.

Definition at line 139 of file singleton.hpp.

◆ include() [1/2]

ModEvent Gecode::Set::SingletonView::include ( Space & home,
int i,
int j )
inline

Update greatest lower bound to include all elements between and including i and j.

Definition at line 177 of file singleton.hpp.

◆ exclude() [1/2]

ModEvent Gecode::Set::SingletonView::exclude ( Space & home,
int i,
int j )
inline

Restrict least upper bound to not contain all elements between and including i and j.

Definition at line 182 of file singleton.hpp.

◆ include() [2/2]

ModEvent Gecode::Set::SingletonView::include ( Space & home,
int i )
inline

Update greatest lower bound to contain i.

Definition at line 144 of file singleton.hpp.

◆ exclude() [2/2]

ModEvent Gecode::Set::SingletonView::exclude ( Space & home,
int i )
inline

Restrict least upper bound to not contain i.

Definition at line 172 of file singleton.hpp.

◆ intersect() [1/2]

ModEvent Gecode::Set::SingletonView::intersect ( Space & home,
int i,
int j )
inline

Update least upper bound to contain at most all elements between and including i and j.

Definition at line 154 of file singleton.hpp.

◆ intersect() [2/2]

ModEvent Gecode::Set::SingletonView::intersect ( Space & home,
int i )
inline

Update least upper bound to contain at most the element i.

Definition at line 149 of file singleton.hpp.

◆ excludeI()

template<class I >
ModEvent Gecode::Set::SingletonView::excludeI ( Space & home,
I & i )

Remove range sequence described by i from least upper bound.

Definition at line 200 of file singleton.hpp.

◆ includeI()

template<class I >
ModEvent Gecode::Set::SingletonView::includeI ( Space & home,
I & i )

Include range sequence described by i in greatest lower bound.

Definition at line 205 of file singleton.hpp.

◆ intersectI()

template<class I >
ModEvent Gecode::Set::SingletonView::intersectI ( Space & home,
I & iter )

Intersect least upper bound with range sequence described by i.

Definition at line 221 of file singleton.hpp.

◆ schedule()

void Gecode::Set::SingletonView::schedule ( Space & home,
Propagator & p,
ModEvent me )
inlinestatic

Schedule propagator p with modification event me.

Definition at line 250 of file singleton.hpp.

◆ me()

ModEvent Gecode::Set::SingletonView::me ( const ModEventDelta & med)
inlinestatic

Return modification event for view type in med.

Definition at line 254 of file singleton.hpp.

◆ med()

ModEventDelta Gecode::Set::SingletonView::med ( ModEvent me)
inlinestatic

Translate modification event me to modification event delta for view.

Definition at line 258 of file singleton.hpp.

◆ subscribe() [1/2]

void Gecode::Set::SingletonView::subscribe ( Space & home,
Propagator & p,
PropCond pc,
bool schedule = true )
inline

Subscribe propagator p with propagation condition pc to view.

In case schedule is false, the propagator is just subscribed but not scheduled for execution (this must be used when creating subscriptions during propagation).

Definition at line 226 of file singleton.hpp.

◆ cancel() [1/2]

void Gecode::Set::SingletonView::cancel ( Space & home,
Propagator & p,
PropCond pc )
inline

Cancel subscription of propagator p with propagation condition pc to view.

Definition at line 231 of file singleton.hpp.

◆ reschedule()

void Gecode::Set::SingletonView::reschedule ( Space & home,
Propagator & p,
PropCond pc )
inline

Re-schedule propagator p with propagation condition pc.

Definition at line 235 of file singleton.hpp.

◆ subscribe() [2/2]

void Gecode::Set::SingletonView::subscribe ( Space & home,
Advisor & a )
inline

Subscribe advisor a to view.

Definition at line 240 of file singleton.hpp.

◆ cancel() [2/2]

void Gecode::Set::SingletonView::cancel ( Space & home,
Advisor & a )
inline

Cancel subscription of advisor a.

Definition at line 244 of file singleton.hpp.

◆ modevent()

ModEvent Gecode::Set::SingletonView::modevent ( const Delta & d)
inlinestatic

Return modification event.

Definition at line 272 of file singleton.hpp.

◆ glbMin() [2/2]

int Gecode::Set::SingletonView::glbMin ( const Delta & d) const
inline

Return minimum value just pruned from glb.

Definition at line 277 of file singleton.hpp.

◆ glbMax() [2/2]

int Gecode::Set::SingletonView::glbMax ( const Delta & d) const
inline

Return maximum value just pruned from glb.

Definition at line 280 of file singleton.hpp.

◆ glbAny()

bool Gecode::Set::SingletonView::glbAny ( const Delta & d) const
inline

Test whether arbitrary values got pruned from glb.

Definition at line 283 of file singleton.hpp.

◆ lubMin() [2/2]

int Gecode::Set::SingletonView::lubMin ( const Delta & d) const
inline

Return minimum value just pruned from lub.

Definition at line 286 of file singleton.hpp.

◆ lubMax() [2/2]

int Gecode::Set::SingletonView::lubMax ( const Delta & d) const
inline

Return maximum value just pruned from lub.

Definition at line 289 of file singleton.hpp.

◆ lubAny()

bool Gecode::Set::SingletonView::lubAny ( const Delta & d) const
inline

Test whether arbitrary values got pruned from lub.

Definition at line 292 of file singleton.hpp.

Friends And Related Symbol Documentation

◆ operator<<()

template<class Char , class Traits >
std::basic_ostream< Char, Traits > & operator<< ( std::basic_ostream< Char, Traits > & os,
const SingletonView & x )
related

Print singleton set view.

Definition at line 63 of file print.hpp.

◆ operator==()

bool operator== ( const SingletonView & x,
const SingletonView & y )
related

Test whether views x and y are the same.

Definition at line 295 of file singleton.hpp.

◆ operator!=()

bool operator!= ( const SingletonView & x,
const SingletonView & y )
related

Test whether views x and y are the not same.

Definition at line 300 of file singleton.hpp.


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