Struct Ini 

pub struct Ini { /* private fields */ }

a settings object (one thread at a time)

Implementations

impl Ini

pub fn new() -> Ini

pub fn load(path: &str) -> Ini

the parsed file; empty when it is missing or unreadable [ini_load]

pub fn load_checked(path: &str) -> Option<Ini>

like load, but None when the file exists and could not be read completely (unreadable or longer than FILE_MAX); a missing or empty file gives an empty Ini

pub fn parse(data: &[u8]) -> Ini

parse settings text [ini_parse]

pub fn to_bytes(&self) -> Vec<u8>

the text save writes

pub fn save(&self, path: &str) -> bool

Write through plat::write_file; missing directories are created. [ini_save]

pub fn section(&self, sec: &str) -> Vec<(&str, &str)>

every key of a section with its value, in file order (entries that are not UTF-8 are left out; sec “” = the keys before the first header)

pub fn sections(&self) -> Vec<&str>

the names of the sections in file order, each once (names that are not UTF-8 are left out; the keys before the first header are not a section here)

pub fn items(&self) -> Vec<Item<'_>>

every header, key and malformed line in file order with its line number; blank lines and comments are left out

pub fn get(&self, sec: &str, key: &str) -> Option<&str>

the value, or None when missing or not UTF-8 [ini_get]

pub fn get_bytes(&self, sec: &str, key: &str) -> Option<&[u8]>

pub fn get_int(&self, sec: &str, key: &str, def: i64) -> i64

[ini_get_int]

pub fn get_f64(&self, sec: &str, key: &str, def: f64) -> f64

the whole value must be the number [ini_get_f64]

pub fn set(&mut self, sec: &str, key: &str, value: &str) -> bool

add or replace (false: a bad name) [ini_set]

pub fn set_int(&mut self, sec: &str, key: &str, value: i64) -> bool

[ini_set_int]

pub fn set_f64(&mut self, sec: &str, key: &str, value: f64) -> bool

the shortest text that reads back to the same double [ini_set_f64]

pub fn remove(&mut self, sec: &str, key: &str) -> bool

false: not there [ini_remove]

Trait Implementations

impl Default for Ini

fn default() -> Self

Returns the “default value” for a type.