Struct Message

pub struct Message(/* private fields */);

Base class for all FIX messages.

Implementations

impl Message

pub fn new() -> Self

Create new empty struct.

Examples found in repository

examples/fix_repl/command_parser.rs (line 81)

fn parse_send_to(source: &str) -> Result<(Message, SessionId), BadCommand> {
    // Split command into token
    let mut tokens = source.split_whitespace();
    debug_assert_eq!(tokens.next().as_deref(), Some("send_to"));

    let text_msg = tokens.next().ok_or(BadCommand::InvalidArgumentCount {
        current: 0,
        expected: 3,
    })?;
    let text_sender = tokens.next().ok_or(BadCommand::InvalidArgumentCount {
        current: 1,
        expected: 3,
    })?;
    let text_target = tokens.next().ok_or(BadCommand::InvalidArgumentCount {
        current: 2,
        expected: 3,
    })?;

    // Build message from 1st data token
    let mut msg = Message::new();
    for field in text_msg.split('|') {
        let mut field_tokens = field.splitn(2, '=');

        let tag = field_tokens
            .next()
            .ok_or(BadCommand::InvalidArgument("Invalid tag"))?
            .parse()
            .ok()
            .ok_or(BadCommand::InvalidArgument("Invalid tag number"))?;

        let value = field_tokens
            .next()
            .ok_or(BadCommand::InvalidArgument("Invalid value"))?;

        msg.set_field(tag, value)
            .ok()
            .expect("Fail to set msg tag=value");
    }

    // Build session ID from 2nd data token
    let session_id = SessionId::try_new("FIX.4.4", text_sender, text_target, "")
        .expect("Fail to allocate new session ID");

    Ok((msg, session_id))
}

pub fn try_from_text(text: &str) -> Result<Self, QuickFixError>

Try create new struct from raw text message.

pub fn to_fix_string(&self) -> Result<String, QuickFixError>

Try reading underlying struct buffer as a FIX string.

Performances

Do not use this method in latency sensitive code.

String will be generated twice in C++ code:

• Once for getting a safe buffer length.
• Then to copy buffer to rust “memory”.

pub fn clone_header(&self) -> Header

Clone struct header part.

Panic

When memory allocation fail in C++ library.

pub fn with_header<T, F>(&self, f: F) -> T

where F: FnOnce(&Header) -> T,

Read struct header part.

Panic

When struct pointer cannot be read from FIX::Message. This is something that could not be theoretically possible.

pub fn with_header_mut<T, F>(&mut self, f: F) -> T

where F: FnOnce(&mut Header) -> T,

Read or write struct header part.

Panic

When struct pointer cannot be read from FIX::Message. This is something that could not be theoretically possible.

pub fn clone_trailer(&self) -> Trailer

Clone struct trailer part.

Panic

When memory allocation fail in C++ library.

pub fn with_trailer<T, F>(&self, f: F) -> T

where F: FnOnce(&Trailer) -> T,

Read struct trailer part.

Panic

When struct pointer cannot be read from FIX::Message. This is something that could not be theoretically possible.

pub fn with_trailer_mut<T, F>(&mut self, f: F) -> T

where F: FnOnce(&mut Trailer) -> T,

Read or write struct trailer part.

Panic

When struct pointer cannot be read from FIX::Message. This is something that could not be theoretically possible.

pub fn with_group<T, F>(&self, index: i32, tag: i32, f: F) -> Option<T>

where F: FnOnce(&Group) -> T,

Read struct group part for a given tag and group index.

pub fn with_group_mut<T, F>(&mut self, index: i32, tag: i32, f: F) -> Option<T>

where F: FnOnce(&mut Group) -> T,

Read or write struct group part for a given tag and group index.

Trait Implementations

impl Clone for Message

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Message

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Message

fn default() -> Self

Returns the “default value” for a type.

impl Drop for Message

fn drop(&mut self)

Executes the destructor for this type.

impl FieldMap for Message

fn get_field(&self, tag: i32) -> Option<String>

Get field value from its tag number.

fn set_field<V: IntoFixValue>( &mut self, tag: i32, value: V, ) -> Result<(), QuickFixError>

Set field value for a given tag number.

fn remove_field(&mut self, tag: i32) -> Result<(), QuickFixError>

Remove a field from collection.

fn add_group(&mut self, group: &Group) -> Result<(), QuickFixError>

Add a new group to storage and update count.

fn clone_group(&self, index: i32, tag: i32) -> Option<Group>

Clone group part for a given tag and group index.