util.h

//==========================================================================
//  UTIL.H - part of
//                     OMNeT++/OMNEST
//            Discrete System Simulation in C++
//
//
//  Utility functions
//
//==========================================================================

/*--------------------------------------------------------------*
  Copyright (C) 1992-2005 Andras Varga

  This file is distributed WITHOUT ANY WARRANTY. See the file
  `license' for details on this and other legal matters.
*--------------------------------------------------------------*/

#ifndef __UTIL_H
#define __UTIL_H

#include <stdarg.h>  // for va_list
#include <stdio.h>   // for sprintf
#include <typeinfo>  // for type_info
#include "defs.h"

// forward declarations
class cModule;

// logically belongs to csimul.h but must be here because of declaration order
enum {CTX_BUILDINSIDE, CTX_INITIALIZE, CTX_EVENT, CTX_FINISH};

//
// #defines provided for backwards compatibility.
// They may be removed in a future release!
//
#define myrandomize      opp_randomize
#define genk_myrandomize genk_opp_randomize
#define mystrdup         opp_strdup
#define mystrcpy         opp_strcpy
#define mystrcmp         opp_strcmp
#define mystrmatch       opp_strmatch
#define fastconcat       opp_concat
#define indexedname      opp_mkindexedname



SIM_API simtime_t strToSimtime(const char *str);

SIM_API simtime_t strToSimtime0(const char *&str);

SIM_API char *simtimeToStr(simtime_t t, char *dest=NULL);



SIM_API double min(double a, double b);

SIM_API double max(double a, double b);

SIM_API double bool_and(double a, double b);

SIM_API double bool_or(double a, double b);

SIM_API double bool_xor(double a, double b);

SIM_API double bool_not(double a);

SIM_API double bin_and(double a, double b);

SIM_API double bin_or(double a, double b);

SIM_API double bin_xor(double a, double b);

SIM_API double bin_compl(double a);

SIM_API double shift_left(double a, double b);

SIM_API double shift_right(double a, double b);



SIM_API char *opp_strdup(const char *);

SIM_API char *opp_strcpy(char *,const char *);

SIM_API int  opp_strcmp(const char *, const char *);

SIM_API bool opp_strmatch(const char *, const char *);

SIM_API int opp_strlen(const char *);

SIM_API char *opp_mkindexedname(char *dest, const char *name, int index);

SIM_API char *opp_concat(const char *s1, const char *s2, const char *s3=NULL, const char *s4=NULL);

SIM_API char *opp_strprettytrunc(char *dest, const char *src, unsigned maxlen);

inline const char *correct(const char *);


inline bool equal(double a, double b, double epsilon);

//
// INTERNAL: a restricted vsscanf implementation used by cStatistic::freadvarsf()
//
SIM_API int opp_vsscanf(const char *s, const char *fmt, va_list va);


SIM_API void opp_error(int errcode,...);

SIM_API void opp_error(const char *msg,...);

SIM_API void opp_warning(int errcode,...);

SIM_API void opp_warning(const char *msg,...);

SIM_API void opp_terminate(int errcode,...);

SIM_API void opp_terminate(const char *msg,...);

//
// INTERNAL: return name of a C++ type -- correcting quirks of various compilers...
//
const char *opp_typename(const std::type_info& t);

//==========================================================================

#define MAX_METHODCALL 1024

#define Enter_Method cContextSwitcher __ctx(this); __ctx.methodCall

#define Enter_Method_Silent() cContextSwitcher __ctx(this)

class SIM_API cContextSwitcher
{
  private:
    cModule *callerContext;
    int contexttype;
  public:
    cContextSwitcher(cModule *thisptr, int ctxtype=CTX_EVENT);

    ~cContextSwitcher();

    void methodCall(const char *fmt,...);
};


//==========================================================================
//=== Implementation of utility functions:

inline bool equal(double a, double b, double epsilon)
{
   double d = a-b;
   return (d>=0.0 ? d : -d) < epsilon;
}

inline const char *correct(const char *s)
{
   return s ? s : "";
}

// internally used: appends [num] to the given string
inline void opp_appendindex(char *s, unsigned int i)
{
   while (*s) s++;
   *s++ = '[';
   if (i<10)
       {*s++ = '0'+i; *s++=']'; *s=0; return;}
   if (i<100)
       {*s++ = '0'+i/10; *s++='0'+i%10; *s++=']'; *s=0; return;}
   sprintf(s,"%d]",i);
}

#endif

---