tibasSpaceEvent_GetType()

Returns the type of an event generated by ActiveSpaces.

Declaration

tibas_status tibasSpaceEvent_GetType(
    tibasSpaceEvent     spaceEvent,
    tibas_eventType*    eventType)

Parameters

Parameter Description
spaceEvent Specify the spaceEvent for which you want to return the event type.
eventType The type of event. Possible values are TIBAS_EVENT_PUT, TIBAS_EVENT_TAKE, TIBAS_EVENT_EXPIRE, TIBAS_EVENT_SEED, or TIBAS_EVENT_UNSEED.

Remarks

Use the tibasSpaceEvent_GetType() function to return the event type for a specified space event. This is useful when implementing a callback function used with a space browser.

The eventType parameter can return the following values:

  • TIBAS_EVENT_PUT when a tuple is inserted, overwritten, or updated.
  • TIBAS_EVENT_TAKE when a tuple is taken or removed.
  • TIBAS_EVENT_EXPIRE when a tuple reaches the end of its time to live and expires from the space.
  • TIBAS_EVENT_SEED when there is redistribution after a seeder joins or leaves, and the local node is seeding or unseeding. This is only applicable if the listener distribution scope is SEEDED.
  • TIBAS_EVENT_UNSEED when there is redistribution after a seeder joins or leaves, and the local node is seeding or unseeding. This is only applicable if the listener’s distribution scope is SEEDED.

See Also

tibasListener_Create(), tibasSpaceEvent_GetTuple()