1// -*- C++ -*- 2 3// Copyright (C) 2005, 2006 Free Software Foundation, Inc. 4// 5// This file is part of the GNU ISO C++ Library. This library is free 6// software; you can redistribute it and/or modify it under the terms 7// of the GNU General Public License as published by the Free Software 8// Foundation; either version 2, or (at your option) any later 9// version. 10 11// This library is distributed in the hope that it will be useful, but 12// WITHOUT ANY WARRANTY; without even the implied warranty of 13// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 14// General Public License for more details. 15 16// You should have received a copy of the GNU General Public License 17// along with this library; see the file COPYING. If not, write to 18// the Free Software Foundation, 59 Temple Place - Suite 330, Boston, 19// MA 02111-1307, USA. 20 21// As a special exception, you may use this file as part of a free 22// software library without restriction. Specifically, if other files 23// instantiate templates or use macros or inline functions from this 24// file, or you compile this file and link it with other files to 25// produce an executable, this file does not by itself cause the 26// resulting executable to be covered by the GNU General Public 27// License. This exception does not however invalidate any other 28// reasons why the executable file might be covered by the GNU General 29// Public License. 30 31// Copyright (C) 2004 Ami Tavory and Vladimir Dreizin, IBM-HRL. 32 33// Permission to use, copy, modify, sell, and distribute this software 34// is hereby granted without fee, provided that the above copyright 35// notice appears in all copies, and that both that copyright notice 36// and this permission notice appear in supporting documentation. None 37// of the above authors, nor IBM Haifa Research Laboratories, make any 38// representation about the suitability of this software for any 39// purpose. It is provided "as is" without express or implied 40// warranty. 41 42/** 43 * @file sample_resize_policy.hpp 44 * Contains a sample resize policy for hash tables. 45 */ 46 47#ifndef PB_DS_SAMPLE_RESIZE_POLICY_HPP 48#define PB_DS_SAMPLE_RESIZE_POLICY_HPP 49 50// A sample resize policy. 51class sample_resize_policy 52{ 53public: 54 55 // Size type. 56 typedef size_t size_type; 57 58 // Default constructor. 59 sample_resize_policy(); 60 61 // Copy constructor. 62 sample_range_hashing(const sample_resize_policy& other); 63 64 // Swaps content. 65 inline void 66 swap(sample_resize_policy& other); 67 68protected: 69 70 // Notifies a search started. 71 inline void 72 notify_insert_search_start(); 73 74 // Notifies a search encountered a collision. 75 inline void 76 notify_insert_search_collision(); 77 78 // Notifies a search ended. 79 inline void 80 notify_insert_search_end(); 81 82 // Notifies a search started. 83 inline void 84 notify_find_search_start(); 85 86 // Notifies a search encountered a collision. 87 inline void 88 notify_find_search_collision(); 89 90 // Notifies a search ended. 91 inline void 92 notify_find_search_end(); 93 94 // Notifies a search started. 95 inline void 96 notify_erase_search_start(); 97 98 // Notifies a search encountered a collision. 99 inline void 100 notify_erase_search_collision(); 101 102 // Notifies a search ended. 103 inline void 104 notify_erase_search_end(); 105 106 // Notifies an element was inserted. 107 inline void 108 notify_inserted(size_type num_e); 109 110 // Notifies an element was erased. 111 inline void 112 notify_erased(size_type num_e); 113 114 // Notifies the table was cleared. 115 void 116 notify_cleared(); 117 118 // Notifies the table was resized to new_size. 119 void 120 notify_resized(size_type new_size); 121 122 // Queries whether a resize is needed. 123 inline bool 124 is_resize_needed() const; 125 126 // Queries what the new size should be. 127 size_type 128 get_new_size(size_type size, size_type num_used_e) const; 129}; 130 131#endif 132