auto arg = new MessageArgument([&](const MessageArgument& arg, void* message)->int {
  auto msg = static_cast<Message*>(message);
  // handle message in msg
  return 1;
});

//...
arg->SendMessage("MyCommand", "MyValue=7");

Member Function Documentation

MessageArgument::MessageArgument()

Constructs a MessageArgument with no handler.

Default MessageArgument will only forward received message to any routings set.

MessageArgument::MessageArgument(const std::function<int( const MessageArgument &, void * ) > &handler)

Constructs a MessageArgument.

Argument handler is the std::function callback the is called when message is received.

It is possible to pass in either a C++ lambda function as handler or use std::bind to bind an existing function from the using class as the handler.

MessageArgument::MessageArgument(const std::function<int( const MessageArgument & arg, const MessagePacketHandle & handle ) > &handler)

Copy constructor.

unsigned int MessageArgument::Command() const

Gets the configured Command value

Returns Command value

[override virtual] void MessageArgument::Configure(XMLPrimitive *pObjectElement)

Reimplemented from CDPBaseObject::Configure().

Registers to receive messages defined by Command and TextCommand properties and connects to RoutingList objects when provided.

[override virtual] void MessageArgument::Create(const char *shortName, CDPBaseObject *pParentObject)

Reimplemented from CDPBaseObject::Create().

Adds the current MessageArgument to CDPEngine as possible target for messages.

std::string MessageArgument::GetPayload(void *message) const

bool MessageArgument::IsConnected() const

Gets the connected status

Returns true if MessageArgument is connected to all objects indicated in the RoutingList property

bool MessageArgument::IsForward() const

Get the state of auto message forwarding.

Returns true if MessageArgument will forward all received messages to all connected objects indicated in the RoutingList property

bool MessageArgument::IsInput() const

Gets the value of Input property

Returns true if MessageArgument is an input

[override virtual] void MessageArgument::ReportFailedReceive(const MessagePacketHandle &handle, const std::string &source)

Reimplemented from CDPBaseObject::ReportFailedReceive().

std::string MessageArgument::RoutingList() const

Gets the configured RoutingList value

Returns RoutingList value

unsigned int MessageArgument::SendMessage(const std::string &command, const std::string &parameter = "", unsigned int origin = 0)

Sends message based on MessageArgument Command and TextCommand properties and passed in arguments

When Command is 0x20100 (CM_TEXTCOMMAND) and TextCommand is empty, it will use the provided command as the text command string and parameter as parameter data.

When Command is 0x20100 (CM_TEXTCOMMAND) and TextCommand is set, it will use TextCommand instead of command as the text command string and parameter as parameter data.

When Command is not 0x20100 (CM_TEXTCOMMAND), it will ignore all arguments besides origin and use Command as the sent binary command.

Returns 1 on success or 0 when there are no targets or some targets have no routing set.

unsigned int MessageArgument::SendMessage(const MessagePacketHandle &handle)

Sends Message contained in MessagePacketHandle handle parameter to all configured targets.

Returns 1 on success or 0 when there are no targets or some targets have no routing set.

unsigned int MessageArgument::SendPayload(const std::string &payload)

Sends Message with default settings using payload as message data.

Depending on Command value SendPayload will send either text or binary command.

Note that application local messages are sent without retry and acknowledge option.

Returns 1 on success or 0 when there are no targets or some targets have no routing set.

void MessageArgument::SetForward(bool forward)

Sets auto forwarding of messages to all routings.

MessageArgument will by default forward all received messages to all connected objects indicated in the RoutingList property

void MessageArgument::SetHandler(std::function<int( const MessageArgument & arg, void * message ) > handler)

void MessageArgument::SetHandler(std::function<int( const MessageArgument & arg, const MessagePacketHandle & handle ) > handler)

void MessageArgument::SetRoutingList(const std::string &routingList)

Sets new RoutingList value

Also causes a new connection to be initiated to the provided routings.

void MessageArgument::SetSendValidator(std::function<MessagePacketHandle( const MessageArgument & arg, std::unique_ptr<CDPConnector> & connector, const MessagePacketHandle & handle ) > validator)

std::string MessageArgument::TextCommand() const

Gets the configured TextCommand value

Returns TextCommand value

bool MessageArgument::operator==(const MessageArgument &rhs) const