00001 /* ///////////////////////////////////////////////////////////////////////// 00002 * File: stlsoft/synch/lock_scope.hpp (originally MLLock.h, ::SynesisStd) 00003 * 00004 * Purpose: Synchronisation object lock scoping class. 00005 * 00006 * Created: 1st October 1994 00007 * Updated: 10th August 2009 00008 * 00009 * Home: http://stlsoft.org/ 00010 * 00011 * Copyright (c) 1994-2009, Matthew Wilson and Synesis Software 00012 * All rights reserved. 00013 * 00014 * Redistribution and use in source and binary forms, with or without 00015 * modification, are permitted provided that the following conditions are met: 00016 * 00017 * - Redistributions of source code must retain the above copyright notice, this 00018 * list of conditions and the following disclaimer. 00019 * - Redistributions in binary form must reproduce the above copyright notice, 00020 * this list of conditions and the following disclaimer in the documentation 00021 * and/or other materials provided with the distribution. 00022 * - Neither the name(s) of Matthew Wilson and Synesis Software nor the names of 00023 * any contributors may be used to endorse or promote products derived from 00024 * this software without specific prior written permission. 00025 * 00026 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 00027 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 00028 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 00029 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 00030 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 00031 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 00032 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 00033 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 00034 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 00035 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 00036 * POSSIBILITY OF SUCH DAMAGE. 00037 * 00038 * ////////////////////////////////////////////////////////////////////// */ 00039 00040 00047 #ifndef STLSOFT_INCL_STLSOFT_SYNCH_HPP_LOCK_SCOPE 00048 #define STLSOFT_INCL_STLSOFT_SYNCH_HPP_LOCK_SCOPE 00049 00050 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION 00051 # define STLSOFT_VER_STLSOFT_SYNCH_HPP_LOCK_SCOPE_MAJOR 6 00052 # define STLSOFT_VER_STLSOFT_SYNCH_HPP_LOCK_SCOPE_MINOR 0 00053 # define STLSOFT_VER_STLSOFT_SYNCH_HPP_LOCK_SCOPE_REVISION 1 00054 # define STLSOFT_VER_STLSOFT_SYNCH_HPP_LOCK_SCOPE_EDIT 112 00055 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */ 00056 00057 /* ///////////////////////////////////////////////////////////////////////// 00058 * Includes 00059 */ 00060 00061 #ifndef STLSOFT_INCL_STLSOFT_H_STLSOFT 00062 # include <stlsoft/stlsoft.h> 00063 #endif /* !STLSOFT_INCL_STLSOFT_H_STLSOFT */ 00064 00065 /* ///////////////////////////////////////////////////////////////////////// 00066 * Namespace 00067 */ 00068 00069 #ifndef _STLSOFT_NO_NAMESPACE 00070 namespace stlsoft 00071 { 00072 #endif /* _STLSOFT_NO_NAMESPACE */ 00073 00074 /* ///////////////////////////////////////////////////////////////////////// 00075 * Classes 00076 */ 00077 00078 // class lock_traits 00079 00086 template<ss_typename_param_k L> 00087 struct lock_traits 00088 { 00091 public: 00093 typedef L lock_type; 00095 typedef lock_traits<L> class_type; 00097 00100 public: 00102 static void lock(lock_type &c) 00103 { 00104 lock_instance(c); 00105 } 00106 00108 static void unlock(lock_type &c) 00109 { 00110 unlock_instance(c); 00111 } 00113 }; 00114 00115 // class lock_invert_traits 00116 00123 template<ss_typename_param_k L> 00124 struct lock_invert_traits 00125 { 00128 public: 00130 typedef L lock_type; 00132 typedef lock_invert_traits<L> class_type; 00134 00137 public: 00139 static void lock(lock_type &c) 00140 { 00141 unlock_instance(c); 00142 } 00143 00145 static void unlock(lock_type &c) 00146 { 00147 lock_instance(c); 00148 } 00150 }; 00151 00152 // class lock_traits_inverter 00153 00160 template<ss_typename_param_k T> 00161 struct lock_traits_inverter 00162 { 00165 public: 00167 typedef T traits_type; 00169 typedef ss_typename_type_k traits_type::lock_type lock_type; 00171 typedef lock_traits_inverter<T> class_type; 00173 00176 public: 00178 static void lock(lock_type &c) 00179 { 00180 traits_type::unlock(c); 00181 } 00182 00184 static void unlock(lock_type &c) 00185 { 00186 traits_type::lock(c); 00187 } 00189 }; 00190 00191 // class lock_scope 00192 00200 template< ss_typename_param_k L 00201 #ifdef STLSOFT_CF_TEMPLATE_CLASS_DEFAULT_CLASS_ARGUMENT_SUPPORT 00202 , ss_typename_param_k T = lock_traits<L> 00203 #else /* ? STLSOFT_CF_TEMPLATE_CLASS_DEFAULT_CLASS_ARGUMENT_SUPPORT */ 00204 , ss_typename_param_k T 00205 #endif /* STLSOFT_CF_TEMPLATE_CLASS_DEFAULT_CLASS_ARGUMENT_SUPPORT */ 00206 > 00207 class lock_scope 00208 { 00211 public: 00213 typedef L lock_type; 00215 typedef T traits_type; 00217 typedef lock_scope<L, T> class_type; 00219 00222 public: 00224 lock_scope(lock_type &l) 00225 : m_l(l) 00226 { 00227 traits_type::lock(m_l); 00228 } 00230 ~lock_scope() stlsoft_throw_0() 00231 { 00232 traits_type::unlock(m_l); 00233 } 00235 00238 private: 00239 lock_type &m_l; 00241 00244 private: 00245 lock_scope(class_type const& rhs); 00246 lock_scope& operator =(class_type const& rhs); 00248 }; 00249 00250 /* ////////////////////////////////////////////////////////////////////// */ 00251 00252 #ifndef _STLSOFT_NO_NAMESPACE 00253 } // namespace stlsoft 00254 #endif /* _STLSOFT_NO_NAMESPACE */ 00255 00256 /* ////////////////////////////////////////////////////////////////////// */ 00257 00258 #endif /* !STLSOFT_INCL_STLSOFT_SYNCH_HPP_LOCK_SCOPE */ 00259 00260 /* ///////////////////////////// end of file //////////////////////////// */