blpapi::TopicList Class Reference

#include <blpapi_topiclist.h>

List of all members.

Public Types
enum	Status { NOT_CREATED = BLPAPI_TOPICLIST_NOT_CREATED, CREATED = BLPAPI_TOPICLIST_CREATED, FAILURE = BLPAPI_TOPICLIST_FAILURE }
Public Member Functions
	TopicList ()
	TopicList (const ResolutionList &original)
	TopicList (const TopicList &original)
virtual	~TopicList ()
virtual int	add (const char *topic, const CorrelationId &correlationId=CorrelationId())
virtual int	add (Message const &message, const CorrelationId &correlationId=CorrelationId())
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
virtual Message const	message (const CorrelationId &correlationId) const
virtual Message const	messageAt (size_t index) const
virtual size_t	size () const
const blpapi_TopicList_t *	impl () const
blpapi_TopicList_t *	impl ()

---

Detailed Description

Contains a list of topics which require creation.

Created from topic strings or from TOPIC_SUBSCRIBED or RESOLUTION_SUCCESS messages. This is passed to a createTopics() call or createTopicsAsync() call on a ProviderSession. It is updated and returned by the createTopics() call.

See Component blpapi_topiclist

---

Member Enumeration Documentation

enum blpapi::TopicList::Status

Enumerator:

NOT_CREATED
CREATED
FAILURE

---

Constructor & Destructor Documentation

blpapi::TopicList::TopicList

(

)

Create an empty TopicList.

blpapi::TopicList::TopicList

(

const ResolutionList &

original

)

Create a topic list from ResolutionList. User has previously resolved topics in ResolutionList and wants to now createTopics.

blpapi::TopicList::TopicList

(

const TopicList &

original

)

Copy constructor.

virtual blpapi::TopicList::~TopicList

(

)

[virtual]

Destroy this TopicList.

---

Member Function Documentation

virtual int blpapi::TopicList::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 NOT_CREATED.

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

Add the topic contained in the specified topicSubscribedMessage or resolutionSuccessMessage 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 NOT_CREATED.

virtual CorrelationId blpapi::TopicList::correlationIdAt

(

size_t

index

)

const [virtual]

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

virtual const char* blpapi::TopicList::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 TopicList then an exception is thrown.

virtual const char* blpapi::TopicList::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::TopicList::status

(

const CorrelationId &

correlationId

)

const [virtual]

Returns the status of the entry in this TopicList identified by the specified correlationId. This may be NOT_CREATED, CREATED and FAILURE. If the correlationId does not identify an entry in this TopicList then an exception is thrown.

virtual int blpapi::TopicList::statusAt

(

size_t

index

)

const [virtual]

Returns the status of the specified indexth entry in this TopicList. This may be NOT_CREATED, CREATED and FAILURE. If index >= size() an exception is thrown.

virtual Message const blpapi::TopicList::message

(

const CorrelationId &

correlationId

)

const [virtual]

Returns the value of the message received during creation of the topic identified by the specified correlationId. If correlationId does not identify an entry in this TopicList, an exception is thrown.

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

virtual Message const blpapi::TopicList::messageAt

(

size_t

index

)

const [virtual]

Returns the value of the message received during creation of the specified indexth entry in this TopicList. If index >= size(), an exception is thrown.

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

virtual size_t blpapi::TopicList::size

(

)

const [virtual]

Returns the number of entries in this list.

const blpapi_TopicList_t* blpapi::TopicList::impl

(

)

const

blpapi_TopicList_t* blpapi::TopicList::impl

(

)

---

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

• blpapi_topiclist.h