mirror of
https://develop.openfoam.com/Development/openfoam.git
synced 2025-11-28 03:28:01 +00:00
7b769b5035
- added STL-compatible resize() method. Should this be the primary entry point? - made [DS]LListBase end iterators private
384 lines
11 KiB
C++
384 lines
11 KiB
C++
/*---------------------------------------------------------------------------*\
|
|
========= |
|
|
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
|
|
\\ / O peration |
|
|
\\ / A nd | Copyright (C) 1991-2009 OpenCFD Ltd.
|
|
\\/ M anipulation |
|
|
-------------------------------------------------------------------------------
|
|
License
|
|
This file is part of OpenFOAM.
|
|
|
|
OpenFOAM is free software; you can redistribute it and/or modify it
|
|
under the terms of the GNU General Public License as published by the
|
|
Free Software Foundation; either version 2 of the License, or (at your
|
|
option) any later version.
|
|
|
|
OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
|
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with OpenFOAM; if not, write to the Free Software Foundation,
|
|
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
|
|
Class
|
|
Foam::StaticHashTable
|
|
|
|
Description
|
|
STL conforming hash table.
|
|
|
|
Note
|
|
Uses straight lists as underlying type.
|
|
Is slower to insert than the standard HashTable, but should be more
|
|
memory efficient and faster to access.
|
|
Explicitly does not have default size.
|
|
|
|
SourceFiles
|
|
StaticHashTableI.H
|
|
StaticHashTable.C
|
|
StaticHashTableIO.C
|
|
|
|
\*---------------------------------------------------------------------------*/
|
|
|
|
#ifndef StaticHashTable_H
|
|
#define StaticHashTable_H
|
|
|
|
#include "label.H"
|
|
#include "word.H"
|
|
#include "className.H"
|
|
#include "Xfer.H"
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
namespace Foam
|
|
{
|
|
|
|
// Forward declaration of friend functions and operators
|
|
|
|
template<class T> class List;
|
|
template<class T, class Key, class Hash> class StaticHashTable;
|
|
|
|
template<class T, class Key, class Hash> Istream& operator>>
|
|
(
|
|
Istream&,
|
|
StaticHashTable<T, Key, Hash>&
|
|
);
|
|
|
|
template<class T, class Key, class Hash> Ostream& operator<<
|
|
(
|
|
Ostream&,
|
|
const StaticHashTable<T, Key, Hash>&
|
|
);
|
|
|
|
|
|
/*---------------------------------------------------------------------------*\
|
|
Class StaticHashTableName Declaration
|
|
\*---------------------------------------------------------------------------*/
|
|
|
|
TemplateName(StaticHashTable);
|
|
|
|
|
|
/*---------------------------------------------------------------------------*\
|
|
Class StaticHashTable Declaration
|
|
\*---------------------------------------------------------------------------*/
|
|
|
|
template<class T, class Key=word, class Hash=string::hash>
|
|
class StaticHashTable
|
|
:
|
|
public StaticHashTableName
|
|
{
|
|
// Private data type for table entries
|
|
|
|
//- The lookup keys, ordered per hash value
|
|
List<List<Key> > keys_;
|
|
|
|
//- For each key the corresponding object.
|
|
List<List<T> > objects_;
|
|
|
|
//- The current number of elements in table
|
|
label nElmts_;
|
|
|
|
//- Assign a new hashed entry to a possibly already existing key
|
|
bool set(const Key&, const T& newElmt, bool protect);
|
|
|
|
public:
|
|
|
|
|
|
// Forward declaration of STL iterators
|
|
|
|
template<class TRef, class TableRef>
|
|
class Iterator;
|
|
|
|
typedef Iterator
|
|
<
|
|
T&,
|
|
StaticHashTable<T, Key, Hash>&
|
|
> iterator;
|
|
|
|
typedef Iterator
|
|
<
|
|
const T&,
|
|
const StaticHashTable<T, Key, Hash>&
|
|
> const_iterator;
|
|
|
|
|
|
// Declare friendship with the iterators
|
|
|
|
friend class Iterator
|
|
<
|
|
T&,
|
|
StaticHashTable<T, Key, Hash>&
|
|
>;
|
|
|
|
friend class Iterator
|
|
<
|
|
const T&,
|
|
const StaticHashTable<T, Key, Hash>&
|
|
>;
|
|
|
|
|
|
// Constructors
|
|
|
|
//- Construct given initial table size
|
|
StaticHashTable(const label size = 100);
|
|
|
|
//- Construct from Istream
|
|
StaticHashTable(Istream&, const label size = 100);
|
|
|
|
//- Construct as copy
|
|
StaticHashTable(const StaticHashTable<T, Key, Hash>&);
|
|
|
|
//- Construct by transferring the parameter contents
|
|
StaticHashTable(const Xfer<StaticHashTable<T, Key, Hash> >&);
|
|
|
|
// Destructor
|
|
|
|
~StaticHashTable();
|
|
|
|
|
|
// Member Functions
|
|
|
|
// Access
|
|
|
|
//- Return number of elements in table.
|
|
inline label size() const;
|
|
|
|
//- Return true if the hash table is empty
|
|
inline bool empty() const;
|
|
|
|
//- Return true if hashed entry is found in table
|
|
bool found(const Key& key) const;
|
|
|
|
//- Find and return an iterator set at the hashed entry
|
|
// If not found iterator = end()
|
|
iterator find(const Key& key);
|
|
|
|
//- Find and return an const_iterator set at the hashed entry
|
|
// If not found iterator = end()
|
|
const_iterator find(const Key& key) const;
|
|
|
|
//- Return the table of contents
|
|
List<Key> toc() const;
|
|
|
|
|
|
// Edit
|
|
|
|
//- Insert a new hashed entry
|
|
bool insert(const Key& key, const T& newElmt);
|
|
|
|
//- Assign a new hashed entry, overwriting existing entries
|
|
inline bool set(const Key&, const T& newElmt);
|
|
|
|
//- Erase an hashed entry specified by given iterator
|
|
bool erase(const iterator& it);
|
|
|
|
//- Erase an hashed entry specified by given key if in table
|
|
bool erase(const Key& key);
|
|
|
|
//- Resize the hash table for efficiency
|
|
void resize(const label newSize);
|
|
|
|
//- Remove entries in the given hash table from this hash table
|
|
// Return the number of elements removed
|
|
label erase(const StaticHashTable<T, Key, Hash>&);
|
|
|
|
//- Clear all entries from table
|
|
void clear();
|
|
|
|
//- Clear the table entries and the table itself.
|
|
// Equivalent to clear() followed by resize(1)
|
|
void clearStorage();
|
|
|
|
//- Transfer the contents of the argument table into this table
|
|
// and annull the argument table.
|
|
void transfer(StaticHashTable<T, Key, Hash>&);
|
|
|
|
//- Transfer contents to the Xfer container
|
|
inline Xfer<StaticHashTable<T, Key, Hash> > xfer();
|
|
|
|
|
|
// Member Operators
|
|
|
|
//- Find and return an hashed entry
|
|
inline T& operator[](const Key&);
|
|
|
|
//- Find and return an hashed entry
|
|
inline const T& operator[](const Key&) const;
|
|
|
|
//- Find and return an hashed entry, create it null if not present.
|
|
inline T& operator()(const Key&);
|
|
|
|
//- Assignment
|
|
void operator=(const StaticHashTable<T, Key, Hash>&);
|
|
|
|
//- Equality. Two hash tables are equal if all contents of first are
|
|
// also in second and vice versa.
|
|
bool operator==(const StaticHashTable<T, Key, Hash>&) const;
|
|
|
|
//- The opposite of the equality operation.
|
|
bool operator!=(const StaticHashTable<T, Key, Hash>&) const;
|
|
|
|
// STL type definitions
|
|
|
|
//- Type of values the StaticHashTable contains.
|
|
typedef T value_type;
|
|
|
|
//- Type that can be used for storing into StaticHashTable::value_type
|
|
// objects. This type is usually List::value_type&.
|
|
typedef T& reference;
|
|
|
|
//- Type that can be used for storing into constant
|
|
// StaticHashTable::value_type objects. This type is usually const
|
|
// StaticHashTable::value_type&.
|
|
typedef const T& const_reference;
|
|
|
|
//- The type that can represent the size of a StaticHashTable.
|
|
typedef label size_type;
|
|
|
|
|
|
// STL iterator
|
|
|
|
//- An STL iterator
|
|
template<class TRef, class TableRef>
|
|
class Iterator
|
|
{
|
|
friend class StaticHashTable;
|
|
|
|
# ifndef __INTEL_COMPILER
|
|
template<class TRef2, class TableRef2>
|
|
friend class Iterator;
|
|
# endif
|
|
|
|
// Private data
|
|
|
|
//- Reference to the StaticHashTable this is an iterator for
|
|
TableRef curHashTable_;
|
|
|
|
//- Current hash index
|
|
label hashIndex_;
|
|
|
|
//- Index of current element at hashIndex
|
|
label elementIndex_;
|
|
|
|
public:
|
|
|
|
// Constructors
|
|
|
|
//- Construct from hash table, hash index and element index
|
|
inline Iterator
|
|
(
|
|
TableRef curHashTable,
|
|
label hashIndex_,
|
|
label elementIndex_
|
|
);
|
|
|
|
//- Construct from the non-const iterator
|
|
inline Iterator(const iterator&);
|
|
|
|
|
|
// Member operators
|
|
|
|
inline void operator=(const iterator& iter);
|
|
|
|
inline bool operator==(const iterator& iter) const;
|
|
inline bool operator==(const const_iterator& iter) const;
|
|
|
|
inline bool operator!=(const iterator& iter) const;
|
|
inline bool operator!=(const const_iterator& iter) const;
|
|
|
|
inline TRef operator*();
|
|
inline TRef operator()();
|
|
|
|
inline Iterator& operator++();
|
|
inline Iterator operator++(int);
|
|
|
|
inline const Key& key();
|
|
};
|
|
|
|
|
|
//- iterator set to the beginning of the StaticHashTable
|
|
inline iterator begin();
|
|
|
|
//- iterator set to beyond the end of the StaticHashTable
|
|
inline const iterator& end();
|
|
|
|
//- const_iterator set to the beginning of the StaticHashTable
|
|
inline const_iterator cbegin() const;
|
|
|
|
//- const_iterator set to beyond the end of the StaticHashTable
|
|
inline const const_iterator& cend() const;
|
|
|
|
//- const_iterator set to the beginning of the StaticHashTable
|
|
inline const_iterator begin() const;
|
|
|
|
//- const_iterator set to beyond the end of the StaticHashTable
|
|
inline const const_iterator& end() const;
|
|
|
|
// IOstream Operator
|
|
|
|
friend Istream& operator>> <T, Key, Hash>
|
|
(
|
|
Istream&,
|
|
StaticHashTable<T, Key, Hash>&
|
|
);
|
|
|
|
friend Ostream& operator<< <T, Key, Hash>
|
|
(
|
|
Ostream&,
|
|
const StaticHashTable<T, Key, Hash>&
|
|
);
|
|
|
|
|
|
private:
|
|
|
|
//- iterator returned by end()
|
|
iterator endIter_;
|
|
|
|
//- const_iterator returned by end()
|
|
const_iterator endConstIter_;
|
|
};
|
|
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
} // End namespace Foam
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
# include "StaticHashTableI.H"
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
#ifndef NoStaticHashTableC
|
|
#ifdef NoRepository
|
|
# include "StaticHashTable.C"
|
|
#endif
|
|
#endif
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
#endif
|
|
|
|
// ************************************************************************* //
|