1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129
|
/* Ergo, version 3.5, a program for linear scaling electronic structure
* calculations.
* Copyright (C) 2016 Elias Rudberg, Emanuel H. Rubensson, Pawel Salek,
* and Anastasia Kruchinina.
*
* This program 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 3 of the License, or
* (at your option) any later version.
*
* This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
*
* Primary academic reference:
* KohnâSham Density Functional Theory Electronic Structure Calculations
* with Linearly Scaling Computational Time and Memory Usage,
* Elias Rudberg, Emanuel H. Rubensson, and Pawel Salek,
* J. Chem. Theory Comput. 7, 340 (2011),
* <http://dx.doi.org/10.1021/ct100611z>
*
* For further information about Ergo, see <http://www.ergoscf.org>.
*/
/** @file ValidPtr.h Smart pointer class to control access to object.
*
* Copyright(c) Emanuel Rubensson 2006
*
* @author Emanuel Rubensson @a responsible @a author
* @date November 2006
*
*/
#ifndef MAT_VALIDPTR
#define MAT_VALIDPTR
namespace mat {
/** Smart pointer class to control access to object
*
* Primary use:
* Control access to objects that may be written to file.
*
*/
template <typename Tobj>
class ValidPtr {
public:
/** Copy ordinary pointer constructor */
explicit ValidPtr(Tobj * p)
: ptr(p), inMemory(true), haveDataStructure(false){}
~ValidPtr() {
delete ptr;
}
/* Pointer can not be changed only object pointed to.
* Therefore this is a const operation.
* Note that if Tobj is const it can not be changed of course.
*/
Tobj & operator*() const {
if (!inMemory)
throw Failure("ValidPtr::operator*() const: "
"Attempt to access invalid object. "
"Object is on file.");
if (!haveDataStructure)
throw Failure("ValidPtr::operator*() const: "
"Attempt to access invalid object. "
"Do not have data structure.");
return *ptr;
}
Tobj * operator->() const {
if (!inMemory)
throw Failure("ValidPtr::operator->() const: "
"Attempt to access invalid pointer."
"Object is on file.");
if (!haveDataStructure)
throw Failure("ValidPtr::operator->() const: "
"Attempt to access invalid pointer. "
"Do not have data structure.");
return ptr;
}
/** getConstRefForCopying() is provided to make it possible to
copy the object also when it is written to file. */
const Tobj & getConstRefForCopying() const {
return *ptr;
}
inline void inMemorySet(bool val) {
inMemory = val;
}
inline bool inMemoryGet() const {
return inMemory;
}
inline void haveDataStructureSet(bool val) {
haveDataStructure = val;
}
inline bool haveDataStructureGet() const {
return haveDataStructure;
}
static void swap( ValidPtr<Tobj> & ptrA, ValidPtr<Tobj> & ptrB ) {
// For the moment, we do not allow swapping ptrs with objs
// written to file. This could be a feature to add but would
// require swapping filenames.
if ( !ptrA.inMemoryGet() || !ptrB.inMemoryGet() )
throw "Swap called for objects not in memory";
if ( !ptrA.haveDataStructureGet() || !ptrB.haveDataStructureGet() )
throw "Swap called for objects without data structure";
Tobj * tmpPtr = ptrA.ptr;
ptrA.ptr = ptrB.ptr;
ptrB.ptr = tmpPtr;
}
protected:
Tobj * ptr;
/** Access to ptr forbidden if inMemory is false */
bool inMemory;
/** Access to ptr forbidden if haveDataStructure is false */
bool haveDataStructure;
private:
ValidPtr<Tobj>(ValidPtr<Tobj> const &) {}
ValidPtr<Tobj>& operator=(ValidPtr<Tobj> const &) {}
};
} /* end namespace mat */
#endif
|