Struct Section 

pub struct Section(/* private fields */);

A section of a FreeDesktop entry file.

Implementations

impl Section

pub fn attr(&self, key: impl AsRef<str>) -> &[String]

Get the values of the attribute key.

If the attribute is defined multiple times, all of them will be in the list, if the attribute is missing the list will be empty.

Examples found in repository

examples/systemd_start_cmd.rs (line 9)

fn main() -> Result<()> {
    let entry = parse_entry("./test_data/sshd.service")?;
    let start_cmd = &entry
        .section("Service")
        .expect("Section Service doesn't exist")
        .attr("ExecStart")[0];
    println!("{}", start_cmd);
    Ok(())
}

pub fn attr_with_param( &self, key: impl AsRef<str>, param: impl AsRef<str>, ) -> &[String]

Get the value of the attribute name and param value param_val.

If the attribute is defined multiple times, all of them will be in the list, if the attribute is missing the list will be empty.

Examples found in repository

examples/get_localized_name.rs (line 7)

fn main() -> std::io::Result<()> {
    let lang = std::env::args().nth(1).expect("Not enough args");
    let entry = parse_entry("./test_data/firefox.desktop")?;
    let desktop_section = entry.section("Desktop Entry").unwrap();
    match desktop_section.attr_with_param("GenericName", lang).get(0) {
        Some(localized_name) => println!("{localized_name}"),
        None => println!("No name for that lang"),
    }
    Ok(())
}

pub fn has_attr(&self, key: impl AsRef<str>) -> bool

Check if this section has an attribute with name.

pub fn has_attr_with_param( &self, key: impl AsRef<str>, param: impl AsRef<str>, ) -> bool

Check if this section has an attribute with name and param value param_val.

pub fn attrs(&self) -> AttrIter<'_>

Iterator over attributes in this section

Trait Implementations

impl Clone for Section

fn clone(&self) -> Section

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Section

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

Formats the value using the given formatter.

impl<Idx: AsRef<str>> Index<Idx> for Section

fn index(&self, key: Idx) -> &Self::Output

Returns a reference to the value corresponding to the supplied key.

Panics

Panics if the key is not in the Section.

type Output = [String]

The returned type after indexing.

impl<'a> IntoIterator for &'a Section

type Item = (&'a AttrKey, &'a Vec<String>)

The type of the elements being iterated over.

type IntoIter = AttrIter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for Section

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for Section

impl StructuralPartialEq for Section