Struct OptionsCollection 

pub struct OptionsCollection {
    pub options: Vec<OptionInfo>,
}

An owned snapshot of every option in a cpdb_options_t.

Built from D-Bus GetAllOptions responses (zbus backend) or from C cpdb_options_t pointers (FFI backend). After construction, no raw pointers are held - the collection is freely movable and cloneable.

Example

use cpdb_rs::options::{OptionsCollection, OptionInfo};

let col = OptionsCollection {
    options: vec![OptionInfo {
        name: "copies".to_string(),
        default_value: "1".to_string(),
        group: "General".to_string(),
        supported_values: vec!["1".to_string(), "2".to_string()],
    }],
};
assert_eq!(col.get("copies").unwrap().default_value, "1");

Fields

options: Vec<OptionInfo>

Every option discovered, in iteration order of the underlying hash table (which itself is implementation-defined).

Implementations

impl OptionsCollection

pub fn from_dbus(raw: Vec<RawOption>) -> Self

Available on crate feature zbus-backend only.

Builds an OptionsCollection from the D-Bus response tuples returned by crate::proxy::PrintBackendProxy::get_all_options().

pub fn len(&self) -> usize

Returns the number of options in this collection.

pub fn is_empty(&self) -> bool

Returns true if this collection has no options.

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

Finds an option by name (linear search).

pub fn iter(&self) -> impl Iterator<Item = &OptionInfo>

Returns an iterator over all options.

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

Returns deduplicated group names of all options in their iteration order, skipping empty group names.

Trait Implementations

impl Clone for OptionsCollection

fn clone(&self) -> OptionsCollection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OptionsCollection

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

Formats the value using the given formatter.

impl Default for OptionsCollection

fn default() -> OptionsCollection

Returns the “default value” for a type.