cNedFunction Class Reference

#include <cnedfunction.h>

Description

Registration class for extending NED with arbitrary new functions.

Objects of this class are usually created via the Define_NED_Function() macro.

Inheritance diagram for cNedFunction:

Public Member Functions
Constructors, destructor, assignment
	cNedFunction (NedFunction f, const char *signature, const char *category=nullptr, const char *description=nullptr)
virtual	~cNedFunction ()
Redefined cObject member functions.
virtual std::string	str () const override
Member access.
cNedValue	invoke (cComponent *context, cNedValue argv[], int argc)
NedFunction	getFunctionPointer () const
const char *	getSignature () const
char	getReturnType () const
char	getArgType (int k) const
int	getMinArgs () const
int	getMaxArgs () const
bool	hasVarArgs () const
const char *	getCategory () const
const char *	getDescription () const
Public Member Functions inherited from cNoncopyableOwnedObject
	cNoncopyableOwnedObject (const char *name=nullptr, bool namepooling=true)
virtual cNoncopyableOwnedObject *	dup () const override
virtual void	parsimPack (cCommBuffer *buffer) const override
virtual void	parsimUnpack (cCommBuffer *buffer) override
Public Member Functions inherited from cOwnedObject
	cOwnedObject ()
	cOwnedObject (const char *name, bool namepooling=true)
	cOwnedObject (const cOwnedObject &obj)
virtual	~cOwnedObject ()
cOwnedObject &	operator= (const cOwnedObject &o)
virtual cObject *	getOwner () const override
virtual bool	isOwnedObject () const override
virtual bool	isSoftOwner () const
Public Member Functions inherited from cNamedObject
	cNamedObject ()
	cNamedObject (const char *name, bool namepooling=true)
	cNamedObject (const cNamedObject &obj)
virtual	~cNamedObject ()
cNamedObject &	operator= (const cNamedObject &o)
virtual void	setName (const char *s)
virtual const char *	getName () const override
virtual void	setNamePooling (bool b)
virtual bool	getNamePooling ()
Public Member Functions inherited from cObject
	cObject ()
	cObject (const cObject &other)
virtual	~cObject ()
virtual const char *	getClassName () const
bool	isName (const char *s) const
virtual const char *	getFullName () const
virtual std::string	getFullPath () const
const cObject *	getThisPtr () const
virtual _OPPDEPRECATED std::string	info () const
virtual _OPPDEPRECATED std::string	detailedInfo () const
virtual void	forEachChild (cVisitor *v)
cObject *	findObject (const char *name, bool deep=true)
void	copyNotSupported () const

Static Public Member Functions
static cNedFunction *	find (const char *name)
static cNedFunction *	get (const char *name)
static cNedFunction *	findByPointer (NedFunction f)
Static Public Member Functions inherited from cOwnedObject
static long	getTotalObjectCount ()
static long	getLiveObjectCount ()
static void	resetObjectCounters ()
static cDefaultList *	getDefaultOwner ()

Additional Inherited Members
Protected Member Functions inherited from cObject
virtual void	take (cOwnedObject *obj)
virtual void	drop (cOwnedObject *obj)
void	dropAndDelete (cOwnedObject *obj)

Constructor & Destructor Documentation

cNedFunction	(	NedFunction	f,
		const char *	signature,
		const char *	category = nullptr,
		const char *	description = nullptr
	)

Constructor. Signature is expected in the following syntax: returntype name(argtype argname,...), where types can be bool, long, double, quantity, intquantity, string, xml, any; names of optional arguments end in '?'. The object name will be the function name, as extracted from the signature string. The signature may end in an ellipsis, i.e. "...", to mean that any number of extra args of unspecified types should be accepted. (When there are both optional args and an ellipsis, then extra arguments can only be passed when all optional arguments are all supplied.)

Examples: "quantity uniform(quantity a, quantity b, long rng?)" "string sprintf(format, ...)" "any max(...)"

virtual ~cNedFunction ( )

inlinevirtual

Destructor.

Member Function Documentation

virtual std::string str ( ) const

overridevirtual

Produces a one-line description of the object's contents.

Reimplemented from cObject.

cNedValue invoke	(	cComponent *	context,
		cNedValue	argv[],
		int	argc
	)

Performs argument type checking, and invokes the function.

NedFunction getFunctionPointer ( ) const

inline

Returns the function pointer. Do not call the function directly, because that would bypass argument type validation.

const char* getSignature ( ) const

inline

Returns the functions signature, as passed to the constructor

char getReturnType ( ) const

inline

Returns the function return type, one of the characters B,L,D,Q,S,X,* for bool, long, double, quantity, string, xml and any, respectively.

char getArgType ( int  k ) const

inline

Returns the type of the kth argument; result is one of the characters B,L,D,Q,S,X,* for bool, long, double, quantity, string, xml and any, respectively.

int getMinArgs ( ) const

inline

Returns the minimum number of arguments (i.e. the number of mandatory arguments).

int getMaxArgs ( ) const

inline

Returns the maximum number of typed arguments (i.e. the last max-min args are optional). If hasVarArgs() is true, the function actually accepts more than getMaxArgs() arguments.

bool hasVarArgs ( ) const

inline

Returns true if the function signature ends in an ellipsis ("..."), that is, the function supports varargs.

const char* getCategory ( ) const

inline

Returns a string that can be useful in classifying NED functions, e.g. "trigonometric".

const char* getDescription ( ) const

inline

Returns the function's documentation as a string.

static cNedFunction* find ( const char *  name )

static

Finds a registered function by name. Returns nullptr if not found.

static cNedFunction* get ( const char *  name )

static

Finds a registered function by name. Throws an error if not found.

static cNedFunction* findByPointer ( NedFunction  f )

static

Finds a registered function by function pointer.

---

The documentation for this class was generated from the following file:

• cnedfunction.h