Struct ApproxCost 

pub struct ApproxCost {
    pub usd: f64,
    pub may_overstate: bool,
    pub may_understate: bool,
}

A cost figure plus which way it can be wrong.

Presenting an estimate as an exact price is the same failure as billing an unrated bucket at zero, one step later — so the direction travels with the number instead of being re-derived (or forgotten) at each display site.

Fields

usd: f64

USD.

may_overstate: bool

The true cost may be lower — a bucket was priced at a substitute rate that can only be too high (a cache read at the uncached-input rate), or a pricing tier is cheaper than the base sheet used.

may_understate: bool

The true cost may be higher — a pricing tier dearer than the base sheet could not be resolved from the tokens the caller had, or a cache write was priced at the uncached-input rate and the provider charges a surcharge for it (Anthropic 1.25x, OpenRouter’s 1h TTL 2x).

Implementations

impl ApproxCost

pub fn is_exact(&self) -> bool

Every rate applied exactly; the figure is the price.

pub fn marker(&self) -> &'static str

Prefix for the figure: ≤ a ceiling, ≥ a floor, ~ neither bound holds, empty when exact. Rendering the number without this is the defect the type exists to prevent.

Trait Implementations

impl Clone for ApproxCost

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ApproxCost

impl Debug for ApproxCost

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

Formats the value using the given formatter.

impl PartialEq for ApproxCost

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ApproxCost