ResFilesystem

Struct ResFilesystem 

Source
pub struct ResFilesystem { /* private fields */ }
Expand description

A virtual read-only filesystem you can use to walk through the game’s resources. This filesystem is designed to work really fast on systems where it will run for a long time and take advantage of its internal cache, but it will also work on run-once environment such as CLI where the first answer latency must be minimal.

This filesystem is made to be shared between threads and immutably accessed.

Internally, this filesystem has a cache to improve response delay. The challenge is that directories may reside in many packages, but files are present only in one package.

Implementations§

Source§

impl ResFilesystem

Source

pub fn new<P: Into<PathBuf>>(dir_path: P) -> Result<Self>

Create a new resources filesystem with the given options. This function is blocking while it is doing a rudimentary early indexing, so this may take some time.

Source

pub fn read<P: AsRef<str>>(&self, file_path: P) -> Result<ResReadFile>

Read a file from its path in the resource filesystem.

Source

pub fn read_dir<P: AsRef<str>>(&self, dir_path: P) -> Result<ResReadDir>

Read a directory’s entries in the resource filesystem. This function may be blocking a short time because it needs to find the first node of that directory.

This function may return a file not found error if no package contains this directory.

Trait Implementations§

Source§

impl Clone for ResFilesystem

Source§

fn clone(&self) -> ResFilesystem

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ResFilesystem

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V