WvStreams
|
Public Member Functions | |
WvListener (IWvStream *_cloned) | |
virtual void | addwrap (IWvListenerWrapper _wrapper) |
Add a wrapper function for this stream: something that accept() will call to possibly wrap the stream from accept() before returning it. | |
virtual IWvListenerCallback | onaccept (IWvListenerCallback _cb) |
Set a user-defined function to be called when a new connection is available. | |
IWvStream * | wrap (IWvStream *s) |
void | runonce (time_t msec_delay) |
virtual void | close () |
virtual bool | isok () const |
By default, returns true if geterr() == 0. | |
virtual void | callback () |
int | getfd () const |
virtual int | getrfd () const |
virtual int | getwfd () const |
virtual const WvAddr * | src () const |
virtual void | pre_select (SelectInfo &si) |
virtual bool | post_select (SelectInfo &si) |
virtual size_t | read (void *buf, size_t count) |
virtual size_t | write (const void *buf, size_t count) |
virtual size_t | read (WvBuf &outbuf, size_t count) |
virtual size_t | write (WvBuf &inbuf, size_t count=INT_MAX) |
virtual void | noread () |
Shuts down the reading side of the stream. | |
virtual void | nowrite () |
Shuts down the writing side of the stream. | |
virtual void | maybe_autoclose () |
Auto-close the stream if the time is right. | |
virtual bool | isreadable () |
Returns true if the stream is readable. | |
virtual bool | iswritable () |
Returns true if the stream is writable (without using the outbuf). | |
virtual bool | flush (time_t msec_timeout) |
flush the output buffer, if we can do it without delaying more than msec_timeout milliseconds at a time. | |
virtual bool | should_flush () |
Returns true if we want to flush the output buffer right now. | |
virtual IWvStreamCallback | setreadcallback (IWvStreamCallback _cb) |
Sets a callback to be invoked when the stream is readable. | |
virtual IWvStreamCallback | setwritecallback (IWvStreamCallback _cb) |
Sets a callback to be invoked when the stream is writable. | |
virtual IWvStreamCallback | setexceptcallback (IWvStreamCallback _cb) |
Sets a callback to be invoked when the stream is in exception state. | |
virtual IWvStreamCallback | setclosecallback (IWvStreamCallback _cb) |
Sets a callback to be invoked on close(). | |
virtual const char * | wsname () const |
virtual void | set_wsname (WvStringParm name) |
void | set_wsname (WVSTRING_FORMAT_DECL) |
virtual const char * | wstype () const |
virtual WSID | wsid () const |
virtual void | outbuf_limit (size_t size) |
set the maximum size of outbuf, beyond which a call to write() will return 0. | |
virtual WvString | getattr (WvStringParm name) const |
WvListener (IWvStream *_cloned) | |
virtual void | addwrap (IWvListenerWrapper _wrapper) |
Add a wrapper function for this stream: something that accept() will call to possibly wrap the stream from accept() before returning it. | |
virtual IWvListenerCallback | onaccept (IWvListenerCallback _cb) |
Set a user-defined function to be called when a new connection is available. | |
IWvStream * | wrap (IWvStream *s) |
void | runonce (time_t msec_delay) |
virtual void | close () |
virtual bool | isok () const |
By default, returns true if geterr() == 0. | |
virtual void | callback () |
int | getfd () const |
virtual int | getrfd () const |
virtual int | getwfd () const |
virtual const WvAddr * | src () const |
virtual void | pre_select (SelectInfo &si) |
virtual bool | post_select (SelectInfo &si) |
virtual size_t | read (void *buf, size_t count) |
virtual size_t | write (const void *buf, size_t count) |
virtual size_t | read (WvBuf &outbuf, size_t count) |
virtual size_t | write (WvBuf &inbuf, size_t count=INT_MAX) |
virtual void | noread () |
Shuts down the reading side of the stream. | |
virtual void | nowrite () |
Shuts down the writing side of the stream. | |
virtual void | maybe_autoclose () |
Auto-close the stream if the time is right. | |
virtual bool | isreadable () |
Returns true if the stream is readable. | |
virtual bool | iswritable () |
Returns true if the stream is writable (without using the outbuf). | |
virtual bool | flush (time_t msec_timeout) |
flush the output buffer, if we can do it without delaying more than msec_timeout milliseconds at a time. | |
virtual bool | should_flush () |
Returns true if we want to flush the output buffer right now. | |
virtual IWvStreamCallback | setreadcallback (IWvStreamCallback _cb) |
Sets a callback to be invoked when the stream is readable. | |
virtual IWvStreamCallback | setwritecallback (IWvStreamCallback _cb) |
Sets a callback to be invoked when the stream is writable. | |
virtual IWvStreamCallback | setexceptcallback (IWvStreamCallback _cb) |
Sets a callback to be invoked when the stream is in exception state. | |
virtual IWvStreamCallback | setclosecallback (IWvStreamCallback _cb) |
Sets a callback to be invoked on close(). | |
virtual const char * | wsname () const |
virtual void | set_wsname (WvStringParm name) |
void | set_wsname (WVSTRING_FORMAT_DECL) |
virtual const char * | wstype () const |
virtual WSID | wsid () const |
virtual void | outbuf_limit (size_t size) |
set the maximum size of outbuf, beyond which a call to write() will return 0. | |
virtual WvString | getattr (WvStringParm name) const |
virtual IWvStream * | accept ()=0 |
Accept a connection from this stream. | |
virtual IWvStream * | accept ()=0 |
Accept a connection from this stream. | |
virtual int | geterr () const |
If isok() is false, return the system error number corresponding to the error, -1 for a special error string (which you can obtain with errstr()) or 0 on end of file. | |
virtual int | geterr () const |
If isok() is false, return the system error number corresponding to the error, -1 for a special error string (which you can obtain with errstr()) or 0 on end of file. | |
virtual WvString | errstr () const |
virtual WvString | errstr () const |
virtual void | seterr (int _errnum) |
Set the errnum variable – we have an error. | |
void | seterr (WvStringParm specialerr) |
void | seterr (WVSTRING_FORMAT_DECL) |
void | seterr (const WvErrorBase &err) |
virtual void | seterr (int _errnum) |
Set the errnum variable – we have an error. | |
void | seterr (WvStringParm specialerr) |
void | seterr (WVSTRING_FORMAT_DECL) |
void | seterr (const WvErrorBase &err) |
void | seterr_both (int _errnum, WvStringParm specialerr) |
void | seterr_both (int _errnum, WVSTRING_FORMAT_DECL) |
void | seterr_both (int _errnum, WvStringParm specialerr) |
void | seterr_both (int _errnum, WVSTRING_FORMAT_DECL) |
void | noerr () |
Reset our error state - there's no error condition anymore. | |
void | noerr () |
Reset our error state - there's no error condition anymore. | |
virtual unsigned int | addRef ()=0 |
Indicate you are using this object. | |
virtual unsigned int | addRef ()=0 |
Indicate you are using this object. | |
virtual unsigned int | release ()=0 |
Indicate that you are finished using this object. | |
virtual unsigned int | release ()=0 |
Indicate that you are finished using this object. | |
virtual IObject * | getInterface (const UUID &)=0 |
Returns the requested XPLC interface. | |
virtual IObject * | getInterface (const UUID &)=0 |
Returns the requested XPLC interface. | |
virtual IWeakRef * | getWeakRef ()=0 |
Return a weak reference to this object. | |
virtual IWeakRef * | getWeakRef ()=0 |
Return a weak reference to this object. | |
Static Public Member Functions | |
static IWvListener * | create (WvString moniker, IObject *obj=NULL) |
static IWvListener * | create (WvString moniker, IObject *obj=NULL) |
static IWvStream * | create (WvStringParm moniker, IObject *obj=NULL) |
static WvString | strerror (int errnum) |
A replacement for the operating system strerror() function that can map more kinds of error strings (especially in win32). | |
static WvString | strerror (int errnum) |
A replacement for the operating system strerror() function that can map more kinds of error strings (especially in win32). | |
Public Attributes | |
IWvStream * | cloned |
IWvListenerCallback | acceptor |
IWvListenerWrapper | wrapper |
Protected Attributes | |
int | errnum |
WvString | errstring |
Definition at line 15 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
WvListener::WvListener | ( | IWvStream * | _cloned | ) |
Definition at line 32 of file wvlistener.cc.
|
virtual |
Definition at line 39 of file wvlistener.cc.
|
virtual |
Add a wrapper function for this stream: something that accept() will call to possibly wrap the stream from accept() before returning it.
You can use this more than once; the wrappers will be called in order (so the "innermost" stream is the original, the first wrapper is next, and so on).
Implements IWvListener.
Definition at line 54 of file wvlistener.cc.
|
virtual |
Set a user-defined function to be called when a new connection is available.
The new connection IWvStream is given, and it's the callback's responsibility to make sure it gets freed properly.
Implements IWvListener.
Definition at line 87 of file wvlistener.cc.
Definition at line 78 of file wvlistener.cc.
void WvListener::runonce | ( | time_t | msec_delay | ) |
Definition at line 95 of file wvlistener.cc.
|
inlinevirtual |
Implements IWvStream.
Definition at line 36 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
By default, returns true if geterr() == 0.
Might be overridden so that isok() == false even though no error code has been specified.
Implements IWvStream.
Reimplemented in WvNullListener, and WvNullListener.
Definition at line 38 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
References WvErrorBase::isok(), and IWvStream::isok().
Referenced by WvTCPListener::accept(), and WvUnixListener::accept().
|
virtual |
Implements IWvStream.
Definition at line 68 of file wvlistener.cc.
|
inline |
Definition at line 43 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 45 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 47 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Reimplemented in WvTCPListener, WvUnixListener, WvTCPListener, and WvUnixListener.
Definition at line 50 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 53 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 55 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 58 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 60 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 62 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 64 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Shuts down the reading side of the stream.
This is the opposite of nowrite(), but the name is actually slightly misleading; subsequent calls to read() might not fail; rather, if the other end of the connection tries to write to us, they should fail.
After noread(), if the read buffer (if any) is empty once, we promise that it will never refill.
If you call both noread() and nowrite(), then the stream does close() automatically once all buffers are empty.
Implements IWvStream.
Definition at line 66 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Shuts down the writing side of the stream.
Subsequent calls to write() will fail. But if there's data in the output buffer, it will still be flushed.
If you call both noread() and nowrite(), then the stream does close() automatically once all buffers are empty.
Implements IWvStream.
Definition at line 68 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Auto-close the stream if the time is right.
If noread() and nowrite() and all buffers are empty, then we can probably close.
Implements IWvStream.
Definition at line 70 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Returns true if the stream is readable.
Implements IWvStream.
Definition at line 72 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Returns true if the stream is writable (without using the outbuf).
Implements IWvStream.
Definition at line 74 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
flush the output buffer, if we can do it without delaying more than msec_timeout milliseconds at a time.
(-1 means wait forever)
Returns true if it finished flushing (ie. the outbuf is empty).
FIXME: Something like this probably belongs in IWvStream, but probably not exactly this.
Implements IWvStream.
Definition at line 76 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Returns true if we want to flush the output buffer right now.
This allows us to implement delayed_flush(), flush_then_close(), etc, but it's still super-ugly and probably needs to go away. (In fact, all our buffer flushing is super-ugly right now.)
Implements IWvStream.
Definition at line 78 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Sets a callback to be invoked when the stream is readable.
Implements IWvStream.
Definition at line 80 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Sets a callback to be invoked when the stream is writable.
Implements IWvStream.
Definition at line 82 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Sets a callback to be invoked when the stream is in exception state.
Implements IWvStream.
Definition at line 84 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Sets a callback to be invoked on close().
Implements IWvStream.
Definition at line 86 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 88 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 90 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inline |
Definition at line 92 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 94 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 96 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
inlinevirtual |
set the maximum size of outbuf, beyond which a call to write() will return 0.
Implements IWvStream.
Definition at line 98 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
virtual |
Implements IWvStream.
Definition at line 107 of file wvlistener.cc.
|
virtual |
Add a wrapper function for this stream: something that accept() will call to possibly wrap the stream from accept() before returning it.
You can use this more than once; the wrappers will be called in order (so the "innermost" stream is the original, the first wrapper is next, and so on).
Implements IWvListener.
|
virtual |
Set a user-defined function to be called when a new connection is available.
The new connection IWvStream is given, and it's the callback's responsibility to make sure it gets freed properly.
Implements IWvListener.
|
inlinevirtual |
Implements IWvStream.
Definition at line 36 of file include/wvlistener.h.
|
inlinevirtual |
By default, returns true if geterr() == 0.
Might be overridden so that isok() == false even though no error code has been specified.
Implements IWvStream.
Reimplemented in WvNullListener, and WvNullListener.
Definition at line 38 of file include/wvlistener.h.
References WvErrorBase::isok(), and IWvStream::isok().
|
virtual |
Implements IWvStream.
|
inline |
Definition at line 43 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 45 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 47 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Reimplemented in WvTCPListener, WvUnixListener, WvTCPListener, and WvUnixListener.
Definition at line 50 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 53 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 55 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 58 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 60 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 62 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 64 of file include/wvlistener.h.
|
inlinevirtual |
Shuts down the reading side of the stream.
This is the opposite of nowrite(), but the name is actually slightly misleading; subsequent calls to read() might not fail; rather, if the other end of the connection tries to write to us, they should fail.
After noread(), if the read buffer (if any) is empty once, we promise that it will never refill.
If you call both noread() and nowrite(), then the stream does close() automatically once all buffers are empty.
Implements IWvStream.
Definition at line 66 of file include/wvlistener.h.
|
inlinevirtual |
Shuts down the writing side of the stream.
Subsequent calls to write() will fail. But if there's data in the output buffer, it will still be flushed.
If you call both noread() and nowrite(), then the stream does close() automatically once all buffers are empty.
Implements IWvStream.
Definition at line 68 of file include/wvlistener.h.
|
inlinevirtual |
Auto-close the stream if the time is right.
If noread() and nowrite() and all buffers are empty, then we can probably close.
Implements IWvStream.
Definition at line 70 of file include/wvlistener.h.
|
inlinevirtual |
Returns true if the stream is readable.
Implements IWvStream.
Definition at line 72 of file include/wvlistener.h.
|
inlinevirtual |
Returns true if the stream is writable (without using the outbuf).
Implements IWvStream.
Definition at line 74 of file include/wvlistener.h.
|
inlinevirtual |
flush the output buffer, if we can do it without delaying more than msec_timeout milliseconds at a time.
(-1 means wait forever)
Returns true if it finished flushing (ie. the outbuf is empty).
FIXME: Something like this probably belongs in IWvStream, but probably not exactly this.
Implements IWvStream.
Definition at line 76 of file include/wvlistener.h.
|
inlinevirtual |
Returns true if we want to flush the output buffer right now.
This allows us to implement delayed_flush(), flush_then_close(), etc, but it's still super-ugly and probably needs to go away. (In fact, all our buffer flushing is super-ugly right now.)
Implements IWvStream.
Definition at line 78 of file include/wvlistener.h.
|
inlinevirtual |
Sets a callback to be invoked when the stream is readable.
Implements IWvStream.
Definition at line 80 of file include/wvlistener.h.
|
inlinevirtual |
Sets a callback to be invoked when the stream is writable.
Implements IWvStream.
Definition at line 82 of file include/wvlistener.h.
|
inlinevirtual |
Sets a callback to be invoked when the stream is in exception state.
Implements IWvStream.
Definition at line 84 of file include/wvlistener.h.
|
inlinevirtual |
Sets a callback to be invoked on close().
Implements IWvStream.
Definition at line 86 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 88 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 90 of file include/wvlistener.h.
|
inline |
Definition at line 92 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 94 of file include/wvlistener.h.
|
inlinevirtual |
Implements IWvStream.
Definition at line 96 of file include/wvlistener.h.
|
inlinevirtual |
set the maximum size of outbuf, beyond which a call to write() will return 0.
Implements IWvStream.
Definition at line 98 of file include/wvlistener.h.
|
virtual |
Implements IWvStream.
|
staticinherited |
Definition at line 20 of file wvlistener.cc.
|
staticinherited |
Definition at line 80 of file wvstream.cc.
|
pure virtualinherited |
Accept a connection from this stream.
If none are available right now, might return NULL or block. (NULL is preferable.)
Implemented in WvNullListener, WvTCPListener, WvUnixListener, WvNullListener, WvTCPListener, and WvUnixListener.
|
pure virtualinherited |
Accept a connection from this stream.
If none are available right now, might return NULL or block. (NULL is preferable.)
Implemented in WvNullListener, WvTCPListener, WvUnixListener, WvNullListener, WvTCPListener, and WvUnixListener.
|
inlinevirtualinherited |
If isok() is false, return the system error number corresponding to the error, -1 for a special error string (which you can obtain with errstr()) or 0 on end of file.
If isok() is true, returns an undefined number.
Reimplemented in WvDBusServer, WvStreamClone, WvDBusServer, and WvStreamClone.
Definition at line 48 of file debian/libwvstreams-dev/usr/include/wvstreams/wverror.h.
Referenced by UniIniGen::commit(), UniFileSystemGen::get(), WvDBusServer::geterr(), WvStreamClone::geterr(), WvEncoderStream::isok(), UniConfDaemon::listen(), UniIniGen::refresh(), WvStream::seterr(), and WvMagicCircle::WvMagicCircle().
|
inlinevirtualinherited |
If isok() is false, return the system error number corresponding to the error, -1 for a special error string (which you can obtain with errstr()) or 0 on end of file.
If isok() is true, returns an undefined number.
Reimplemented in WvDBusServer, WvStreamClone, WvDBusServer, and WvStreamClone.
Definition at line 48 of file include/wverror.h.
|
virtualinherited |
Definition at line 127 of file wverror.cc.
|
staticinherited |
A replacement for the operating system strerror() function that can map more kinds of error strings (especially in win32).
Definition at line 91 of file wverror.cc.
References WvErrorBase::strerror().
Referenced by WvLog::perror(), WvErrorBase::strerror(), WvSSLStream::uread(), and WvSSLStream::uwrite().
|
virtualinherited |
Set the errnum variable – we have an error.
If called more than once, seterr() doesn't change the error code away from the previous one. That way, we remember the original cause of our problems.
Subclasses may want to override seterr(int) to shut themselves down (eg. WvStream::close()) when an error condition is set.
Note that seterr(WvString) will call seterr(-1).
Reimplemented in WvStream, and WvStream.
Definition at line 144 of file wverror.cc.
Referenced by WvTCPListener::accept(), WvUnixListener::accept(), WvDSAKey::getpem(), WvGlob::set(), WvStream::seterr(), WvMagicCircle::WvMagicCircle(), WvPam::WvPam(), WvPam::WvPam(), WvShmZone::WvShmZone(), and WvTCPListener::WvTCPListener().
|
inherited |
Definition at line 159 of file wverror.cc.
|
inlineinherited |
Definition at line 70 of file debian/libwvstreams-dev/usr/include/wvstreams/wverror.h.
|
inherited |
Definition at line 170 of file wverror.cc.
|
virtualinherited |
Set the errnum variable – we have an error.
If called more than once, seterr() doesn't change the error code away from the previous one. That way, we remember the original cause of our problems.
Subclasses may want to override seterr(int) to shut themselves down (eg. WvStream::close()) when an error condition is set.
Note that seterr(WvString) will call seterr(-1).
|
inlineinherited |
Definition at line 70 of file include/wverror.h.
|
inherited |
Definition at line 179 of file wverror.cc.
|
inlineinherited |
Definition at line 73 of file debian/libwvstreams-dev/usr/include/wvstreams/wverror.h.
|
inlineinherited |
Definition at line 73 of file include/wverror.h.
|
inlineinherited |
Reset our error state - there's no error condition anymore.
Definition at line 78 of file debian/libwvstreams-dev/usr/include/wvstreams/wverror.h.
|
inlineinherited |
Reset our error state - there's no error condition anymore.
Definition at line 78 of file include/wverror.h.
|
pure virtualinherited |
Indicate you are using this object.
This increases the reference count of the object by one. Usually, when the reference count reaches zero, the object is freed automatically.
This called a "strong reference", because they will prevent the object from being destroyed. They should thus be used carefully, as they control the lifetime of the object. For example, you do not need to call addRef() on object passed as parameters, unless you intend on keeping them.
addRef() is often called automatically for you in XPLC, but you'll have to call release() by hand sometimes unless you use xplc_ptr.
Referenced by WvIStreamList::execute(), IObjectImplInternal::getInterface(), WeakRef::getObject(), StaticServiceHandler::getObject(), WvIStreamList::post_select(), WvQtStreamClone::WvQtStreamClone(), and WvSSLStream::WvSSLStream().
|
pure virtualinherited |
Indicate you are using this object.
This increases the reference count of the object by one. Usually, when the reference count reaches zero, the object is freed automatically.
This called a "strong reference", because they will prevent the object from being destroyed. They should thus be used carefully, as they control the lifetime of the object. For example, you do not need to call addRef() on object passed as parameters, unless you intend on keeping them.
addRef() is often called automatically for you in XPLC, but you'll have to call release() by hand sometimes unless you use xplc_ptr.
|
pure virtualinherited |
Indicate that you are finished using this object.
This decreases the reference count of the object by one. Usually, when the reference count reaches zero, the object is freed automatically.
You will usually need to manually release() any object given to you by any other XPLC function, unless you give the object to someone else who will call release.
If you use xplc_ptr, it will do this for you.
Referenced by WvIStreamList::execute(), mutate(), MonikerService::resolve(), and NewMoniker::resolve().
|
pure virtualinherited |
Indicate that you are finished using this object.
This decreases the reference count of the object by one. Usually, when the reference count reaches zero, the object is freed automatically.
You will usually need to manually release() any object given to you by any other XPLC function, unless you give the object to someone else who will call release.
If you use xplc_ptr, it will do this for you.
Returns the requested XPLC interface.
Will return NULL if the interface is not supported. The returned interface has been addRef()ed, so you will need to release() it when done. Note that the interface returned may be a pointer to the same object or a different one - that's none of your business. Asking for the IObject interface should always return the same pointer for a given logical object, so this can be used for comparison by identity.
You should probably use the convenient mutate() and get() functions instead of this, or use an xplc_ptr, which mutates the object for you.
Returns the requested XPLC interface.
Will return NULL if the interface is not supported. The returned interface has been addRef()ed, so you will need to release() it when done. Note that the interface returned may be a pointer to the same object or a different one - that's none of your business. Asking for the IObject interface should always return the same pointer for a given logical object, so this can be used for comparison by identity.
You should probably use the convenient mutate() and get() functions instead of this, or use an xplc_ptr, which mutates the object for you.
|
pure virtualinherited |
|
pure virtualinherited |
IWvStream * WvListener::cloned |
Definition at line 20 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
IWvListenerCallback WvListener::acceptor |
Definition at line 21 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
IWvListenerWrapper WvListener::wrapper |
Definition at line 22 of file debian/libwvstreams-dev/usr/include/wvstreams/wvlistener.h.
|
protectedinherited |
Definition at line 26 of file debian/libwvstreams-dev/usr/include/wvstreams/wverror.h.
|
protectedinherited |
Definition at line 27 of file debian/libwvstreams-dev/usr/include/wvstreams/wverror.h.