AP_PluginType_Functions Struct Reference

#include <correlator_plugin.h>

Public Member Functions
	AP_TypeDiscriminator (AP_PLUGIN_CALL *getDiscriminator)(const AP_PluginType *obj)
AP_PluginChunk *AP_PLUGIN_CALL *	getChunkValue (const AP_PluginType *obj)
	void (AP_PLUGIN_CALL *setChunkValue)(const AP_PluginType *obj
	AP_int64 (AP_PLUGIN_CALL *getIntegerValue)(const AP_PluginType *obj)
	void (AP_PLUGIN_CALL *setIntegerValue)(AP_PluginType *obj
	AP_float64 (AP_PLUGIN_CALL *getFloatValue)(const AP_PluginType *obj)
	void (AP_PLUGIN_CALL *setFloatValue)(AP_PluginType *obj
	AP_decimal (AP_PLUGIN_CALL *getDecimalValue)(const AP_PluginType *obj)
	void (AP_PLUGIN_CALL *setDecimalValue)(AP_PluginType *obj
	AP_bool (AP_PLUGIN_CALL *getBooleanValue)(const AP_PluginType *obj)
	void (AP_PLUGIN_CALL *setBooleanValue)(AP_PluginType *obj
const AP_char8 *AP_PLUGIN_CALL *	getStringValue (const AP_PluginType *obj)
	void (AP_PLUGIN_CALL *setStringValue)(AP_PluginType *obj
	AP_uint32 (AP_PLUGIN_CALL *getSequenceLength)(const AP_PluginType *obj)
	void (AP_PLUGIN_CALL *setSequenceLength)(const AP_PluginType *obj
	AP_TypeDiscriminator (AP_PLUGIN_CALL *getSequenceType)(const AP_PluginType *obj)
	void (AP_PLUGIN_CALL *createSequence)(const AP_PluginType *obj
AP_PluginType *AP_PLUGIN_CALL *	getSequenceElement (const AP_PluginType *obj, AP_uint32 index)
	void (AP_PLUGIN_CALL *copyFrom)(const AP_PluginType *obj
AP_PluginType *const *AP_PLUGIN_CALL *	getSequenceElements (const AP_PluginType *obj, AP_uint32 start, AP_uint32 length)
	void (AP_PLUGIN_CALL *releaseSequenceElements)(const AP_PluginType *obj)
AP_PluginChunk *const *AP_PLUGIN_CALL *	getChunkSequenceElements (const AP_PluginType *obj, AP_uint32 start, AP_uint32 length)
	void (AP_PLUGIN_CALL *releaseChunkSequenceElements)(const AP_PluginType *obj)
AP_int64 *AP_PLUGIN_CALL *	getIntegerSequenceElements (const AP_PluginType *obj, AP_uint32 start, AP_uint32 length)
	void (AP_PLUGIN_CALL *releaseIntegerSequenceElements)(const AP_PluginType *obj)
AP_float64 *AP_PLUGIN_CALL *	getFloatSequenceElements (const AP_PluginType *obj, AP_uint32 start, AP_uint32 length)
	void (AP_PLUGIN_CALL *releaseFloatSequenceElements)(const AP_PluginType *obj)
AP_decimal *AP_PLUGIN_CALL *	getDecimalSequenceElements (const AP_PluginType *obj, AP_uint32 start, AP_uint32 length)
	void (AP_PLUGIN_CALL *releaseDecimalSequenceElements)(const AP_PluginType *obj)
AP_bool *AP_PLUGIN_CALL *	getBooleanSequenceElements (const AP_PluginType *obj, AP_uint32 start, AP_uint32 length)
	void (AP_PLUGIN_CALL *releaseBooleanSequenceElements)(const AP_PluginType *obj)
const AP_char8 **AP_PLUGIN_CALL *	getStringSequenceElements (const AP_PluginType *obj, AP_uint32 start, AP_uint32 length)
	void (AP_PLUGIN_CALL *releaseStringSequenceElements)(const AP_PluginType *obj)

Detailed Description

Deprecated:

AP_Type function API

Member Function Documentation

AP_PluginType_Functions::AP_bool

(

AP_PLUGIN_CALL *

getBooleanValue

)

const

Deprecated:

Get the boolean value of the object

AP_PluginType_Functions::AP_decimal

(

AP_PLUGIN_CALL *

getDecimalValue

)

const

Deprecated:

Get the decimal value of the object

AP_PluginType_Functions::AP_float64

(

AP_PLUGIN_CALL *

getFloatValue

)

const

Deprecated:

Get the float value of the object

AP_PluginType_Functions::AP_int64

(

AP_PLUGIN_CALL *

getIntegerValue

)

const

Deprecated:

Get the integer value of the object

AP_PluginType_Functions::AP_TypeDiscriminator

(

AP_PLUGIN_CALL *

getDiscriminator

)

const

Deprecated:

Return the type contained in this object

AP_PluginType_Functions::AP_TypeDiscriminator

(

AP_PLUGIN_CALL *

getSequenceType

)

const

Deprecated:

Get the element type of a sequence object

AP_PluginType_Functions::AP_uint32

(

AP_PLUGIN_CALL *

getSequenceLength

)

const

Deprecated:

Get the number of elements in a sequence object

AP_bool* AP_PLUGIN_CALL* AP_PluginType_Functions::getBooleanSequenceElements	(	const AP_PluginType *	obj,
		AP_uint32	start,
		AP_uint32	length
	)

Deprecated:

Generate an array of booleans encapsulating elements [start..start+length-1] of the sequence object.

This may or may not require copying the original EPL objects.

AP_PluginChunk* const* AP_PLUGIN_CALL* AP_PluginType_Functions::getChunkSequenceElements	(	const AP_PluginType *	obj,
		AP_uint32	start,
		AP_uint32	length
	)

Deprecated:

Generate an array of pointers to chunks encapsulating elements [start..start+length-1] of the sequence object.

This may or may not require copying the original EPL objects.

Note that the AP_Chunk pointers cannot be modified via this call. Use sequenceElement(), visitSequenceElements() or sequenceElements() instead, being sure to free any AP_Chunk instances that are replaced.

AP_PluginChunk* AP_PLUGIN_CALL* AP_PluginType_Functions::getChunkValue

(

const AP_PluginType *

obj

)

Deprecated:

Get the chunk value of the object

AP_decimal* AP_PLUGIN_CALL* AP_PluginType_Functions::getDecimalSequenceElements	(	const AP_PluginType *	obj,
		AP_uint32	start,
		AP_uint32	length
	)

Deprecated:

Generate an array of decimals encapsulating elements [start..start+length-1] of the sequence object.

This may or may not require copying the original EPL objects.

AP_float64* AP_PLUGIN_CALL* AP_PluginType_Functions::getFloatSequenceElements	(	const AP_PluginType *	obj,
		AP_uint32	start,
		AP_uint32	length
	)

Deprecated:

Generate an array of floats encapsulating elements [start..start+length-1] of the sequence object.

This may or may not require copying the original EPL objects.

AP_int64* AP_PLUGIN_CALL* AP_PluginType_Functions::getIntegerSequenceElements	(	const AP_PluginType *	obj,
		AP_uint32	start,
		AP_uint32	length
	)

Deprecated:

Generate an array of integers encapsulating elements [start..start+length-1] of the sequence object.

This may or may not require copying the original EPL objects.

AP_PluginType* AP_PLUGIN_CALL* AP_PluginType_Functions::getSequenceElement	(	const AP_PluginType *	obj,
		AP_uint32	index
	)

Deprecated:

Get a pointer to a single sequence element.

The element AP_Type remains usable until the sequence AP_Type is destroyed.

AP_PluginType* const* AP_PLUGIN_CALL* AP_PluginType_Functions::getSequenceElements	(	const AP_PluginType *	obj,
		AP_uint32	start,
		AP_uint32	length
	)

Deprecated:

Generate an array of pointers to AP_Type objects, encapsulating elements [start..start+length-1] of the sequence object.

This may or may not require copying the original EPL objects.

const AP_char8** AP_PLUGIN_CALL* AP_PluginType_Functions::getStringSequenceElements	(	const AP_PluginType *	obj,
		AP_uint32	start,
		AP_uint32	length
	)

Deprecated:

Generate an array of string pointers encapsulating elements [start..start+length-1] of the sequence object.

This may or may not require copying the original EPL objects. Strings pointed to by this sequence are only valid for the lifetime of a call into the plugin.

const AP_char8* AP_PLUGIN_CALL* AP_PluginType_Functions::getStringValue

(

const AP_PluginType *

obj

)

Deprecated:

Get the string value of the object

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

setChunkValue

)

const

Deprecated:

Set the chunk value of the object.

The correlator takes ownership of the new AP_PluginChunk; it should not be deleted by the plugin.

The new pointer may be null.

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

setIntegerValue

)

Deprecated:

Set the integer value of the object

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

setFloatValue

)

Deprecated:

Set the float value of the object

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

setDecimalValue

)

Deprecated:

Set the decimal value of the object

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

setBooleanValue

)

Deprecated:

Set the boolean value of the object

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

setStringValue

)

Deprecated:

Set the string value of the object.

Note that this is only possible on sequence elements and return values, not arguments (which are const)

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

setSequenceLength

)

const

Deprecated:

Set the length of a sequence object.

Increasing the length will populate the sequence with default-initialised objects. Decreasing the length will remove items from the end.

You are not permitted to call setSequenceLength after calling sequenceElements without releasing the elements. If you call setSequenceLength any references returned from sequenceElement or operator[] are invalid and may not be used.

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

createSequence

)

const

Deprecated:

Take an uninitialised sequence object and create an empty sequence with the indicated member type.

Member type can only be primitives, string or chunk.

Typically used for return values from functions.

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

copyFrom

)

const

Deprecated:

Copy another AP_Type into this, regardless of type

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

releaseSequenceElements

)

const

Deprecated:

Free the resources allocated by all preceding calls to sequenceElements() and ensures that any changes made to the sequence elements are reflected in the underlying EPL objects.

Any arrays previously returned by sequenceElements() immediately become invalid. This function is automatically called when a sequence AP_Type is destroyed, but can be invoked explicitly by a plugin to copy changes back during a long-running computation.

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

releaseChunkSequenceElements

)

const

Deprecated:

Free the resources allocated by all preceding calls to chunkSequenceElements().

Arrays previously returned by chunkSequenceElements() immediately become invalid. This function is automatically called when a sequence AP_Type is destroyed, but can be invoked explicitly by a plugin during a long-running computation.

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

releaseIntegerSequenceElements

)

const

Deprecated:

Free the resources allocated by all preceding calls to integerSequenceElements() and ensures that any changes made to the sequence elements are reflected in the underlying EPL objects.

Arrays previously returned by integerSequenceElements() immediately become invalid. This function is automatically called when a sequence AP_Type is destroyed, but can be invoked explicitly by a plugin to copy changes back during a long-running computation.

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

releaseFloatSequenceElements

)

const

Deprecated:

Free the resources allocated by all preceding calls to floatSequenceElements() and ensures that any changes made to the sequence elements are reflected in the underlying EPL objects.

Arrays previously returned by floatSequenceElements() immediately become invalid. This function is automatically called when a sequence AP_Type is destroyed, but can be invoked explicitly by a plugin to copy changes back during a long-running computation.

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

releaseDecimalSequenceElements

)

const

Deprecated:

Free the resources allocated by all preceding calls to getDecimalSequenceElements() and ensures that any changes made to the sequence elements are reflected in the underlying EPL objects.

Arrays previously returned by getDecimalSequenceElements() immediately become invalid. This function is automatically called when a sequence AP_Type is destroyed, but can be invoked explicitly by a plugin to copy changes back during a long-running computation.

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

releaseBooleanSequenceElements

)

const

Deprecated:

Free the resources allocated by all preceding calls to booleanSequenceElements() and ensures that any changes made to the sequence elements are reflected in the underlying EPL objects.

Arrays previously returned by booleanSequenceElements() immediately become invalid. This function is automatically called when a sequence AP_Type is destroyed, but can be invoked explicitly by a plugin to copy changes back during a long-running computation.

AP_PluginType_Functions::void

(

AP_PLUGIN_CALL *

releaseStringSequenceElements

)

const

Deprecated:

Free the resources allocated by all preceding calls to stringSequenceElements() and copies any changes made to the sequence elements to the underlying EPL objects.

Arrays previously returned by stringSequenceElements() immediately become invalid. This function is automatically called when a sequence AP_Type is destroyed, but can be invoked explicitly by a plugin to copy changes back during a long-running computation.

Note that string sequence element arrays do not own the strings they reference and will never delete a string the plugin has placed in the array - if the plugin has set a value, it must delete that string (and it cannot use the value in the array returned from stringSequenceElement

• plugins will need to keep another pointer to any new strings they create.

---

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

• correlator_plugin.h