/usr/include/wvstreams/pwvstream.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 | /* -*- Mode: C++ -*-
* Worldvisions Weaver Software:
* Copyright (C) 1997-2002 Net Integration Technologies, Inc.
*/
#ifndef __PWVSTREAM_H
#define __PWVSTREAM_H
#include "iwvstream.h"
#include "wvstream.h" // FIXME: don't include this!
#include "wvstreamclone.h" // FIXME: don't include this!
#include "wvmoniker.h"
#include "wvtr1.h"
/**
* PWvStream is a smart pointer to an IWvStream object. It is designed for
* maximum ABI-stability. Even though individual WvStream-derived classes
* might change their size and object layout, if you create, destroy, and
* access them using PWvStream and IWvStream, you should be safe.
*
* Note that this class is entirely inlined. PWvStream's object layout may
* change at any time, so you shouldn't pass it around between modules; pass
* around IWvStream objects instead (perhaps from PWvStream::addRef()). That
* way people using two different versions of PWvStream will still be able
* to interoperate.
*
* FIXME:
* PWvStream is incomplete, so it does not yet give the required level of ABI
* stability. Things to do:
*
* - Remove all references to classes, using only interfaces. That means
* no WvStream or WvStreamClone, only IWvStream. IWvStream might have
* to change (or introduce a new IWvBufStream) to make this work.
*
* - Definitely don't rely on C++ RTTI here.
*/
class PWvStream : public wv::shared_ptr<WvStream>
{
static WvStream *clean_stream(IWvStream *s)
{
WvStream *ss = dynamic_cast<WvStream *>(s);
if (ss)
return ss;
else
return new WvStreamClone(s);
}
static WvStream *make_stream(WvStringParm moniker, IObject *obj)
{
IWvStream *s = IWvStream::create(moniker, obj);
if (!s)
s = wvcreate<IWvStream>("null:");
assert(s != NULL);
return clean_stream(s);
}
public:
PWvStream()
{
// Pointer points to NULL right now, but it could be reassigned
// later using operator=().
}
PWvStream(IWvStream *s)
: wv::shared_ptr<WvStream>(clean_stream(s),
wv::bind(&IWvStream::release, _1))
{
}
PWvStream(WvStringParm moniker, IObject *obj = 0)
: wv::shared_ptr<WvStream>(make_stream(moniker, obj),
wv::bind(&IWvStream::release, _1))
{
// Note: pointer is definitely not NULL here, because make_stream is
// careful.
}
WvStream *addRef() const
{
if (get())
get()->addRef();
return get();
}
};
#endif // __PWVSTREAM_H
|