/usr/include/wvstreams/xplc/ptr.h is in libwvstreams-dev 4.6.1-12~deb9u1.
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 | /* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
*
* XPLC - Cross-Platform Lightweight Components
* Copyright (C) 2002-2004, Pierre Phaneuf
* Copyright (C) 2002-2004, Net Integration Technologies, Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public License
* as published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
* USA
*
* As a special exception, you may use this file as part of a free
* software library without restriction. Specifically, if other files
* instantiate templates or use macros or inline functions from this
* file, or you compile this file and link it with other files to
* produce an executable, this file does not by itself cause the
* resulting executable to be covered by the GNU Lesser General Public
* License. This exception does not however invalidate any other
* reasons why the executable file might be covered by the GNU Lesser
* General Public License.
*/
#ifndef __XPLC_PTR_H__
#define __XPLC_PTR_H__
#if defined(__GNUC__) && __GNUC__ > 3
# pragma GCC system_header
#endif
/** \file
*
* Smart pointer for XPLC interfaces.
*/
#include <xplc/IObject.h>
#ifndef UNSTABLE
#error "xplc_ptr is experimental!"
#endif
/**
* Smart pointer class for XPLC interfaces.
*/
template<class T>
class xplc_ptr {
private:
T* ptr;
class ProtectedPtr: public T {
private:
virtual unsigned int addRef() = 0;
virtual unsigned int release() = 0;
#ifndef __XPLC_DELETE_H__
void operator delete(void*);
#endif
};
xplc_ptr& operator=(const xplc_ptr&);
public:
xplc_ptr():
ptr(0) {
}
/**
* Construct an xplc_ptr from a raw pointer. This is the only way
* that an xplc_ptr will take ownership of an interface from its
* previous owner.
*/
explicit xplc_ptr(T* aObj):
ptr(aObj) {
}
/**
* Construct an xplc_ptr from another xplc_ptr. This will addRef the
* interface, if the xplc_ptr is non-NULL.
*/
template<class P>
explicit xplc_ptr(const xplc_ptr<P>& aObj):
ptr(aObj) {
if(ptr)
ptr->addRef();
}
~xplc_ptr() {
if(ptr)
ptr->release();
}
/**
* Provide an operator->. This allows you to invoke methods on the
* interface pointed at by the xplc_ptr. As with a raw pointer, if
* the xplc_ptr is NULL, this will cause a crash. The interface is
* wrapped in some basic protection, to avoid accidental addRef or
* release.
*/
ProtectedPtr* operator->() const {
return static_cast<ProtectedPtr*>(ptr);
}
/**
* Provide an operator*. This is so you can use "*foo" with an
* xplc_ptr like you could with the raw pointer. It also applies
* some basic protection.
*/
operator ProtectedPtr*() const {
return static_cast<ProtectedPtr*>(ptr);
}
/**
* Assign a raw pointer to an xplc_ptr. This will addRef the
* interface, and release the interface previously pointed at by the
* xplc_ptr, if any.
*/
xplc_ptr& operator=(T* _ptr) {
if(_ptr)
_ptr->addRef();
if(ptr)
ptr->release();
ptr = _ptr;
return *this;
}
};
/**
* Used to addRef an object before passing it to something that would
* otherwise "steal" the reference.
*/
template<class T>
T* do_addRef(T* obj) {
if (obj)
obj->addRef();
return obj;
}
#endif /* __XPLC_PTR_H__ */
|