Struct AnchoredPath 

pub struct AnchoredPath { /* private fields */ }

A path as given, and the path to hand to Win32 for it.

The two are the same unless the path was grafted, by the rules in this module’s documentation. It is what OpenFile and WatchDirectory hold, and is public for a crate that builds a request of its own and performs it later on another thread, so that it fixes the meaning of a relative path by the same contract and does not keep a second one (D-30).

Example

use windows_namespace_request_sys::AnchoredPath;
use wtf_string::Wtf16String;

// An absolute path is handed to Win32 as it was given.
let absolute = AnchoredPath::new(Wtf16String::from(r"C:\Windows"))?;
assert_eq!(absolute.given(), absolute.win32());

// A relative name is grafted onto the current directory as it is now.
let relative = AnchoredPath::new(Wtf16String::from("a-child"))?;
assert_eq!(relative.given().to_string_lossy(), "a-child");
let expected = std::env::current_dir()?.join("a-child");
assert_eq!(relative.win32().to_string_lossy(), expected.to_string_lossy());

Implementations

impl AnchoredPath

pub fn new(given: Wtf16String) -> Result<Self, PathCaptureError>

Anchors given to the process current directory as it is now.

Errors

PathCaptureError::InteriorNul for a path with a NUL before its end, and otherwise the failure of GetCurrentDirectoryW, which is called only for a path whose shape permits a graft.

pub fn given(&self) -> &Wtf16Str

The path exactly as the caller gave it.

pub fn win32(&self) -> &Wtf16Str

The path that is handed to Win32.

Trait Implementations

impl Clone for AnchoredPath

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AnchoredPath

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

Formats the value using the given formatter.

impl Eq for AnchoredPath

impl Hash for AnchoredPath

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for AnchoredPath

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AnchoredPath