Struct jupiter::ig::builder::ListBuilder

pub struct ListBuilder { /* private fields */ }

Builds an inner list within a Doc or another element.

A builder can be obtained via DocBuilder::root_list_builder.

Implementations

impl ListBuilder

pub fn append_int(&mut self, value: i64)

Appends an integer value to the list being built.

Example

let builder = DocBuilder::new();
let mut list_builder = builder.list();

list_builder.append_int(42);

let doc = builder.build_list(list_builder);
assert_eq!(doc.root().at(0).as_int().unwrap(), 42);

pub fn append_string(&mut self, value: impl AsRef<str>)

Appends a string to the list being built.

Example

let builder = DocBuilder::new();
let mut list_builder = builder.list();

list_builder.append_string("Test");

let doc = builder.build_list(list_builder);
assert_eq!(doc.root().at(0).as_str().unwrap(), "Test");

pub fn append_bool(&mut self, value: bool)

Appends a bool value to the list being built.

Example

let builder = DocBuilder::new();
let mut list_builder = builder.list();

list_builder.append_bool(true);

let doc = builder.build_list(list_builder);
assert_eq!(doc.root().at(0).as_bool(), true);    

pub fn append_list(&mut self, list: ListBuilder)

Appends a child-list to the list being built. Returns the builder used to populate the list.

Note that this will not join two lists but rather construct a list as child element and append further items to this child list.

Example

let builder = DocBuilder::new();
let mut list_builder = builder.list();

let mut child_list_builder = builder.list();
child_list_builder.append_int(42);
list_builder.append_list(child_list_builder);

let doc = builder.build_list(list_builder);
assert_eq!(doc.root().len(), 1);    
assert_eq!(doc.root().at(0).len(), 1);    
assert_eq!(doc.root().at(0).at(0).as_int().unwrap(), 42);

pub fn append_object(&mut self, obj: ObjectBuilder<'_>)

Appends a child object to the list being built. Returns the builder used to populate the object.

Example

let builder = DocBuilder::new();
let mut list_builder = builder.list();

let mut obj_builder = builder.obj();
obj_builder.put_string("Foo", "Bar").unwrap();
list_builder.append_object(obj_builder);

let doc = builder.build_list(list_builder);
assert_eq!(doc.root().len(), 1);    
assert_eq!(doc.root().at(0).query("Foo").as_str().unwrap(), "Bar");