Struct StringSplicer

pub struct StringSplicer<'a, T: Bytes> { /* private fields */ }

Temporary storage for the string to be spliced. Can assemble the final OsString in different ways, depending on the use-case. Created by splice().

Implementations

impl<'a, T: Bytes> StringSplicer<'a, T>

pub fn assemble(self) -> OsString

Assembles the final string by appending individual items without any other processing.

pub fn assemble_with_sep(self, sep: impl Bytes) -> OsString

Places a separator between all the elements that are spliced into the string.

pub fn assemble_with_wrap(self, wrap: impl Bytes) -> OsString

Wraps all items with the provided value before inserting them into the string.

pub fn assemble_with_sep_and_wrap( self, sep: impl Bytes, wrap: impl Bytes, ) -> OsString

Wraps all items with the provided value and places the separator item between the individual elements.

Examples

use std::ffi::OsStr;
use osstrtools::{OsStrTools, StringSplicer};

let strings: &[&OsStr] = &[OsStr::new("/foo/bar"),
                           OsStr::new("/baz/")];
let s = OsStr::new("rm #");

let mut splicer = s.splice("#", strings);
let result = splicer.assemble_with_sep_and_wrap(" ", "'");

assert_eq!(result, "rm '/foo/bar' '/baz/'");