Struct PnLRange 

pub struct PnLRange {
    pub lower: i32,
    pub upper: i32,
}

Represents a range of Profit and Loss (PnL) values for bucketing or categorizing financial results.

This structure defines a discrete interval of PnL values that can be used for:

• Creating histograms of trading results
• Defining profit/loss categories for analysis
• Setting up thresholds for performance metrics
• Grouping trading outcomes for statistical analysis

The range is defined as [lower, upper) where lower is inclusive and upper is exclusive. PnL values are represented as integer values (i32) rather than decimals for efficient bucketing and categorization.

Fields

lower: i32

Lower bound of this PnL bucket (inclusive)

upper: i32

Upper bound of this PnL bucket (exclusive)

Implementations

impl PnLRange

pub fn new(lower: i32, upper: i32) -> Self

Creates a new PnL range with the specified lower and upper bounds.

This constructor creates a range where the lower bound is inclusive and the upper bound is exclusive, following the conventional [lower, upper) interval notation.

Parameters

• lower - The inclusive lower bound of the range
• upper - The exclusive upper bound of the range

Returns

A new PnLRange instance with the specified bounds.

Example

use optionstratlib::pnl::model::PnLRange;
let range = PnLRange::new(-100, 100);
// Creates a PnL range from -100 (inclusive) to 100 (exclusive)

pub fn new_decimal(lower: Decimal, upper: Decimal) -> Result<Self, DecimalError>

Creates a new PnL range from Decimal values by converting them to i32.

This constructor provides a convenient way to create a PnLRange from decimal values, automatically converting them to integers for efficient bucketing and categorization.

Parameters

• lower - The inclusive lower bound as a Decimal value
• upper - The exclusive upper bound as a Decimal value

Returns

A new PnLRange instance with the bounds converted to integers.

Errors

Returns a DecimalError::ConversionError if either bound is outside the i32 range or cannot be represented as an integer.

Example

use rust_decimal_macros::dec;
use optionstratlib::pnl::model::PnLRange;

let range = PnLRange::new_decimal(dec!(-50.5), dec!(75.25))?;
// Creates a PnL range from -50 (inclusive) to 75 (exclusive)

Trait Implementations

impl Clone for PnLRange

fn clone(&self) -> PnLRange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PnLRange

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PnLRange

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PnLRange

impl Hash for PnLRange

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 PartialEq for PnLRange

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PnLRange

Implements serialization for PnLRange using a custom string format.

This implementation serializes a PnLRange instance as a string in the format “[lower, upper)” where:

• lower is the inclusive lower bound of the range
• upper is the exclusive upper bound of the range

This format provides a clear, human-readable representation of the profit and loss range that preserves the mathematical half-open interval notation, making it ideal for display in reports, logs, or API responses.

Example

A PnLRange with lower = 100 and upper = 200 will be serialized as “[100, 200)”.

Implementation Details

This custom serialization is needed because the default derived implementation would serialize the struct as a JSON object with separate fields, while this implementation provides a more compact string representation.

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PnLRange