Struct Dictionary 

pub struct Dictionary { /* private fields */ }

Specifies business semantics for application-level entities within the FIX Protocol.

You can rely on Dictionary for accessing details about fields, messages, and other abstract entities as defined in the FIX specifications. Examples of such information include:

• The mapping of FIX field names to numeric tags (e.g. BeginString is 8).
• Which FIX fields are mandatory and which are optional.
• The data type of each and every FIX field.
• What fields to expect in FIX headers.

N.B. The FIX Protocol mandates separation of concerns between session and application protocol only for FIX 5.0 and subsequent versions. All FIX Dictionaries for older versions will also contain information about the session layer.

Implementations

impl Dictionary

pub fn new<S: ToString>(version: S) -> Self

Creates a new empty FIX Dictionary named version.

pub fn from_quickfix_spec(input: &str) -> Result<Self, ParseDictionaryError>

Attempts to read a QuickFIX-style specification file and convert it into a Dictionary.

pub fn version(&self) -> &str

Returns the version string associated with this Dictionary (e.g. FIXT.1.1, FIX.4.2).

use hotfix_dictionary::Dictionary;

let dict = Dictionary::fix44();
assert_eq!(dict.version(), "FIX.4.4");

pub fn load_from_file(path: &str) -> Result<Self, ParseDictionaryError>

pub fn fix44() -> Self

Creates a new Dictionary for FIX 4.4.

pub fn common_dictionaries() -> Vec<Dictionary>

Returns a Vec of FIX Dictionary’s for the most common FIX versions (that have been enabled via feature flags). This is only intended for testing purposes.

pub fn message_by_name(&self, name: &str) -> Option<MessageDefinition<'_>>

Returns the [Message] associated with name, if any.

use hotfix_dictionary::Dictionary;

let dict = Dictionary::fix44();

let msg1 = dict.message_by_name("Heartbeat").unwrap();
let msg2 = dict.message_by_msgtype("0").unwrap();
assert_eq!(msg1.name(), msg2.name());

pub fn message_by_msgtype(&self, msgtype: &str) -> Option<MessageDefinition<'_>>

Returns the [Message] that has the given msgtype, if any.

use hotfix_dictionary::Dictionary;

let dict = Dictionary::fix44();

let msg1 = dict.message_by_msgtype("0").unwrap();
let msg2 = dict.message_by_name("Heartbeat").unwrap();
assert_eq!(msg1.name(), msg2.name());

pub fn component_by_name(&self, name: &str) -> Option<Component<'_>>

Returns the [Component] named name, if any.

pub fn datatype_by_name(&self, name: &str) -> Option<Datatype<'_>>

Returns the Datatype named name, if any.

use hotfix_dictionary::Dictionary;

let dict = Dictionary::fix44();
let dt = dict.datatype_by_name("String").unwrap();
assert_eq!(dt.name(), "String");

pub fn field_by_tag(&self, tag: u32) -> Option<Field<'_>>

Returns the Field associated with tag, if any.

use hotfix_dictionary::Dictionary;

let dict = Dictionary::fix44();
let field1 = dict.field_by_tag(112).unwrap();
let field2 = dict.field_by_name("TestReqID").unwrap();
assert_eq!(field1.name(), field2.name());

pub fn field_by_name(&self, name: &str) -> Option<Field<'_>>

Returns the Field named name, if any.

pub fn datatypes(&self) -> Vec<Datatype<'_>>

Returns a Vec of all Datatype’s in this Dictionary. The ordering of items is not specified.

use hotfix_dictionary::Dictionary;

let dict = Dictionary::fix44();
// FIX 4.4 defines 23 (FIXME) datatypes.
assert_eq!(dict.datatypes().len(), 23);

pub fn messages(&self) -> Vec<MessageDefinition<'_>>

Returns a Vec of all [Message]’s in this Dictionary. The ordering of items is not specified.

use hotfix_dictionary::Dictionary;

let dict = Dictionary::fix44();
let msgs = dict.messages();
let msg = msgs.iter().find(|m| m.name() == "MarketDataRequest");
assert_eq!(msg.unwrap().msg_type(), "V");

pub fn fields(&self) -> Vec<Field<'_>>

Returns a Vec of all Field’s in this Dictionary. The ordering of items is not specified.

pub fn components(&self) -> Vec<Component<'_>>

Returns a Vec of all [Component]’s in this Dictionary. The ordering of items is not specified.

Trait Implementations

impl Clone for Dictionary

fn clone(&self) -> Dictionary

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Dictionary

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

Formats the value using the given formatter.