/usr/include/wvstreams/wverror.h is in libwvstreams-dev 4.6.1-2build1.
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 | /* -*- Mode: C++ -*-
* Worldvisions Weaver Software:
* Copyright (C) 1997-2002 Net Integration Technologies, Inc.
*
* A class for managing error numbers and strings.
*/
#ifndef __WVERROR_H
#define __WVERROR_H
#include "wvstring.h"
/**
* A class for managing error numbers and strings.
*
* It can have either a system error value, like those defined
* in errno.h, or an arbitrary error string. In either case, it
* can return a string representation of the error message.
*
* This object is most useful for using as a base class of your own class,
* for historical/backwards compatibility reasons. Consider using a WvError
* instead, and making it a member of your class instead of a parent.
*/
class WvErrorBase
{
protected:
int errnum;
WvString errstring;
public:
WvErrorBase()
{ noerr(); }
virtual ~WvErrorBase();
/**
* By default, returns true if geterr() == 0.
* Might be overridden so that isok() == false even though no
* error code has been specified.
*/
virtual bool isok() const
{ return errnum == 0; }
/**
* 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.
*/
virtual int geterr() const
{ return errnum; }
virtual WvString errstr() const;
/**
* A replacement for the operating system ::strerror() function that
* can map more kinds of error strings (especially in win32).
*/
static WvString strerror(int errnum);
/**
* 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).
*/
virtual void seterr(int _errnum);
void seterr(WvStringParm specialerr);
void seterr(WVSTRING_FORMAT_DECL)
{ seterr(WvString(WVSTRING_FORMAT_CALL)); }
void seterr_both(int _errnum, WvStringParm specialerr);
void seterr_both(int _errnum, WVSTRING_FORMAT_DECL)
{ seterr_both(_errnum, WvString(WVSTRING_FORMAT_CALL)); }
void seterr(const WvErrorBase &err);
/** Reset our error state - there's no error condition anymore. */
void noerr()
{ errnum = 0; errstring = WvString::null; }
};
/**
* A variant of WvErrorBase suitable for embedding as a member of your own
* object, preferably called 'err'. It adds some extra convenience functions
* to remove function name redundancy, so you can say "obj.err.get()" instead
* of "obj.err.geterr()", for example.
*/
class WvError : public WvErrorBase
{
public:
int get() const
{ return geterr(); }
WvString str() const
{ return errstr(); }
void set(int _errnum)
{ seterr(_errnum); }
void set(WvStringParm specialerr)
{ seterr(specialerr); }
void set(WVSTRING_FORMAT_DECL)
{ seterr(WvString(WVSTRING_FORMAT_CALL)); }
void set_both(int _errnum, WvStringParm specialerr)
{ seterr_both(_errnum, specialerr); }
void set(const WvErrorBase &err)
{ seterr(err); }
void reset()
{ noerr(); }
};
#endif // __WVERROR_H
|