Public Types | Public Member Functions | Static Public Member Functions

blpapi::ResolutionList Class Reference

#include <blpapi_resolutionlist.h>

List of all members.

Public Types

enum  Status {
  UNRESOLVED = BLPAPI_RESOLUTIONLIST_UNRESOLVED, RESOLVED = BLPAPI_RESOLUTIONLIST_RESOLVED, RESOLUTION_FAILURE_BAD_SERVICE = BLPAPI_RESOLUTIONLIST_RESOLUTION_FAILURE_BAD_SERVICE, RESOLUTION_FAILURE_SERVICE_AUTHORIZATION_FAILED = BLPAPI_RESOLUTIONLIST_RESOLUTION_FAILURE_SERVICE_AUTHORIZATION_FAILED,
  RESOLUTION_FAILURE_BAD_TOPIC = BLPAPI_RESOLUTIONLIST_RESOLUTION_FAILURE_BAD_TOPIC, RESOLUTION_FAILURE_TOPIC_AUTHORIZATION_FAILED = BLPAPI_RESOLUTIONLIST_RESOLUTION_FAILURE_TOPIC_AUTHORIZATION_FAILED
}

Public Member Functions

 ResolutionList ()
 ResolutionList (const ResolutionList &original)
virtual ~ResolutionList ()
virtual int add (const char *topic, const CorrelationId &correlationId=CorrelationId())
virtual int add (Message const &topicSubscribedMessage, const CorrelationId &correlationId=CorrelationId())
int addAttribute (const Name &attribute)
virtual CorrelationId correlationIdAt (size_t index) const
virtual const char * topicString (const CorrelationId &correlationId) const
virtual const char * topicStringAt (size_t index) const
virtual int status (const CorrelationId &correlationId) const
virtual int statusAt (size_t index) const
Element attribute (const Name &attribute, const CorrelationId &correlationId) const
Element attributeAt (const Name &attribute, size_t index) const
virtual Message const message (const CorrelationId &correlationId) const
virtual Message const messageAt (size_t index) const
virtual size_t size () const
const blpapi_ResolutionList_timpl () const
blpapi_ResolutionList_timpl ()

Static Public Member Functions

static Element extractAttributeFromResolutionSuccess (Message const &message, Name const &attribute)

Detailed Description

Contains a list of topics that require resolution.

Created from topic strings or from TopicSubscribed messages This is passed to a resolve() call or resolveAsync() call on a ProviderSession. It is updated and returned by the resolve() call.

See Component blpapi_resolutionlist


Member Enumeration Documentation

Enumerator:
UNRESOLVED 
RESOLVED 
RESOLUTION_FAILURE_BAD_SERVICE 
RESOLUTION_FAILURE_SERVICE_AUTHORIZATION_FAILED 
RESOLUTION_FAILURE_BAD_TOPIC 
RESOLUTION_FAILURE_TOPIC_AUTHORIZATION_FAILED 

Constructor & Destructor Documentation

blpapi::ResolutionList::ResolutionList (  ) 

Create an empty ResolutionList.

blpapi::ResolutionList::ResolutionList ( const ResolutionList original  ) 

Copy constructor.

virtual blpapi::ResolutionList::~ResolutionList (  )  [virtual]

Destroy this ResolutionList.


Member Function Documentation

static Element blpapi::ResolutionList::extractAttributeFromResolutionSuccess ( Message const &  message,
Name const &  attribute 
) [static]

DEPRECATED: Attributes are no longer supported.

Return the value of the value in the specified message which represents the specified attribute. The message must be a message of type "RESOLUTION_SUCCESS". The attribute should be an attribute that was requested using addAttribute() on the ResolutionList passed to the resolve() or resolveAsync() that caused this RESOLUTION_SUCCESS message. If the attribute is not present an empty Element is returned.

virtual int blpapi::ResolutionList::add ( const char *  topic,
const CorrelationId correlationId = CorrelationId() 
) [virtual]

Add the specified topic to this list, optionally specifying a correlationId. Returns 0 on success or negative number on failure. After a successful call to add() the status for this entry is UNRESOLVED_TOPIC.

virtual int blpapi::ResolutionList::add ( Message const &  topicSubscribedMessage,
const CorrelationId correlationId = CorrelationId() 
) [virtual]

Add the topic contained in the specified TopicSubscribed message to this list, optionally specifying a correlationId. Returns 0 on success or a negative number on failure. After a successful call to add() the status for this entry is UNRESOLVED_TOPIC.

int blpapi::ResolutionList::addAttribute ( const Name attribute  ) 

DEPRECATED: Attributes are no longer supported.

Add the specified attribute to the list of attributes requested during resolution for each topic in this ResolutionList. Returns 0 on success or a negative number on failure.

virtual CorrelationId blpapi::ResolutionList::correlationIdAt ( size_t  index  )  const [virtual]

Returns the CorrelationId of the specified indexth entry in this ResolutionList. If index >= size() an exception is thrown.

virtual const char* blpapi::ResolutionList::topicString ( const CorrelationId correlationId  )  const [virtual]

Returns a pointer to the topic of the entry identified by the specified correlationId. If the correlationId does not identify an entry in this ResolutionList then an exception is thrown.

virtual const char* blpapi::ResolutionList::topicStringAt ( size_t  index  )  const [virtual]

Returns a pointer to the topic of the specified indexth entry. If index >= size() an exception is thrown.

virtual int blpapi::ResolutionList::status ( const CorrelationId correlationId  )  const [virtual]

Returns the status of the entry in this ResolutionList identified by the specified correlationId. This may be UNRESOLVED, RESOLVED, RESOLUTION_FAILURE_BAD_SERVICE, RESOLUTION_FAILURE_SERVICE_AUTHORIZATION_FAILED RESOLUTION_FAILURE_BAD_TOPIC, RESOLUTION_FAILURE_TOPIC_AUTHORIZATION_FAILED. If the correlationId does not identify an entry in this ResolutionList then an exception is thrown.

virtual int blpapi::ResolutionList::statusAt ( size_t  index  )  const [virtual]

Returns the status of the specified indexth entry in this ResolutionList. This may be UNRESOLVED, RESOLVED, RESOLUTION_FAILURE_BAD_SERVICE, RESOLUTION_FAILURE_SERVICE_AUTHORIZATION_FAILED RESOLUTION_FAILURE_BAD_TOPIC, RESOLUTION_FAILURE_TOPIC_AUTHORIZATION_FAILED. If index >= size() an exception is thrown.

Element blpapi::ResolutionList::attribute ( const Name attribute,
const CorrelationId correlationId 
) const

DEPRECATED: Attributes are no longer supported.

Returns the value for the specified attribute of the entry in this ResolutionList identified by the specified correlationId. The Element returned may be empty if the resolution service cannot provide the attribute. If correlationId does not identify an entry in this ResolutionList or if the status of the entry identified by correlationId is not RESOLVED an exception is thrown.

Element blpapi::ResolutionList::attributeAt ( const Name attribute,
size_t  index 
) const

DEPRECATED: Attributes are no longer supported.

Returns the value for the specified attribute of the specified indexth entry in this ResolutionList. The Element returned may be empty if the resolution service cannot provide the attribute. If index >= size() or if the status of the indexth entry is not RESOLVED an exception is thrown.

virtual Message const blpapi::ResolutionList::message ( const CorrelationId correlationId  )  const [virtual]

Returns the value of the message received during resolution of the topic identified by the specified correlationId. If correlationId does not identify an entry in this ResolutionList or if the status of the entry identify by correlationId is not RESOLVED an exception is thrown.

The message returned can be used when creating an instance of Topic.

virtual Message const blpapi::ResolutionList::messageAt ( size_t  index  )  const [virtual]

Returns the value of the message received during resolution of the specified indexth entry in this ResolutionList. If index >= size() or if the status of the indexth entry is not RESOLVED an exception is thrown.

The message returned can be used when creating an instance of Topic.

virtual size_t blpapi::ResolutionList::size (  )  const [virtual]

Returns the number of entries in this list.

const blpapi_ResolutionList_t* blpapi::ResolutionList::impl (  )  const
blpapi_ResolutionList_t* blpapi::ResolutionList::impl (  ) 

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