tibasSpace_GetAll()

Batch version of the tibasSpace_Get() function. Returns a list of tuples matching key values that you provide.

Declaration

tibas_status tibasSpace_GetAll
     (tibasSpace space,
      tibasSpaceResultList *resultList,
      tibasTupleList keyList)

Parameters

Parameter Description
space The TIBCO ActiveSpaces entity on which the function is invoked.
resultList The list of tuples returned by the function.
keyList Provided list of tuples containing key fields.

Remarks

Use the tibasSpace_GetAll() function to return a list of tuples that match key values that you provide.

To use tibasSpace_GetAll(), you must create and populate a keyList containing the keys to search for, which you then pass to the function in the keyList parameter. To create a keyList, you call the tibasTupleList_Create() function. To add keys to the list, you call the tibasTupleList_Put() function.

You must also initialize a tibasSpaceResultList object, which you pass to the function in the resultList parameter.

The function returns a resultList that contains the tuples returned by the get operations.

For more information on Result lists, see the reference articles in, SpaceResult and InvokeResult and in, SpaceResultList and InvokeResultList.

After you are done with the keyList, free it by calling the tibasTupleList_Free() function, and after you are done with the Result list, free it by calling the tibasSpaceResultList_Free() function.