Struct Data 

pub struct Data { /* private fields */ }

Named values bound as variables when a program is compiled: the observed data, and any scalar settings a host wants to pass in.

use fugue::program::{Data, Value};

let from_rust = Data::new()
    .with("y", vec![1.3, 0.7, 2.1])
    .with("n", 3)
    .with("strict", true);
let from_json = Data::from_json(r#"{"y": [1.3, 0.7, 2.1], "n": 3, "strict": true}"#).unwrap();
assert_eq!(from_rust, from_json);
assert_eq!(from_json.get("n"), Some(&Value::Int(3)));

// A bare array binds `data`, as the playground has always read it.
let bare = Data::from_json("[1, 0, 1]").unwrap();
assert_eq!(bare.get("data").and_then(Value::as_array), Some(&[1.0, 0.0, 1.0][..]));

Implementations

impl Data

pub fn new() -> Data

No bindings.

pub fn from_json(json: &str) -> Result<Data, ProgramError>

Read bindings from JSON: an object whose values are numbers, booleans, or arrays of numbers/booleans; a bare array (bound to data); or an empty string / null for none.

Arrays become Value::Arr (booleans read as 1.0/0.0). A scalar integer becomes Value::Int (or Value::U64 above i64::MAX), any other number Value::F64, a boolean Value::Bool.

pub fn with(self, name: impl Into<String>, value: impl Into<Value>) -> Data

These bindings plus name bound to value (builder style).

pub fn insert( &mut self, name: impl Into<String>, value: impl Into<Value>, ) -> Option<Value>

Bind name to value, returning the value it replaces.

pub fn get(&self, name: &str) -> Option<&Value>

The value bound to name.

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

The bindings, in name order.

pub fn len(&self) -> usize

The number of bindings.

pub fn is_empty(&self) -> bool

Whether there are no bindings.

Trait Implementations

impl Clone for Data

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Data

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

Formats the value using the given formatter.

impl Default for Data

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Data

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Data