tibasSpace_GetEx()

Returns a tuple (if one exists) from the specified space whose key fields match the key fields of the specified tuple. It also allows you to add a filter and the list of fields to be returned.

Declaration

tibas_status tibasSpace_GetEx(
    tibasSpace space,
    tibasTuple* value,
    tibasTuple key,
    tibasGetOptions options);

Parameters

Parameter Description
space The TIBCO ActiveSpaces entity on which the function is invoked.
Value A pointer to the tuple returned by the function.
key A tuple containing one or more key fields.
options Options for the get operation.

Remarks

Use the tibasSpace_GetEx() function to return a tuple (if one exists) from the specified space whose key fields match the key fields of the specified tuple. It also allows you to add a filter and the list of fields to be returned.

The options parameter specifies a tibasGetOptions structure that specifies options for the get. The tibasGetOptions structure is defined as follows: 

struct _tibasGetOptions {
    void* optionPtr;
    void* resultHandler;
    void* closure;
};
You can use the get/set methods defined for tibasGetOptions to set the attributes of the structure. See tibasGetOptions.

See Also

tibasSpace_GetAll(), tibasSpace_CompareAndPut(), tibasSpace_CompareAndPutEx(), tibasSpace_CompareAndPutAll(),tibasSpace_CompareAndPutAllEx(), tibasSpace_CompareAndTake(), tibasSpace_CompareAndTakeEx(), tibasSpace_CompareAndTakeAll(), tibasSpace_CompareAndTakeAllEx(), tibasSpace_Put(), tibasSpace_PutEx(), tibasSpace_PutAll(). tibasSpace_CompareAndPutAllEx(), tibasSpace_Take(), tibasSpace_TakeEx(), tibasSpace_TakeAll(), tibasSpace_TakeAllEx()