pub struct FluentArgs<'args>(Vec<(Cow<'args, str>, FluentValue<'args>)>);
Expand description

A map of arguments passed from the code to the localization to be used for message formatting.

Example

use fluent_bundle::{FluentArgs, FluentBundle, FluentResource};

let mut args = FluentArgs::new();
args.set("user", "John");
args.set("emailCount", 5);

let res = FluentResource::try_new(r#"

msg-key = Hello, { $user }. You have { $emailCount } messages.

"#.to_string())
    .expect("Failed to parse FTL.");

let mut bundle = FluentBundle::default();

// For this example, we'll turn on BiDi support.
// Please, be careful when doing it, it's a risky move.
bundle.set_use_isolating(false);

bundle.add_resource(res)
    .expect("Failed to add a resource.");

let mut err = vec![];

let msg = bundle.get_message("msg-key")
    .expect("Failed to retrieve a message.");
let value = msg.value()
    .expect("Failed to retrieve a value.");

assert_eq!(
    bundle.format_pattern(value, Some(&args), &mut err),
    "Hello, John. You have 5 messages."
);

Tuple Fields§

§0: Vec<(Cow<'args, str>, FluentValue<'args>)>

Implementations§

§

impl<'args> FluentArgs<'args>

pub fn new() -> FluentArgs<'args>

pub fn with_capacity(capacity: usize) -> FluentArgs<'args>

pub fn get<K>(&self, key: K) -> Option<&FluentValue<'args>>
where K: Into<Cow<'args, str>>,

pub fn set<K, V>(&mut self, key: K, value: V)
where K: Into<Cow<'args, str>>, V: Into<FluentValue<'args>>,

pub fn iter(&self) -> impl Iterator<Item = (&str, &FluentValue<'_>)>

Trait Implementations§

§

impl<'args> Debug for FluentArgs<'args>

§

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

Formats the value using the given formatter. Read more
§

impl<'args> Default for FluentArgs<'args>

§

fn default() -> FluentArgs<'args>

Returns the “default value” for a type. Read more
§

impl<'args, K, V> FromIterator<(K, V)> for FluentArgs<'args>
where K: Into<Cow<'args, str>>, V: Into<FluentValue<'args>>,

§

fn from_iter<I>(iter: I) -> FluentArgs<'args>
where I: IntoIterator<Item = (K, V)>,

Creates a value from an iterator. Read more
§

impl<'args> IntoIterator for FluentArgs<'args>

§

type Item = (Cow<'args, str>, FluentValue<'args>)

The type of the elements being iterated over.
§

type IntoIter = IntoIter<<FluentArgs<'args> as IntoIterator>::Item>

Which kind of iterator are we turning this into?
§

fn into_iter(self) -> <FluentArgs<'args> as IntoIterator>::IntoIter

Creates an iterator from a value. Read more

Auto Trait Implementations§

§

impl<'args> !RefUnwindSafe for FluentArgs<'args>

§

impl<'args> Send for FluentArgs<'args>

§

impl<'args> !Sync for FluentArgs<'args>

§

impl<'args> Unpin for FluentArgs<'args>

§

impl<'args> !UnwindSafe for FluentArgs<'args>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more