www.pudn.com > ACE-5.3 > Based_Pointer_Repository.h, change:2002-06-30,size:2229b

// -*- C++ -*- 
 
//============================================================================= 
/** 
 *  @file    Based_Pointer_Repository.h 
 * 
 *  Based_Pointer_Repository.h,v 4.9 2002/06/30 23:55:57 schmidt Exp 
 * 
 *  @author Dietrich Quehl <Dietrich.Quehl@med.siemens.de> 
 *  @author Douglas C. Schmidt <schmidt@.cs.wustl.edu> 
 */ 
//============================================================================= 
 
#ifndef ACE_BASED_POINTER_REPOSITORY_H 
#define ACE_BASED_POINTER_REPOSITORY_H 
 
#include "ace/pre.h" 
 
#include "ace/ACE_export.h" 
 
#if !defined (ACE_LACKS_PRAGMA_ONCE) 
# pragma once 
#endif /* ACE_LACKS_PRAGMA_ONCE */ 
 
#include "ace/OS.h" 
 
// Forward decl., using the "Cheshire Cat" technique. 
class ACE_Based_Pointer_Repository_Rep; 
 
/** 
 * @class ACE_Based_Pointer_Repository 
 * 
 * @brief Maps pointers to the base address of the region to which each 
 * pointer belongs. 
 */ 
class ACE_Export ACE_Based_Pointer_Repository 
{ 
public: 
  // = Use <ACE_Null_Mutex> to allow locking while iterating. 
 
  // = Initialization and termination methods. 
  ACE_Based_Pointer_Repository (void); 
  ~ACE_Based_Pointer_Repository (void); 
 
  // = Search structure methods. 
  /** 
   * Return the appropriate <base_addr> region that contains <addr>. 
   * Returns 1 on success and 0 if the <addr> isn't contained in any 
   * <base_addr> region. 
   */ 
  int find (void *addr, 
            void *&base_addr); 
 
  /// Bind a new entry to the repository or update the size of an 
  /// existing entry.  Returns 0 on success and -1 on failure. 
  int bind (void *addr, 
            size_t size); 
 
  /// Unbind from the repository the <base_addr> that <addr> is 
  /// contained within. 
  int unbind (void *addr); 
 
private: 
 
  /// Use the "Cheshire-Cat" technique to hide the implementation in 
  /// order to avoid circular #include dependencies. 
  ACE_Based_Pointer_Repository_Rep *rep_; 
 
}; 
 
#include "ace/Singleton.h" 
 
/// Provide a Singleton access point to the based pointer repository. 
typedef ACE_Singleton<ACE_Based_Pointer_Repository, ACE_SYNCH_RW_MUTEX> 
        ACE_BASED_POINTER_REPOSITORY; 
 
#include "ace/post.h" 
 
#endif /* ACE_BASED_POINTER_REPOSITORY_H */