com.pcbsys.nirvana.client.nEventProperties Class Reference

This class contains a collection of key-value pairs, defining event meta data which can be used to create filter rules. More...

Public Member Functions

bool containsKey (string key)
 Returns true if the key is contained within the dictionary.
 
void copy (nEventProperties p_dictionary)
 Copies the properties from one to this.
 
object get (object key)
 Get the value as an Object If the input paramter is not of type String, returns null.
 
object get (string key)
 Get the value as an Object.
 
bool getBoolean (string key)
 Retrieves the data from the table based on the key as a bool.
 
bool[] getBooleanArray (string key)
 Retrieves a bool[] from the properties.
 
byte getByte (string key)
 Retrieves a byte by the name given.
 
byte[] getByteArray (string key)
 Retrieves a byte[] from the dictionary.
 
char getChar (string key)
 Retrieves a char from the properties.
 
char[] getCharArray (string key)
 Retrieves a char[] from the properties.
 
string getClass (string key)
 Get the class name of the value represented by the key.
 
nEventProperties getDictionary (string key)
 Retrieve a nEventProperty from this one.
 
nEventProperties[] getDictionaryArray (string key)
 Return an array of nEventProperties.
 
double getDouble (string key)
 Retrieves the data from the table based on the key as a double.
 
double[] getDoubleArray (string key)
 Retrieves a double[] from the properties.
 
nEventPropertiesIterator getEntrySet ()
 Get an iterator of the key and values in an Map.Entry.
 
float getFloat (string key)
 Retrieves a float from the properties.
 
float[] getFloatArray (string key)
 Retrieves a float[] from the properties.
 
int getInt (string key)
 Retrieves an int from the properties.
 
int[] getIntArray (string key)
 Gets an int[] from the properties.
 
IEnumerator< string > getKeys ()
 Get an IEnumerator of keys.
 
IEnumerator< string > getKeysAsStrings ()
 Get an IEnumerator of keys as Strings.
 
long getLong (string key)
 Retrieves the data from the table based on the key as a long.
 
long[] getLongArray (string key)
 Retrieves a long[] from the properties.
 
short getShort (string key)
 Retrieves a short from the properties.
 
short[] getShortArray (string key)
 Retrieves an array of shorts.
 
int getSize ()
 Return the number of properties held.
 
string getString (string key)
 Retrieves the data from the table based on the key as a string.
 
string[] getStringArray (string key)
 Retrieves a String[].
 
IEnumerator< object > getValues ()
 Get an IEnumerator of values.
 
bool isValid ()
 Returns true if the dictionary is consistent and contains no errors.
 
void merge (nEventProperties props, bool overwrite)
 Adds the values from the supplied properties to this object.
 
 nEventProperties ()
 Default constructor.
 
 nEventProperties (nEventProperties ed)
 Constructs an event properties object that is a copy of the specified event properties.
 
 nEventProperties (nEventProperties ed, bool copyNew)
 Constructs an event properties object that is a copy of the specified event properties, but depending on the copyNew, will construct new dictionary entries to prevent dictionary entries being overwritten by subsequent uses of the event object and event properties.
 
 nEventProperties (string serializedString)
 Constructor using a string from the .toString() method.
 
void put (string key, bool value)
 Places a key value pair into the dictionary.
 
void put (string key, bool[] value)
 Places a bool[] into the properties.
 
void put (string key, byte b)
 Places a byte into the properties.
 
void put (string key, byte[] b)
 Places a byte[] into the properties.
 
void put (string key, char c)
 Puts a char into the properties.
 
void put (string key, char[] c)
 Puts an array of chars into the properties.
 
void put (string key, double value)
 Places a key value pair into the dictionary.
 
void put (string key, double[] value)
 Places a double[] into the properties.
 
void put (string key, float value)
 Places a key value pair into the properties.
 
void put (string key, float[] value)
 Puts a float[] into the properties.
 
void put (string key, int value)
 Places a key value pair into the dictionary.
 
void put (string key, int[] value)
 Places a int[] into the properties.
 
void put (string key, long value)
 Places a key value pair into the dictionary.
 
void put (string key, long[] value)
 Places a long[] into the properties.
 
void put (string key, nEventProperties value)
 Put an nEventproperties into this one to enable nested properties.
 
void put (string key, nEventProperties[] value)
 Put an nEventProperies[] into this property to enable nested properties.
 
void put (string key, short s)
 places a short into the properties
 
void put (string key, short[] s)
 Places an array of shorts into the properties.
 
void put (string key, string value)
 Places a key value pair into the dictionary.
 
void put (string key, string[] value)
 Places a String[] into the properties.
 
void remove (string key)
 Removes the value index by the key.
 
string ToString ()
 Converts this object into a string.
 

Detailed Description

This class contains a collection of key-value pairs, defining event meta data which can be used to create filter rules.

Constructor & Destructor Documentation

◆ nEventProperties() [1/3]

com.pcbsys.nirvana.client.nEventProperties.nEventProperties ( nEventProperties  ed)

Constructs an event properties object that is a copy of the specified event properties.

Parameters
edthe event properties object to be copied

◆ nEventProperties() [2/3]

com.pcbsys.nirvana.client.nEventProperties.nEventProperties ( nEventProperties  ed,
bool  copyNew 
)

Constructs an event properties object that is a copy of the specified event properties, but depending on the copyNew, will construct new dictionary entries to prevent dictionary entries being overwritten by subsequent uses of the event object and event properties.

Parameters
edthe event properties object to be copied
copyNewre-construct the entries rather than copying the references to the new event properties

◆ nEventProperties() [3/3]

com.pcbsys.nirvana.client.nEventProperties.nEventProperties ( string  serializedString)

Constructor using a string from the .toString() method.

Parameters
serializedStringserialized string used to construct the nEventProperties

Member Function Documentation

◆ containsKey()

bool com.pcbsys.nirvana.client.nEventProperties.containsKey ( string  key)

Returns true if the key is contained within the dictionary.

Parameters
keyName of the key to search for
Returns
True if the properties contains the key

◆ copy()

void com.pcbsys.nirvana.client.nEventProperties.copy ( nEventProperties  p_dictionary)

Copies the properties from one to this.

Parameters
p_dictionarydictionary to copy

◆ get() [1/2]

object com.pcbsys.nirvana.client.nEventProperties.get ( object  key)

Get the value as an Object If the input paramter is not of type String, returns null.

Parameters
keyString key to return
Returns
Object of the value

◆ get() [2/2]

object com.pcbsys.nirvana.client.nEventProperties.get ( string  key)

Get the value as an Object.

Parameters
keyString key to return
Returns
Object of the value

◆ getBoolean()

bool com.pcbsys.nirvana.client.nEventProperties.getBoolean ( string  key)

Retrieves the data from the table based on the key as a bool.

Parameters
keyKey to reference the data
Returns
a bool with the value associated with this key

◆ getBooleanArray()

bool[] com.pcbsys.nirvana.client.nEventProperties.getBooleanArray ( string  key)

Retrieves a bool[] from the properties.

Parameters
keyName of the bool[]
Returns
bool[]

◆ getByte()

byte com.pcbsys.nirvana.client.nEventProperties.getByte ( string  key)

Retrieves a byte by the name given.

Parameters
keyName for the byte
Returns
byte value

◆ getByteArray()

byte[] com.pcbsys.nirvana.client.nEventProperties.getByteArray ( string  key)

Retrieves a byte[] from the dictionary.

Parameters
keyname for the byte[]
Returns
byte[]

◆ getChar()

char com.pcbsys.nirvana.client.nEventProperties.getChar ( string  key)

Retrieves a char from the properties.

Parameters
keyname of the char
Returns
char

◆ getCharArray()

char[] com.pcbsys.nirvana.client.nEventProperties.getCharArray ( string  key)

Retrieves a char[] from the properties.

Parameters
keyname of the char array
Returns
char[]

◆ getClass()

string com.pcbsys.nirvana.client.nEventProperties.getClass ( string  key)

Get the class name of the value represented by the key.

Parameters
keyString value to lookup
Returns
String class name of the value

◆ getDictionary()

nEventProperties com.pcbsys.nirvana.client.nEventProperties.getDictionary ( string  key)

Retrieve a nEventProperty from this one.

Parameters
keyName of the nEventProperty
Returns
a nEventProperty

◆ getDictionaryArray()

nEventProperties[] com.pcbsys.nirvana.client.nEventProperties.getDictionaryArray ( string  key)

Return an array of nEventProperties.

Parameters
keyname of the array to return
Returns
nEventproperty[]

◆ getDouble()

double com.pcbsys.nirvana.client.nEventProperties.getDouble ( string  key)

Retrieves the data from the table based on the key as a double.

Parameters
keyKey to reference the data
Returns
a double with the value associated with this key

◆ getDoubleArray()

double[] com.pcbsys.nirvana.client.nEventProperties.getDoubleArray ( string  key)

Retrieves a double[] from the properties.

Parameters
keyName of the double[]
Returns
double[]

◆ getEntrySet()

nEventPropertiesIterator com.pcbsys.nirvana.client.nEventProperties.getEntrySet ( )

Get an iterator of the key and values in an Map.Entry.

Allows the user to get both the key and value from one iteration of the nEventProperties.

Returns
nEventPropertiesIterator Map.Entrys in the properties

◆ getFloat()

float com.pcbsys.nirvana.client.nEventProperties.getFloat ( string  key)

Retrieves a float from the properties.

Parameters
keyName of the float
Returns
float value

◆ getFloatArray()

float[] com.pcbsys.nirvana.client.nEventProperties.getFloatArray ( string  key)

Retrieves a float[] from the properties.

Parameters
keyName of the float[]
Returns
float[]

◆ getInt()

int com.pcbsys.nirvana.client.nEventProperties.getInt ( string  key)

Retrieves an int from the properties.

Parameters
keyName of the int
Returns
int value

◆ getIntArray()

int[] com.pcbsys.nirvana.client.nEventProperties.getIntArray ( string  key)

Gets an int[] from the properties.

Parameters
keyName of the int[]
Returns
int[]

◆ getKeys()

IEnumerator< string > com.pcbsys.nirvana.client.nEventProperties.getKeys ( )

Get an IEnumerator of keys.

Returns
IEnumerator of keys

◆ getKeysAsStrings()

IEnumerator< string > com.pcbsys.nirvana.client.nEventProperties.getKeysAsStrings ( )

Get an IEnumerator of keys as Strings.

Returns
an IEnumerator of String objects representing the keys

◆ getLong()

long com.pcbsys.nirvana.client.nEventProperties.getLong ( string  key)

Retrieves the data from the table based on the key as a long.

Parameters
keyKey to reference the data
Returns
a long with the value associated with this key

◆ getLongArray()

long[] com.pcbsys.nirvana.client.nEventProperties.getLongArray ( string  key)

Retrieves a long[] from the properties.

Parameters
keyName of the long[]
Returns
long[]

◆ getShort()

short com.pcbsys.nirvana.client.nEventProperties.getShort ( string  key)

Retrieves a short from the properties.

Parameters
keyname of the short
Returns
short value

◆ getShortArray()

short[] com.pcbsys.nirvana.client.nEventProperties.getShortArray ( string  key)

Retrieves an array of shorts.

Parameters
keyname of the short array
Returns
short[]

◆ getSize()

int com.pcbsys.nirvana.client.nEventProperties.getSize ( )

Return the number of properties held.

Returns
int size

◆ getString()

string com.pcbsys.nirvana.client.nEventProperties.getString ( string  key)

Retrieves the data from the table based on the key as a string.

Parameters
keyKey to reference the data
Returns
a string with the value associated with this key

◆ getStringArray()

string[] com.pcbsys.nirvana.client.nEventProperties.getStringArray ( string  key)

Retrieves a String[].

Parameters
keyName of the String[]
Returns
String[]

◆ getValues()

IEnumerator< object > com.pcbsys.nirvana.client.nEventProperties.getValues ( )

Get an IEnumerator of values.

Returns
IEnumerator of values

◆ isValid()

bool com.pcbsys.nirvana.client.nEventProperties.isValid ( )

Returns true if the dictionary is consistent and contains no errors.

Returns
bool flag

◆ merge()

void com.pcbsys.nirvana.client.nEventProperties.merge ( nEventProperties  props,
bool  overwrite 
)

Adds the values from the supplied properties to this object.

If this object already has keys with the same name then the behaviour is driven by the bool overwrite.

Parameters
propsThe nEventProperties object to merge with this copy
overwriteIf true then duplicate values will take the new value

◆ put() [1/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
bool  value 
)

Places a key value pair into the dictionary.

Parameters
keyKey to reference the data
valueData to be stored

◆ put() [2/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
bool[]  value 
)

Places a bool[] into the properties.

Parameters
keyName of the boolean[]
valuebool[]

◆ put() [3/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
byte  b 
)

Places a byte into the properties.

Parameters
keyname for the byte
bbyte

◆ put() [4/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
byte[]  b 
)

Places a byte[] into the properties.

Parameters
keyname for the byte[]
bbyte[]

◆ put() [5/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
char  c 
)

Puts a char into the properties.

Parameters
keyName of the char
cchar value

◆ put() [6/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
char[]  c 
)

Puts an array of chars into the properties.

Parameters
keyName of the char[]
cchar[]

◆ put() [7/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
double  value 
)

Places a key value pair into the dictionary.

Parameters
keyKey to reference the data
valueData to be stored

◆ put() [8/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
double[]  value 
)

Places a double[] into the properties.

Parameters
keyName of the double[]
valuedouble[]

◆ put() [9/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
float  value 
)

Places a key value pair into the properties.

Parameters
keyKey to reference the data
valueData to be stored

◆ put() [10/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
float[]  value 
)

Puts a float[] into the properties.

Parameters
keyName of the float[]
valuefloat[]

◆ put() [11/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
int  value 
)

Places a key value pair into the dictionary.

Parameters
keyKey to reference the data
valueData to be stored

◆ put() [12/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
int[]  value 
)

Places a int[] into the properties.

Parameters
keyName of the key
valueint[]

◆ put() [13/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
long  value 
)

Places a key value pair into the dictionary.

Parameters
keyKey to reference the data
valueData to be stored

◆ put() [14/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
long[]  value 
)

Places a long[] into the properties.

Parameters
keyname of the long[]
valuelong[]

◆ put() [15/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
nEventProperties  value 
)

Put an nEventproperties into this one to enable nested properties.

Parameters
keyname of this value
valuenEventProperty to insert

◆ put() [16/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
nEventProperties[]  value 
)

Put an nEventProperies[] into this property to enable nested properties.

Parameters
keyName to call this
valueArray of nEventProperties

◆ put() [17/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
short  s 
)

places a short into the properties

Parameters
keyname of the short
sshort value

◆ put() [18/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
short[]  s 
)

Places an array of shorts into the properties.

Parameters
keyName for the array
sshort[]

◆ put() [19/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
string  value 
)

Places a key value pair into the dictionary.

Parameters
keyKey to reference the data
valueData to be stored

◆ put() [20/20]

void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
string[]  value 
)

Places a String[] into the properties.

Parameters
keyName for the value
valueString[]

◆ remove()

void com.pcbsys.nirvana.client.nEventProperties.remove ( string  key)

Removes the value index by the key.

Parameters
keyKey to remove

◆ ToString()

string com.pcbsys.nirvana.client.nEventProperties.ToString ( )

Converts this object into a string.

Returns
String representation of this object