Struct easyfix_messages::fields::FixString

pub struct FixString(_);

Implementations

impl FixString

pub const fn new() -> FixString

pub fn with_capacity(capacity: usize) -> FixString

pub fn from_ascii(buf: Vec<u8>) -> Result<FixString, FixStringError>

Converts a vector of bytes to a FixString.

A FIX string (FixString) is made of bytes (u8), and a vector of bytes (Vec<u8>) is made of bytes, so this function converts between the two. Not all byte slices are valid FixStrings, however: FixString requires that it is valid ASCII. from_ascii() checks to ensure that the bytes are valid ASCII, and then does the conversion.

If you are sure that the byte slice is valid ASCII, and you don’t want to incur the overhead of the validity check, there is an unsafe version of this function, from_ascii_unchecked, which has the same behavior but skips the check.

This method will take care to not copy the vector, for efficiency’s sake.

If you need a &FixStr instead of a FixString, consider FixStr::from_ascii.

The inverse of this method is into_bytes.

Errors

Returns Err if the slice is not ASCII with a description as to why the provided bytes are not ASCII.

pub unsafe fn from_ascii_unchecked(buf: Vec<u8>) -> FixString

Converts a vector of bytes to a FixString without checking that the it contains only ASCII characters.

See the safe version, from_ascii, for more details.

Safety

This function is unsafe because it does not check that the bytes passed to it are valid ASCII. If this constraint is violated, it may cause memory unsafety issues with future users of the FixString, as the rest of the library assumes that FixStrings are valid ASCII.

pub fn from_ascii_lossy(buf: Vec<u8>) -> FixString

pub fn as_utf8(&self) -> &str

pub fn into_utf8(self) -> String

pub fn into_bytes(self) -> Vec<u8>

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

Methods from Deref<Target = FixStr>

pub fn as_utf8(&self) -> &str

pub fn as_bytes(&self) -> &[u8]

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

Trait Implementations

impl AsRef<[u8]> for FixString

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<FixStr> for FixString

fn as_ref(&self) -> &FixStr

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<str> for FixString

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<FixStr> for FixString

fn borrow(&self) -> &FixStr

Immutably borrows from an owned value.

impl Clone for FixString

fn clone(&self) -> FixString

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for FixString

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

Formats the value using the given formatter.

impl Default for FixString

fn default() -> FixString

Returns the “default value” for a type.

impl Deref for FixString

type Target = FixStr

The resulting type after dereferencing.

fn deref(&self) -> &FixStr

Dereferences the value.

impl<'de> Deserialize<'de> for FixString

fn deserialize<D>(deserializer: D) -> Result<FixString, D::Error>where
    D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for FixString

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

Formats the value using the given formatter.

impl<const N: usize> From<&[u8; N]> for FixString

fn from(input: &[u8; N]) -> FixString

Converts to this type from the input type.

impl From<&FixStr> for FixString

fn from(input: &FixStr) -> FixString

Converts to this type from the input type.

impl From<FixString> for String

fn from(input: FixString) -> String

Converts to this type from the input type.

impl Hash for FixString

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,
    Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for FixString

fn cmp(&self, other: &FixString) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere
    Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere
    Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere
    Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl<const N: usize> PartialEq<&[u8; N]> for FixString

fn eq(&self, other: &&[u8; N]) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<&[u8]> for FixString

fn eq(&self, other: &&[u8]) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<&FixStr> for FixString

fn eq(&self, other: &&FixStr) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<&str> for FixString

fn eq(&self, other: &&str) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<const N: usize> PartialEq<[u8; N]> for FixString

fn eq(&self, other: &[u8; N]) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<[u8]> for FixString

fn eq(&self, other: &[u8]) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<FixStr> for FixString

fn eq(&self, other: &FixStr) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<FixString> for FixString

fn eq(&self, other: &FixString) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<String> for FixString

fn eq(&self, other: &String) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Vec<u8, Global>> for FixString

fn eq(&self, other: &Vec<u8>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<str> for FixString

fn eq(&self, other: &str) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd<FixString> for FixString

fn partial_cmp(&self, other: &FixString) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for FixString

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>where
    S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&[u8]> for FixString

type Error = FixStringError

The type returned in the event of a conversion error.

fn try_from(input: &[u8]) -> Result<FixString, Self::Error>

Performs the conversion.

impl TryFrom<&str> for FixString

type Error = FixStringError

The type returned in the event of a conversion error.

fn try_from(buf: &str) -> Result<FixString, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<[u8; N]> for FixString

type Error = FixStringError

The type returned in the event of a conversion error.

fn try_from(buf: [u8; N]) -> Result<FixString, Self::Error>

Performs the conversion.

impl TryFrom<String> for FixString

type Error = FixStringError

The type returned in the event of a conversion error.

fn try_from(buf: String) -> Result<FixString, Self::Error>

Performs the conversion.

impl TryFrom<Vec<u8, Global>> for FixString

type Error = FixStringError

The type returned in the event of a conversion error.

fn try_from(buf: Vec<u8>) -> Result<FixString, Self::Error>

Performs the conversion.

impl Eq for FixString

impl StructuralEq for FixString

impl StructuralPartialEq for FixString