00001 /* ///////////////////////////////////////////////////////////////////////// 00002 * File: stlsoft/synch/checkout_token.hpp 00003 * 00004 * Purpose: Scoped thread-safe access locking class. 00005 * 00006 * Created: 7th November 2004 00007 * Updated: 10th August 2009 00008 * 00009 * Home: http://stlsoft.org/ 00010 * 00011 * Copyright (c) 2004-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 00048 #ifndef STLSOFT_INCL_STLSOFT_SYNCH_HPP_CHECKOUT_TOKEN 00049 #define STLSOFT_INCL_STLSOFT_SYNCH_HPP_CHECKOUT_TOKEN 00050 00051 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION 00052 # define STLSOFT_VER_STLSOFT_SYNCH_HPP_CHECKOUT_TOKEN_MAJOR 2 00053 # define STLSOFT_VER_STLSOFT_SYNCH_HPP_CHECKOUT_TOKEN_MINOR 0 00054 # define STLSOFT_VER_STLSOFT_SYNCH_HPP_CHECKOUT_TOKEN_REVISION 2 00055 # define STLSOFT_VER_STLSOFT_SYNCH_HPP_CHECKOUT_TOKEN_EDIT 21 00056 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */ 00057 00058 /* ///////////////////////////////////////////////////////////////////////// 00059 * Includes 00060 */ 00061 00062 #ifndef STLSOFT_INCL_STLSOFT_H_STLSOFT 00063 # include <stlsoft/stlsoft.h> 00064 #endif /* !STLSOFT_INCL_STLSOFT_H_STLSOFT */ 00065 #ifndef STLSOFT_INCL_STLSOFT_SYNCH_HPP_LOCK_SCOPE 00066 # include <stlsoft/synch/lock_scope.hpp> 00067 #endif /* !STLSOFT_INCL_STLSOFT_SYNCH_HPP_LOCK_SCOPE */ 00068 00069 /* ///////////////////////////////////////////////////////////////////////// 00070 * Namespace 00071 */ 00072 00073 #ifndef _STLSOFT_NO_NAMESPACE 00074 namespace stlsoft 00075 { 00076 #endif /* _STLSOFT_NO_NAMESPACE */ 00077 00078 /* ///////////////////////////////////////////////////////////////////////// 00079 * Classes 00080 */ 00081 00113 template< ss_typename_param_k CT 00114 , ss_typename_param_k MT 00115 > 00116 class checkout_token 00117 { 00120 public: 00122 typedef CT accessed_class_type; 00124 typedef MT accessed_member_type; 00126 typedef checkout_token<CT, MT> class_type; 00128 00131 public: 00133 checkout_token(accessed_class_type& ac, accessed_member_type am) 00134 : m_ac(ac) 00135 , m_am(am) 00136 , m_lock(ac) 00137 {} 00139 checkout_token(class_type const& rhs) 00140 : m_ac(rhs.m_ac) 00141 , m_am(rhs.m_am) 00142 , m_lock(rhs.m_ac) 00143 {} 00145 00148 public: 00149 accessed_member_type member() 00150 { 00151 return m_am; 00152 } 00153 00154 #if 0 00155 accessed_member_type *operator ->() 00156 { 00157 return &m_am; 00158 } 00159 accessed_member_type const* operator ->() const 00160 { 00161 return &m_am; 00162 } 00163 #endif /* 0 */ 00165 00168 private: 00169 typedef lock_scope<accessed_class_type> lock_type; 00170 00171 accessed_class_type &m_ac; 00172 accessed_member_type m_am; 00173 lock_type m_lock; 00175 00178 private: 00179 class_type& operator =(class_type const&); 00181 }; 00182 00183 /* ////////////////////////////////////////////////////////////////////// */ 00184 00185 #ifndef _STLSOFT_NO_NAMESPACE 00186 } // namespace stlsoft 00187 #endif /* _STLSOFT_NO_NAMESPACE */ 00188 00189 /* ////////////////////////////////////////////////////////////////////// */ 00190 00191 #endif /* !STLSOFT_INCL_STLSOFT_SYNCH_HPP_CHECKOUT_TOKEN */ 00192 00193 /* ///////////////////////////// end of file //////////////////////////// */