Struct Table 

pub struct Table<'a> { /* private fields */ }

A borrowed view of one period’s table — resolve once, convert many times.

Implementations

impl<'a> Table<'a>

pub fn period(&self) -> Period

The period this table was published for.

pub fn rate_type(&self) -> RateType

The series this table belongs to.

pub fn rate(&self, code: &str) -> Result<Rate, LookupError>

The rate for code in this period. "GBP" always resolves to the identity rate.

Errors distinguish a code the series has never published (LookupError::UnknownCurrency) from one merely absent this period (LookupError::NotInPeriod).

Examples

use hmrc_rates::{YearMonth, Rates};
use rust_decimal::Decimal;

let rates = Rates::new();
let table = rates.monthly(YearMonth::new(2025, 8).unwrap())?;
let eur = table.rate("EUR")?;
let total: Decimal = [1200, 450, 80]
    .into_iter()
    .map(|amount| eur.to_gbp(Decimal::from(amount)))
    .sum();

pub fn get(&self, code: &str) -> Option<Rate>

Like Table::rate but None on any miss, for when absence isn’t exceptional.

pub fn iter(&self) -> impl ExactSizeIterator<Item = (Currency, Rate)> + use<'a>

All (currency, rate) pairs in this table, ascending by code.

pub fn len(&self) -> usize

The number of currencies in this table.

pub fn is_empty(&self) -> bool

true if the table has no entries.

Trait Implementations

impl<'a> Clone for Table<'a>

fn clone(&self) -> Table<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Table<'a>

impl Debug for Table<'_>

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

Formats the value using the given formatter.