Generated on Thu Mar 22 10:39:55 2012 for Gecode by doxygen 1.6.3

Gecode::Int::CachedView< View > Class Template Reference
[Integer views]

Cached integer view. More...

#include <view.hpp>

List of all members.

Protected Attributes

RangeList_firstRange
 First cached range.
RangeList_lastRange
 Last cached range.
unsigned int _size
 Size of cached domain.

Related Functions

(Note that these are not member functions.)



template<class Char , class Traits , class View >
std::basic_ostream< Char,
Traits > & 
operator<< (std::basic_ostream< Char, Traits > &os, const CachedView< View > &x)
 Print integer offset view.

Constructors and initialization



 CachedView (void)
 Default constructor.
 CachedView (const View &y)
 Initialize with integer view y.

Value access



int min (void) const
 Return minimum of domain.
int max (void) const
 Return maximum of domain.
int med (void) const
 Return median of domain (greatest element not greater than the median).
int val (void) const
 Return assigned value (only if assigned).
unsigned int size (void) const
 Return size (cardinality) of domain.
unsigned int width (void) const
 Return width of domain (distance between maximum and minimum).
unsigned int regret_min (void) const
 Return regret of domain minimum (distance to next larger value).
unsigned int regret_max (void) const
 Return regret of domain maximum (distance to next smaller value).

Domain tests



bool range (void) const
 Test whether domain is a range.
bool in (int n) const
 Test whether n is contained in domain.
bool in (double n) const
 Test whether n is contained in domain.

Domain update by value



ModEvent lq (Space &home, int n)
 Restrict domain values to be less or equal than n.
ModEvent lq (Space &home, double n)
 Restrict domain values to be less or equal than n.
ModEvent le (Space &home, int n)
 Restrict domain values to be less than n.
ModEvent le (Space &home, double n)
 Restrict domain values to be less than n.
ModEvent gq (Space &home, int n)
 Restrict domain values to be greater or equal than n.
ModEvent gq (Space &home, double n)
 Restrict domain values to be greater or equal than n.
ModEvent gr (Space &home, int n)
 Restrict domain values to be greater than n.
ModEvent gr (Space &home, double n)
 Restrict domain values to be greater than n.
ModEvent nq (Space &home, int n)
 Restrict domain values to be different from n.
ModEvent nq (Space &home, double n)
 Restrict domain values to be different from n.
ModEvent eq (Space &home, int n)
 Restrict domain values to be equal to n.
ModEvent eq (Space &home, double n)
 Restrict domain values to be equal to n.

Domain update by iterator

Views can be both updated by range and value iterators. Value iterators do not need to be strict in that the same value is allowed to occur more than once in the iterated sequence.

The argument depends must be true, if the iterator passed as argument depends on the view on which the operation is invoked. In this case, the view is only updated after the iterator has been consumed. Otherwise, the domain might be updated concurrently while following the iterator.



template<class I >
ModEvent narrow_r (Space &home, I &i, bool depends=true)
 Replace domain by ranges described by i.
template<class I >
ModEvent inter_r (Space &home, I &i, bool depends=true)
 Intersect domain with ranges described by i.
template<class I >
ModEvent minus_r (Space &home, I &i, bool depends=true)
 Remove from domain the ranges described by i.
template<class I >
ModEvent narrow_v (Space &home, I &i, bool depends=true)
 Replace domain by values described by i.
template<class I >
ModEvent inter_v (Space &home, I &i, bool depends=true)
 Intersect domain with values described by i.
template<class I >
ModEvent minus_v (Space &home, I &i, bool depends=true)
 Remove from domain the values described by i.

Delta information for advisors



int min (const Delta &d) const
 Return minimum value just pruned.
int max (const Delta &d) const
 Return maximum value just pruned.
bool any (const Delta &d) const
 Test whether arbitrary values got pruned.

Domain cache operations



void initCache (Space &home, const IntSet &s)
 Initialize cache to set s.
void cache (Space &home)
 Update cache to current domain.
bool modified (void) const
 Check whether cache differs from current domain.

Cloning



void update (Space &home, bool share, CachedView< View > &y)
 Update this view to be a clone of view y.

View-dependent propagator support



static ModEventDelta med (ModEvent me)
 Translate modification event me to modification event delta for view.

View comparison



template<class View >
bool same (const CachedView< View > &x, const CachedView< View > &y)
 Test whether views x and y are the same.
template<class View >
bool before (const CachedView< View > &x, const CachedView< View > &y)
 Test whether view x comes before y (arbitrary order).

Detailed Description

template<class View>
class Gecode::Int::CachedView< View >

Cached integer view.

A cached integer view $c$ for an integer view $x$ adds operations for cacheing the current domain of $x$ and comparing the current domain to the cached domain. Cached views make it easy to implement incremental propagation algorithms.

Definition at line 1112 of file view.hpp.


Constructor & Destructor Documentation

template<class View >
Gecode::Set::CachedView< View >::CachedView ( void   )  [inline]

Default constructor.

Definition at line 46 of file cached.hpp.

template<class View>
Gecode::Set::CachedView< View >::CachedView ( const View &  y  )  [inline, explicit]

Initialize with integer view y.

Definition at line 49 of file cached.hpp.


Member Function Documentation

template<class View >
int Gecode::Int::CachedView< View >::min ( void   )  const [inline]

Return minimum of domain.

Definition at line 60 of file cached.hpp.

template<class View >
int Gecode::Int::CachedView< View >::max ( void   )  const [inline]

Return maximum of domain.

Definition at line 65 of file cached.hpp.

template<class View >
int Gecode::Int::CachedView< View >::med ( void   )  const [inline]

Return median of domain (greatest element not greater than the median).

Definition at line 70 of file cached.hpp.

template<class View >
int Gecode::Int::CachedView< View >::val ( void   )  const [inline]

Return assigned value (only if assigned).

Definition at line 75 of file cached.hpp.

template<class View >
unsigned int Gecode::Int::CachedView< View >::size ( void   )  const [inline]

Return size (cardinality) of domain.

Definition at line 86 of file cached.hpp.

template<class View >
unsigned int Gecode::Int::CachedView< View >::width ( void   )  const [inline]

Return width of domain (distance between maximum and minimum).

Definition at line 81 of file cached.hpp.

template<class View >
unsigned int Gecode::Int::CachedView< View >::regret_min ( void   )  const [inline]

Return regret of domain minimum (distance to next larger value).

Definition at line 91 of file cached.hpp.

template<class View >
unsigned int Gecode::Int::CachedView< View >::regret_max ( void   )  const [inline]

Return regret of domain maximum (distance to next smaller value).

Definition at line 96 of file cached.hpp.

template<class View >
bool Gecode::Int::CachedView< View >::range ( void   )  const [inline]

Test whether domain is a range.

Definition at line 106 of file cached.hpp.

template<class View >
bool Gecode::Int::CachedView< View >::in ( int  n  )  const [inline]

Test whether n is contained in domain.

Definition at line 111 of file cached.hpp.

template<class View >
bool Gecode::Int::CachedView< View >::in ( double  n  )  const [inline]

Test whether n is contained in domain.

Definition at line 116 of file cached.hpp.

template<class View >
ModEvent Gecode::Int::CachedView< View >::lq ( Space home,
int  n 
) [inline]

Restrict domain values to be less or equal than n.

Definition at line 127 of file cached.hpp.

template<class View >
ModEvent Gecode::Int::CachedView< View >::lq ( Space home,
double  n 
) [inline]

Restrict domain values to be less or equal than n.

Definition at line 132 of file cached.hpp.

template<class View >
ModEvent Gecode::Int::CachedView< View >::le ( Space home,
int  n 
) [inline]

Restrict domain values to be less than n.

Definition at line 137 of file cached.hpp.

template<class View >
ModEvent Gecode::Int::CachedView< View >::le ( Space home,
double  n 
) [inline]

Restrict domain values to be less than n.

Definition at line 142 of file cached.hpp.

template<class View >
ModEvent Gecode::Int::CachedView< View >::gq ( Space home,
int  n 
) [inline]

Restrict domain values to be greater or equal than n.

Definition at line 147 of file cached.hpp.

template<class View >
ModEvent Gecode::Int::CachedView< View >::gq ( Space home,
double  n 
) [inline]

Restrict domain values to be greater or equal than n.

Definition at line 152 of file cached.hpp.

template<class View >
ModEvent Gecode::Int::CachedView< View >::gr ( Space home,
int  n 
) [inline]

Restrict domain values to be greater than n.

Definition at line 157 of file cached.hpp.

template<class View >
ModEvent Gecode::Int::CachedView< View >::gr ( Space home,
double  n 
) [inline]

Restrict domain values to be greater than n.

Definition at line 162 of file cached.hpp.

template<class View >
ModEvent Gecode::Int::CachedView< View >::nq ( Space home,
int  n 
) [inline]

Restrict domain values to be different from n.

Definition at line 167 of file cached.hpp.

template<class View >
ModEvent Gecode::Int::CachedView< View >::nq ( Space home,
double  n 
) [inline]

Restrict domain values to be different from n.

Definition at line 172 of file cached.hpp.

template<class View >
ModEvent Gecode::Int::CachedView< View >::eq ( Space home,
int  n 
) [inline]

Restrict domain values to be equal to n.

Definition at line 177 of file cached.hpp.

template<class View >
ModEvent Gecode::Int::CachedView< View >::eq ( Space home,
double  n 
) [inline]

Restrict domain values to be equal to n.

Definition at line 182 of file cached.hpp.

template<class View >
template<class I >
ModEvent Gecode::Int::CachedView< View >::narrow_r ( Space home,
I &  i,
bool  depends = true 
) [inline]

Replace domain by ranges described by i.

Definition at line 194 of file cached.hpp.

template<class View >
template<class I >
ModEvent Gecode::Int::CachedView< View >::inter_r ( Space home,
I &  i,
bool  depends = true 
) [inline]

Intersect domain with ranges described by i.

Definition at line 200 of file cached.hpp.

template<class View >
template<class I >
ModEvent Gecode::Int::CachedView< View >::minus_r ( Space home,
I &  i,
bool  depends = true 
) [inline]

Remove from domain the ranges described by i.

Definition at line 206 of file cached.hpp.

template<class View >
template<class I >
ModEvent Gecode::Int::CachedView< View >::narrow_v ( Space home,
I &  i,
bool  depends = true 
) [inline]

Replace domain by values described by i.

Definition at line 212 of file cached.hpp.

template<class View >
template<class I >
ModEvent Gecode::Int::CachedView< View >::inter_v ( Space home,
I &  i,
bool  depends = true 
) [inline]

Intersect domain with values described by i.

Definition at line 218 of file cached.hpp.

template<class View >
template<class I >
ModEvent Gecode::Int::CachedView< View >::minus_v ( Space home,
I &  i,
bool  depends = true 
) [inline]

Remove from domain the values described by i.

Definition at line 224 of file cached.hpp.

template<class View >
ModEventDelta Gecode::Set::CachedView< View >::med ( ModEvent  me  )  [inline, static]

Translate modification event me to modification event delta for view.

Reimplemented from Gecode::DerivedView< View >.

Definition at line 236 of file cached.hpp.

template<class View >
int Gecode::Int::CachedView< View >::min ( const Delta d  )  const [inline]

Return minimum value just pruned.

Definition at line 247 of file cached.hpp.

template<class View >
int Gecode::Int::CachedView< View >::max ( const Delta d  )  const [inline]

Return maximum value just pruned.

Definition at line 252 of file cached.hpp.

template<class View >
bool Gecode::Int::CachedView< View >::any ( const Delta d  )  const [inline]

Test whether arbitrary values got pruned.

Definition at line 257 of file cached.hpp.

template<class View >
void Gecode::Int::CachedView< View >::initCache ( Space home,
const IntSet s 
) [inline]

Initialize cache to set s.

Definition at line 295 of file cached.hpp.

template<class View >
void Gecode::Int::CachedView< View >::cache ( Space home  )  [inline]

Update cache to current domain.

Definition at line 307 of file cached.hpp.

template<class View >
bool Gecode::Int::CachedView< View >::modified ( void   )  const [inline]

Check whether cache differs from current domain.

Definition at line 324 of file cached.hpp.

template<class View>
void Gecode::Set::CachedView< View >::update ( Space home,
bool  share,
CachedView< View > &  y 
) [inline]

Update this view to be a clone of view y.

Definition at line 269 of file cached.hpp.


Friends And Related Function Documentation

template<class Char , class Traits , class View >
std::basic_ostream< Char, Traits > & operator<< ( std::basic_ostream< Char, Traits > &  os,
const CachedView< View > &  x 
) [related]

Print integer offset view.

Print cached set view.

Definition at line 112 of file print.hpp.

template<class View >
bool same ( const CachedView< View > &  x,
const CachedView< View > &  y 
) [related]

Test whether views x and y are the same.

Definition at line 389 of file cached.hpp.

template<class View >
bool before ( const CachedView< View > &  x,
const CachedView< View > &  y 
) [related]

Test whether view x comes before y (arbitrary order).

Definition at line 394 of file cached.hpp.


Member Data Documentation

template<class View>
RangeList* Gecode::Int::CachedView< View >::_firstRange [protected]

First cached range.

Definition at line 1117 of file view.hpp.

template<class View>
RangeList* Gecode::Int::CachedView< View >::_lastRange [protected]

Last cached range.

Definition at line 1119 of file view.hpp.

template<class View>
unsigned int Gecode::Int::CachedView< View >::_size [protected]

Size of cached domain.

Definition at line 1121 of file view.hpp.


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