Struct Parser

pub struct Parser { /* private fields */ }

Implementations

impl Parser

pub fn new() -> Self

Create new parser instance with default options

pub fn with_flags(flags: Flags) -> Self

Create new parser with given option flags

Flags:

• DEFAULT - default configuration
• LOWERCASE - convert all keys to lower case
• ZEROCOPY - parse input in zero-copy mode if possible (you must ensure that input memory is not freed if an object is in use)
• NO_TIME - do not parse time and treat it’s value as string
• NO_IMPLICIT_ARRAYS - create explicit arrays instead of implicit ones

Examples

let parser = libucl::Parser::with_flags(libucl::parser::Flags::LOWERCASE);
let doc = parser.parse("A = b").unwrap();

assert!(doc.fetch("a").is_some());

pub fn parse<T: AsRef<str>>(self, string: T) -> Result<Object>

Parse given string. Returns root object on success.

It moves out Parser.

Examples

assert!(libucl::Parser::new().parse("a = b").is_ok());
assert!(libucl::Parser::new().parse("a =").is_err());

pub fn parse_file<T: AsRef<Path>>(self, path: T) -> Result<Object>

Parse file at given Path.

pub fn register_var(&self, name: String, value: String)

Register new variable

Examples

let p = libucl::Parser::new();
p.register_var("someVar".to_string(), "test_string".to_string());
let res = p.parse("testVar = $someVar").unwrap();

assert_eq!(res.fetch("testVar").unwrap().as_string(), Some("test_string".to_string()));

Trait Implementations

impl Drop for Parser

fn drop(&mut self)

Executes the destructor for this type.