Generated on Mon Aug 25 11:35:44 2008 for Gecode by doxygen 1.5.6

sentinel-stack.icc

Go to the documentation of this file.
00001 /* -*- mode: C++; c-basic-offset: 2; indent-tabs-mode: nil -*- */
00002 /*
00003  *  Main authors:
00004  *     Christian Schulte <schulte@gecode.org>
00005  *
00006  *  Copyright:
00007  *     Christian Schulte, 2006
00008  *
00009  *  Last modified:
00010  *     $Date: 2008-07-11 11:13:44 +0200 (Fri, 11 Jul 2008) $ by $Author: tack $
00011  *     $Revision: 7358 $
00012  *
00013  *  This file is part of Gecode, the generic constraint
00014  *  development environment:
00015  *     http://www.gecode.org
00016  *
00017  *  Permission is hereby granted, free of charge, to any person obtaining
00018  *  a copy of this software and associated documentation files (the
00019  *  "Software"), to deal in the Software without restriction, including
00020  *  without limitation the rights to use, copy, modify, merge, publish,
00021  *  distribute, sublicense, and/or sell copies of the Software, and to
00022  *  permit persons to whom the Software is furnished to do so, subject to
00023  *  the following conditions:
00024  *
00025  *  The above copyright notice and this permission notice shall be
00026  *  included in all copies or substantial portions of the Software.
00027  *
00028  *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
00029  *  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
00030  *  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
00031  *  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
00032  *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
00033  *  OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
00034  *  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
00035  *
00036  */
00037 
00038 namespace Gecode { namespace Support {
00039 
00052   template<class T>
00053   class SentinelStack {
00054   private:
00055 #ifndef NDEBUG
00056     unsigned int size;
00057     T* bos;
00058 #endif
00059     const T sentinel;
00060     T* tos;
00061   public:
00063     SentinelStack(T* p, T s, int n);
00065     bool empty(void) const;
00067     T top(void) const;
00069     T last(void) const;
00071     T pop(void);
00073     void push(T x);
00074   };
00075 
00076   template<class T>
00077   forceinline
00078   SentinelStack<T>::SentinelStack(T* p, T s, int n) 
00079     : 
00080 #ifndef NDEBUG
00081     size(n), bos(p),
00082 #endif
00083     sentinel(s), tos(p) {
00084     (void) n;
00085     *(tos++) = sentinel;
00086   }
00087   template<class T>
00088   forceinline bool
00089   SentinelStack<T>::empty(void) const {
00090     return *(tos-1) == sentinel;
00091   }
00092   template<class T>
00093   forceinline T
00094   SentinelStack<T>::top(void) const {
00095     assert(*(tos-1) != sentinel);
00096     return *(tos-1);
00097   }
00098   template<class T>
00099   forceinline T
00100   SentinelStack<T>::last(void) const {
00101     return *tos;
00102   }
00103   template<class T>
00104   forceinline T
00105   SentinelStack<T>::pop(void) {
00106 #ifndef NDEBUG
00107     assert(tos-bos > 1);
00108 #endif
00109     return *(--tos);
00110   }
00111   template<class T>
00112   forceinline void
00113   SentinelStack<T>::push(T x) {
00114     assert(x != sentinel);
00115 #ifndef NDEBUG
00116     assert(tos-bos < size+1);
00117 #endif
00118     *(tos++) = x;
00119   }
00120 
00121 }}
00122 
00134 #define GECODE_AUTOSTACK(T,S,X,N)                                     \
00135   int __GECODE__AS__ ## X ## __LINE__ ## n = (N); \
00136   GECODE_AUTOARRAY(T,__GECODE__AS__ ## X ## __LINE__,(__GECODE__AS__ ## X ## __LINE__ ## n) + 1);               \
00137   Gecode::Support::SentinelStack<T> X(__GECODE__AS__ ## X ## __LINE__,(S),__GECODE__AS__ ## X ## __LINE__ ## n);
00138 // STATISTICS: support-any