blpapi::Event Class Reference

#include <blpapi_event.h>

List of all members.

Public Types
enum	EventType {   ADMIN = BLPAPI_EVENTTYPE_ADMIN, SESSION_STATUS = BLPAPI_EVENTTYPE_SESSION_STATUS, SUBSCRIPTION_STATUS = BLPAPI_EVENTTYPE_SUBSCRIPTION_STATUS, REQUEST_STATUS = BLPAPI_EVENTTYPE_REQUEST_STATUS,   RESPONSE = BLPAPI_EVENTTYPE_RESPONSE, PARTIAL_RESPONSE = BLPAPI_EVENTTYPE_PARTIAL_RESPONSE, SUBSCRIPTION_DATA = BLPAPI_EVENTTYPE_SUBSCRIPTION_DATA, SERVICE_STATUS = BLPAPI_EVENTTYPE_SERVICE_STATUS,   TIMEOUT = BLPAPI_EVENTTYPE_TIMEOUT, AUTHORIZATION_STATUS = BLPAPI_EVENTTYPE_AUTHORIZATION_STATUS, RESOLUTION_STATUS = BLPAPI_EVENTTYPE_RESOLUTION_STATUS, TOPIC_STATUS = BLPAPI_EVENTTYPE_TOPIC_STATUS,   TOKEN_STATUS = BLPAPI_EVENTTYPE_TOKEN_STATUS, REQUEST = BLPAPI_EVENTTYPE_REQUEST, UNKNOWN = -1 }
	The possible types of event. More...
Public Member Functions
	Event ()
	Event (blpapi_Event_t *handle)
	Event (const Event &original)
	~Event ()
Event &	operator= (const Event &rhs)
EventType	eventType () const
bool	isValid () const
blpapi_Event_t *	impl () const

---

Detailed Description

A single event resulting from a subscription or a request.

Event objects are created by the API and passed to the application either through a registered EventHandler or EventQueue or returned from the Session::nextEvent() method. Event objects contain Message objects which can be accessed using a MessageIterator.

The Event object is a handle to an event. The event is the basic unit of work provided to applications. Each Event object consists of an EventType attribute and zero or more Message objects. The underlying event data including the messages is reference counted - as long as at least one Event object still exists then the underlying data will not be freed.

---

Member Enumeration Documentation

enum blpapi::Event::EventType

The possible types of event.

Enumerator:

ADMIN	Admin event.
SESSION_STATUS	Status updates for a session.
SUBSCRIPTION_STATUS	Status updates for a subscription.
REQUEST_STATUS	Status updates for a request.
RESPONSE	The final (possibly only) response to a request.
PARTIAL_RESPONSE	A partial response to a request.
SUBSCRIPTION_DATA	Data updates resulting from a subscription.
SERVICE_STATUS	Status updates for a service.
TIMEOUT	An Event returned from nextEvent() if it timed out.
AUTHORIZATION_STATUS	Status updates for user authorization.
RESOLUTION_STATUS	Status updates for a resolution operation.
TOPIC_STATUS	Status updates about topics for service providers.
TOKEN_STATUS	Status updates for a generate token request.
REQUEST	Request event.
UNKNOWN

---

Constructor & Destructor Documentation

blpapi::Event::Event

(

)

Construct an uninitialized Event. The only valid operations on an uninitialized Event are assignment, isValid() and destruction.

blpapi::Event::Event

(

blpapi_Event_t *

handle

)

blpapi::Event::Event

(

const Event &

original

)

Copy constructor. This performs a shallow copy, increasing the reference count on the actual data underlying this handle.

blpapi::Event::~Event

(

)

Destructor. If this is the last reference to this Event then the underlying data (including all Messages associated with the Event) are invalidated.

---

Member Function Documentation

Event& blpapi::Event::operator=

(

const Event &

rhs

)

Assignment operator. This performs a shallow assignment, increasing the reference count on the actual data underlying this handle.

EventType blpapi::Event::eventType

(

)

const

Returns the type of messages contained by this Event.

bool blpapi::Event::isValid

(

)

const

Returns true if this Event is a valid event.

blpapi_Event_t* blpapi::Event::impl

(

)

const

---

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

• blpapi_event.h