Enum libipld_macro::Ipld

pub enum Ipld {
    Null,
    Bool(bool),
    Integer(i128),
    Float(f64),
    String(String),
    Bytes(Vec<u8, Global>),
    List(Vec<Ipld, Global>),
    Map(BTreeMap<String, Ipld, Global>),
    Link(Cid<64>),
}

Construct an Ipld from a literal.

let value = ipld!({
    "code": 200,
    "success": true,
    "payload": {
        "features": [
            "serde",
            "json"
        ]
    }
});

Variables or expressions can be interpolated into the JSON literal. Any type interpolated into an array element or object value must implement Serde’s Serialize trait, while any type interpolated into a object key must implement Into<String>. If the Serialize implementation of the interpolated type decides to fail, or if the interpolated type contains a map with non-string keys, the json! macro will panic.

let code = 200;
let features = vec!["serde", "json"];

let value = ipld!({
    "code": code,
    "success": code == 200,
    "payload": {
        features[0]: features[1]
    }
});

Trailing commas are allowed inside both arrays and objects.

let value = ipld!([
    "notice",
    "the",
    "trailing",
    "comma -->",
]);

Ipld

Variants

Null

Represents the absence of a value or the value undefined.

Bool(bool)

Represents a boolean value.

Integer(i128)

Represents an integer.

Float(f64)

Represents a floating point value.

String(String)

Represents an UTF-8 string.

Bytes(Vec<u8, Global>)

Represents a sequence of bytes.

List(Vec<Ipld, Global>)

Represents a list.

Map(BTreeMap<String, Ipld, Global>)

Represents a map of strings.

Link(Cid<64>)

Represents a map of integers.

Implementations

impl Ipld

Construct an Ipld from a literal.

let value = ipld!({
    "code": 200,
    "success": true,
    "payload": {
        "features": [
            "serde",
            "json"
        ]
    }
});

Variables or expressions can be interpolated into the JSON literal. Any type interpolated into an array element or object value must implement Serde’s Serialize trait, while any type interpolated into a object key must implement Into<String>. If the Serialize implementation of the interpolated type decides to fail, or if the interpolated type contains a map with non-string keys, the json! macro will panic.

let code = 200;
let features = vec!["serde", "json"];

let value = ipld!({
    "code": code,
    "success": code == 200,
    "payload": {
        features[0]: features[1]
    }
});

Trailing commas are allowed inside both arrays and objects.

let value = ipld!([
    "notice",
    "the",
    "trailing",
    "comma -->",
]);

pub fn take<'a, T>(self, index: T) -> Result<Ipld, TypeError> where
    T: Into<IpldIndex<'a>>, 

Destructs an ipld list or map

pub fn get<'a, T>(&self, index: T) -> Result<&Ipld, TypeError> where
    T: Into<IpldIndex<'a>>, 

Indexes into an ipld list or map.

pub fn iter(&self) -> IpldIter<'_>

Returns an iterator.

pub fn references<E>(&self, set: &mut E) where
    E: Extend<Cid<64>>, 

Returns the references to other blocks.

Trait Implementations

impl Clone for Ipld

fn clone(&self) -> Ipld

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Ipld

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

Formats the value using the given formatter.

impl Decode<RawCodec> for Ipld

fn decode<R>(c: RawCodec, r: &mut R) -> Result<Ipld, Error> where
    R: Read + Seek, 

Decode from an impl Read.

impl Encode<RawCodec> for Ipld

fn encode<W>(&self, c: RawCodec, w: &mut W) -> Result<(), Error> where
    W: Write, 

Encodes into a impl Write.

impl From<&[u8]> for Ipld

fn from(t: &[u8]) -> Ipld

Converts to this type from the input type.

impl From<&Cid<64>> for Ipld

fn from(t: &Cid<64>) -> Ipld

Converts to this type from the input type.

impl From<&str> for Ipld

fn from(t: &str) -> Ipld

Converts to this type from the input type.

impl From<BTreeMap<String, Ipld, Global>> for Ipld

fn from(t: BTreeMap<String, Ipld, Global>) -> Ipld

Converts to this type from the input type.

impl From<Box<[u8], Global>> for Ipld

fn from(t: Box<[u8], Global>) -> Ipld

Converts to this type from the input type.

impl From<Cid<64>> for Ipld

fn from(t: Cid<64>) -> Ipld

Converts to this type from the input type.

impl From<String> for Ipld

fn from(t: String) -> Ipld

Converts to this type from the input type.

impl From<Vec<Ipld, Global>> for Ipld

fn from(t: Vec<Ipld, Global>) -> Ipld

Converts to this type from the input type.

impl From<Vec<u8, Global>> for Ipld

fn from(t: Vec<u8, Global>) -> Ipld

Converts to this type from the input type.

impl From<bool> for Ipld

fn from(t: bool) -> Ipld

Converts to this type from the input type.

impl From<f32> for Ipld

fn from(t: f32) -> Ipld

Converts to this type from the input type.

impl From<f64> for Ipld

fn from(t: f64) -> Ipld

Converts to this type from the input type.

impl From<i128> for Ipld

fn from(t: i128) -> Ipld

Converts to this type from the input type.

impl From<i16> for Ipld

fn from(t: i16) -> Ipld

Converts to this type from the input type.

impl From<i32> for Ipld

fn from(t: i32) -> Ipld

Converts to this type from the input type.

impl From<i64> for Ipld

fn from(t: i64) -> Ipld

Converts to this type from the input type.

impl From<i8> for Ipld

fn from(t: i8) -> Ipld

Converts to this type from the input type.

impl From<isize> for Ipld

fn from(t: isize) -> Ipld

Converts to this type from the input type.

impl From<u16> for Ipld

fn from(t: u16) -> Ipld

Converts to this type from the input type.

impl From<u32> for Ipld

fn from(t: u32) -> Ipld

Converts to this type from the input type.

impl From<u64> for Ipld

fn from(t: u64) -> Ipld

Converts to this type from the input type.

impl From<u8> for Ipld

fn from(t: u8) -> Ipld

Converts to this type from the input type.

impl From<usize> for Ipld

fn from(t: usize) -> Ipld

Converts to this type from the input type.

impl PartialEq<Ipld> for Ipld

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Ipld