/usr/include/NTL/LazyTable.h is in libntl-dev 9.9.1-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 | #ifndef NTL_LazyTable__H
#define NTL_LazyTable__H
#include <NTL/tools.h>
#include <NTL/SmartPtr.h>
#include <NTL/thread.h>
NTL_OPEN_NNS
/***************************************************************************
LazyTable<T,MAX>: template class for lazy initialization of objects whose
values do not change after initialization.
In a multi-threaded environment, this makes use of "double checked locking"
for an efficient, thread-safe solution.
Usage:
LazyTable<T,MAX> tab; // declaration of the lazy table, with max size == MAX
...
do {
LazyTable<T,MAX>::Builder builder(tab, n); // request length n
long amt = builder.amt();
if (!amt) break;
... initialize elements i = n-amt..n-1
using builder.move(p), where p is a UnqiuePtr<T>
note that each move application appends one element
} while(0); // When this scope closes,
// the table is fully initialized to length n
const T* val = table[i]; // read-only access to table elements 0..n-1
It is important to follow this recipe carefully. In particular,
the builder must be enclosed in a scope, as it's destructor
plays a crucial role in finalizing the initialization.
template<class T, long MAX>
class LazyTable {
public:
LazyTable();
const T * operator[] (long i) const;
~LazyTable();
long length() const;
class Builder {
Builder(const LazyTable&, long request);
~Builder()
long amt() const;
void move(UniquePtr<T>& p);
private:
LazyTable(const LazyTable&); // disabled
LazyTable& operator=(const LazyTable&);
};
****************************************************************************/
// NOTE: For more on double-checked locking, see
// http://preshing.com/20130930/double-checked-locking-is-fixed-in-cpp11/
// NOTE: when compiled with the NTL_THREADS option, the LazyTable
// class may contain data members from the standard library
// that may not satisfy the requirements of the Vec class
// (i.e., relocatability). One can wrap it in a pointer
// class (e.g., OptionalVal) to deal with this.
template<class T, long MAX>
class LazyTable {
private:
mutable AtomicLong len;
mutable MutexProxy mtx;
mutable UniqueArray< UniquePtr<T> > data;
LazyTable(const LazyTable&); // disabled
void operator=(const LazyTable&); // disabled
public:
LazyTable() : len(0) { }
const T * operator[] (long i) const
{
// FIXME: add optional range checking
return data[i].get();
}
long length() const { return len; }
class Builder {
private:
const LazyTable& ref;
long request;
GuardProxy guard;
long amount;
long curlen;
Builder(const Builder&); // disabled
void operator=(const Builder&); // disabled
public:
Builder(const LazyTable& _ref, long _request)
: ref(_ref), request(_request), guard(_ref.mtx), amount(0), curlen(0)
{
if (request < 0 || request > MAX)
LogicError("request out of range in LazyTable::Builder");
// Double-checked locking
if (request <= ref.len || (guard.lock(), request <= ref.len))
return;
curlen = ref.len;
amount = request - curlen;
if (!ref.data) ref.data.SetLength(MAX);
}
~Builder() { if (amount) ref.len = curlen; }
void move(UniquePtr<T>& p)
{
if (!amount || curlen >= request) LogicError("LazyTable::Builder illegal move");
ref.data[curlen].move(p);
curlen++;
}
long amt() const { return amount; }
};
};
NTL_CLOSE_NNS
#endif
|