ofstd/include/ofcond.h

/*
 *
 *  Copyright (C) 1997-2003, OFFIS
 *
 *  This software and supporting documentation were developed by
 *
 *    Kuratorium OFFIS e.V.
 *    Healthcare Information and Communication Systems
 *    Escherweg 2
 *    D-26121 Oldenburg, Germany
 *
 *  THIS SOFTWARE IS MADE AVAILABLE,  AS IS,  AND OFFIS MAKES NO  WARRANTY
 *  REGARDING  THE  SOFTWARE,  ITS  PERFORMANCE,  ITS  MERCHANTABILITY  OR
 *  FITNESS FOR ANY PARTICULAR USE, FREEDOM FROM ANY COMPUTER DISEASES  OR
 *  ITS CONFORMITY TO ANY SPECIFICATION. THE ENTIRE RISK AS TO QUALITY AND
 *  PERFORMANCE OF THE SOFTWARE IS WITH THE USER.
 *
 *  Module:  ofstd
 *
 *  Author:  Marco Eichelberg
 *
 *  Purpose: class OFCondition and helper classes
 *
 *  Last Update:      $Author: joergr $
 *  Update Date:      $Date: 2003/12/05 10:37:41 $
 *  CVS/RCS Revision: $Revision: 1.8 $
 *  Status:           $State: Exp $
 *
 *  CVS/RCS Log at end of file
 *
 */


#ifndef OFCOND_H
#define OFCOND_H

#include "osconfig.h"
#include "oftypes.h"   /* for class OFBool */
#include "ofstring.h"  /* for class OFString */
#include "ofcast.h"

#define INCLUDE_CASSERT
#include "ofstdinc.h"

enum OFStatus
{
  OF_ok,

  OF_error,

  OF_failure
};


class OFConditionBase
{
public:

  OFConditionBase()
  {
  }

  OFConditionBase(const OFConditionBase& /* arg */)
  {
  }

  virtual ~OFConditionBase()
  {
  }

  virtual const OFConditionBase *clone() const = 0;

  virtual unsigned long codeAndModule() const = 0;

  virtual OFStatus status() const = 0;

  virtual const char *text() const = 0;

  virtual OFBool deletable() const = 0;

  unsigned short module() const
  {
    return OFstatic_cast(unsigned short,((codeAndModule() >> 16) & 0xFFFF));
  }

  unsigned short code() const
  {
    return OFstatic_cast(unsigned short,(codeAndModule() & 0xFFFF));
  }

  OFBool operator==(const OFConditionBase& arg) const
  {
    return ((status() == arg.status()) && (codeAndModule() == arg.codeAndModule()));
  }

  OFBool operator!=(const OFConditionBase& arg) const
  {
    return ((status() != arg.status()) || (code() != arg.code()) || (module() != arg.module()));
  }

private:

  OFConditionBase& operator=(const OFConditionBase& arg);

};



class OFConditionConst: public OFConditionBase
{
public:

  OFConditionConst(unsigned short aModule, unsigned short aCode, OFStatus aStatus, const char *aText)
  : OFConditionBase()
  , theCodeAndModule(OFstatic_cast(unsigned long, aCode) | OFstatic_cast(unsigned long, aModule << 16))
  , theStatus(aStatus)
  , theText(aText)
  {
  }

  OFConditionConst(const OFConditionConst& arg)
  : OFConditionBase(arg)
  , theCodeAndModule(arg.theCodeAndModule)
  , theStatus(arg.theStatus)
  , theText(arg.theText)
  {
  }

  virtual ~OFConditionConst()
  {
  }

  virtual const OFConditionBase *clone() const;

  virtual unsigned long codeAndModule() const;

  virtual OFStatus status() const;

  virtual const char *text() const;

  virtual OFBool deletable() const;

private:

  OFConditionConst& operator=(const OFConditionConst& arg);

  unsigned long theCodeAndModule;

  OFStatus theStatus;

  const char *theText;

};



class OFConditionString: public OFConditionBase
{
public:

  OFConditionString(unsigned short aModule, unsigned short aCode, OFStatus aStatus, const char *aText)
  : OFConditionBase()
  , theCodeAndModule(OFstatic_cast(unsigned long, aCode) | OFstatic_cast(unsigned long, aModule << 16))
  , theStatus(aStatus)
  , theText()
  {
    if (aText) theText = aText;
  }

  OFConditionString(const OFConditionString& arg)
  : OFConditionBase(arg)
  , theCodeAndModule(arg.theCodeAndModule)
  , theStatus(arg.theStatus)
  , theText(arg.theText)
  {
  }

  virtual ~OFConditionString()
  {
  }

  virtual const OFConditionBase *clone() const;

  virtual unsigned long codeAndModule() const;

  virtual OFStatus status() const;

  virtual const char *text() const;

  virtual OFBool deletable() const;

private:
  OFConditionString& operator=(const OFConditionString& arg);

  unsigned long theCodeAndModule;

  OFStatus theStatus;

  OFString theText;
};


// global constant used by OFCondition default constructor.
extern const OFConditionConst ECC_Normal;


class OFCondition
{
public:

  OFCondition(OFConditionString *base)
  : theCondition(base)
  {
    assert(theCondition);
  }

#ifdef OFCONDITION_STRICT_MODE
  // in strict mode OFCondition has no default constructor.
  OFCondition(const OFConditionConst& base)
#else
  OFCondition(const OFConditionConst& base = ECC_Normal)
#endif
  : theCondition(&base)
  {
    assert(theCondition);
  }

  OFCondition(const OFCondition& arg)
  : theCondition(arg.theCondition->clone())
  {
    assert(theCondition);
  }

  ~OFCondition()
  {
    if (theCondition->deletable())
    {
      delete OFconst_cast(OFConditionBase *, theCondition); // cast away const
    }
  }

  OFCondition& operator=(const OFCondition& arg)
  {
    if (&arg != this)
    {
      if (theCondition->deletable())
      {
        delete OFconst_cast(OFConditionBase *, theCondition); // cast away const
      }
      theCondition = arg.theCondition->clone();
      assert(theCondition);
    }
    return *this;
  }

  inline unsigned short module() const
  {
    return theCondition->module();
  }

  inline unsigned short code() const
  {
    return theCondition->code();
  }

  inline OFStatus status() const
  {
    return theCondition->status();
  }

  inline const char *text() const
  {
    return theCondition->text();
  }

  inline OFBool good() const
  {
    OFStatus s = theCondition->status();
    return (s == OF_ok);
  }

  inline OFBool bad() const
  {
    OFStatus s = theCondition->status();
    return (s != OF_ok);
  }

#ifdef OFCONDITION_IMPLICIT_BOOL_CONVERSION
  /* Implicit conversion from OFCondition to bool might
   * not always be a good idea since it can hide unwanted constructs.
   * Therefore, we disable this operator by default.
   */

  inline operator OFBool() const
  {
    return good();
  }
#endif

  inline OFBool operator==(const OFCondition& arg) const
  {
    return (*theCondition == *arg.theCondition);
  }

  inline OFBool operator!=(const OFCondition& arg) const
  {
    return (*theCondition != *arg.theCondition);
  }

private:

  const OFConditionBase *theCondition;

};


/*  global condition constants.
 *  All constants defined here use module number 0 which is reserved for
 *  global definitions. Other constants are defined elsewhere.
 */

extern const OFCondition EC_Normal;

extern const OFCondition EC_IllegalParameter;

extern const OFCondition EC_MemoryExhausted;


#define makeOFCondition(A, B, C, D) OFCondition(new OFConditionString((A), (B), (C), (D)))


#endif

/*
 * CVS/RCS Log:
 * $Log: ofcond.h,v $
 * Revision 1.8  2003/12/05 10:37:41  joergr
 * Removed leading underscore characters from preprocessor symbols (reserved
 * symbols). Updated copyright date where appropriate.
 *
 * Revision 1.7  2003/07/09 13:57:43  meichel
 * Adapted type casts to new-style typecast operators defined in ofcast.h
 *
 * Revision 1.6  2003/07/04 13:31:51  meichel
 * Fixed issues with compiling with HAVE_STD_STRING
 *
 * Revision 1.5  2003/06/12 13:15:59  joergr
 * Fixed inconsistent API documentation reported by Doxygen.
 *
 * Revision 1.4  2001/11/09 15:44:39  joergr
 * Removed ";" from macro definition to avoid compiler warnings reported by
 * Sun CC 2.0.1.
 *
 * Revision 1.3  2001/10/12 10:42:26  meichel
 * Introduced conditional define OFCONDITION_STRICT_MODE in which the
 *   compatibility options related to the transition to OFCondition are disabled:
 *   No OFCondition default constructor, no typedefs for E_Condition, CONDITION,
 *   no macros for SUCCESS and condition aliases.
 *
 * Revision 1.2  2001/09/25 17:07:24  meichel
 * Disabled implicit conversion to bool, added default constructor
 *   to class OFCondition.
 *
 * Revision 1.1  2001/08/23 16:08:37  meichel
 * Initial release of class OFCondition, a generic approach for condition codes
 *
 *
 */

---

Generated on 4 Nov 2004 for OFFIS DCMTK Version 3.5.3 by Doxygen 1.3.8