Struct Quoted 

pub struct Quoted<'a> { /* private fields */ }

A wrapper around string types for displaying with quoting and escaping applied.

Implementations

impl<'a> Quoted<'a>

pub fn native(text: &'a str) -> Quoted<'a>

Quote a string with the default style for the platform.

On Windows this is PowerShell syntax, on all other platforms this is bash/ksh syntax.

pub fn native_raw(text: &'a OsStr) -> Quoted<'a>

Quote an OsStr with the default style for the platform.

On platforms other than Windows and Unix, if the encoding is invalid, the Debug representation will be used.

pub fn force(self, force: bool) -> Quoted<'a>

Toggle forced quoting. If true, quotes are added even if no special characters are present.

Defaults to true.

pub fn external(self, external: bool) -> Quoted<'a>

When quoting for PowerShell, toggle whether to use legacy quoting for external programs.

If enabled, double quotes (and sometimes backslashes) will be escaped so that they can be passed to external programs in PowerShell versions before 7.3, or with $PSNativeCommandArgumentPassing set to 'Legacy'.

If disabled, quoting will suit modern argument passing (always used for internal commandlets and .NET functions). Strings that look like options or numbers will be quoted.

It is sadly impossible to quote a string such that it’s suitable for both modern and legacy argument passing.

Defaults to false.

Optional

This requires either the windows or the native feature. It has no effect on Unix-style quoting.

Trait Implementations

impl<'a> Clone for Quoted<'a>

fn clone(&self) -> Quoted<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Quoted<'a>

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

Formats the value using the given formatter.

impl Display for Quoted<'_>

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

Formats the value using the given formatter.

impl<'a, T> From<&'a T> for Quoted<'a>

where T: Quotable + ?Sized,

fn from(val: &'a T) -> Quoted<'a>

Converts to this type from the input type.

impl<'a> Copy for Quoted<'a>