/usr/include/ql/utilities/disposable.hpp is in libquantlib0-dev 1.4-2+b1.
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 | /* -*- mode: c++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
Copyright (C) 2003 RiskMap srl
This file is part of QuantLib, a free-software/open-source library
for financial quantitative analysts and developers - http://quantlib.org/
QuantLib is free software: you can redistribute it and/or modify it
under the terms of the QuantLib license. You should have received a
copy of the license along with this program; if not, please email
<quantlib-dev@lists.sf.net>. The license is also available online at
<http://quantlib.org/license.shtml>.
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 license for more details.
*/
/*! \file disposable.hpp
\brief generic disposable object with move semantics
*/
#ifndef quantlib_disposable_hpp
#define quantlib_disposable_hpp
#include <ql/qldefines.hpp>
namespace QuantLib {
//! generic disposable object with move semantics
/*! This class can be used for returning a value by copy. It relies
on the returned object exposing a <tt>swap(T\&)</tt> method through
which the copy constructor and assignment operator are implemented,
thus resulting in actual move semantics. Typical use of this
class is along the following lines:
\code
Disposable<Foo> bar(Integer i) {
Foo f(i*2);
return f;
}
\endcode
\warning In order to avoid copies in code such as shown above,
the conversion from <tt>T</tt> to <tt>Disposable\<T\></tt>
is destructive, i.e., it does <b>not</b> preserve the
state of the original object. Therefore, it is necessary
for the developer to avoid code such as
\code
Disposable<Foo> bar(Foo& f) {
return f;
}
\endcode
which would likely render the passed object unusable.
The correct way to obtain the desired behavior would be:
\code
Disposable<Foo> bar(Foo& f) {
Foo temp = f;
return temp;
}
\endcode
*/
template <class T>
class Disposable : public T {
public:
Disposable(T& t);
Disposable(const Disposable<T>& t);
Disposable<T>& operator=(const Disposable<T>& t);
};
// inline definitions
template <class T>
inline Disposable<T>::Disposable(T& t) {
this->swap(t);
}
template <class T>
inline Disposable<T>::Disposable(const Disposable<T>& t) : T() {
this->swap(const_cast<Disposable<T>&>(t));
}
template <class T>
inline Disposable<T>& Disposable<T>::operator=(const Disposable<T>& t) {
this->swap(const_cast<Disposable<T>&>(t));
return *this;
}
}
#endif
|