[−][src]Struct cfb::CompoundFile
Implementations
impl<F> CompoundFile<F>
[src]
pub fn version(&self) -> Version
[src]
Returns the CFB format version used for this compound file.
pub fn root_entry(&self) -> Entry
[src]
Returns information about the root storage object. This is equivalent
to self.entry("/").unwrap()
(but always succeeds).
pub fn entry<P: AsRef<Path>>(&self, path: P) -> Result<Entry>
[src]
Given a path within the compound file, get information about that stream or storage object.
pub fn read_storage<P: AsRef<Path>>(&self, path: P) -> Result<Entries<'_>>
[src]
Returns an iterator over the entries within a storage object.
pub fn walk_storage<P: AsRef<Path>>(&self, path: P) -> Result<Entries<'_>>
[src]
Returns an iterator over all entries under a storage subtree, including the given path itself. The iterator walks the storage tree in a preorder traversal.
pub fn exists<P: AsRef<Path>>(&self, path: P) -> bool
[src]
Returns true if there is an existing stream or storage at the given path, or false if there is nothing at that path.
pub fn is_stream<P: AsRef<Path>>(&self, path: P) -> bool
[src]
Returns true if there is an existing stream at the given path, or false if there is a storage or nothing at that path.
pub fn is_storage<P: AsRef<Path>>(&self, path: P) -> bool
[src]
Returns true if there is an existing storage at the given path, or false if there is a stream or nothing at that path.
pub fn into_inner(self) -> F
[src]
Consumes the CompoundFile
, returning the underlying reader/writer.
impl<F: Seek> CompoundFile<F>
[src]
pub fn open_stream<P: AsRef<Path>>(&mut self, path: P) -> Result<Stream<'_, F>>
[src]
Opens an existing stream in the compound file for reading and/or writing (depending on what the underlying file supports).
impl<F: Read + Seek> CompoundFile<F>
[src]
pub fn open(inner: F) -> Result<CompoundFile<F>>
[src]
Opens an existing compound file, using the underlying reader. If the
underlying reader also supports the Write
trait, then the
CompoundFile
object will be writable as well.
impl<F: Read + Write + Seek> CompoundFile<F>
[src]
pub fn create(inner: F) -> Result<CompoundFile<F>>
[src]
Creates a new compound file with no contents, using the underlying reader/writer. The reader/writer should be initially empty.
pub fn create_with_version(
version: Version,
inner: F
) -> Result<CompoundFile<F>>
[src]
version: Version,
inner: F
) -> Result<CompoundFile<F>>
Creates a new compound file of the given version with no contents, using the underlying writer. The writer should be initially empty.
pub fn create_storage<P: AsRef<Path>>(&mut self, path: P) -> Result<()>
[src]
Creates a new, empty storage object (i.e. "directory") at the provided path. The parent storage object must already exist.
pub fn create_storage_all<P: AsRef<Path>>(&mut self, path: P) -> Result<()>
[src]
Recursively creates a storage and all of its parent storages if they are missing.
pub fn remove_storage<P: AsRef<Path>>(&mut self, path: P) -> Result<()>
[src]
Removes the storage object at the provided path. The storage object must exist and have no children.
pub fn remove_storage_all<P: AsRef<Path>>(&mut self, path: P) -> Result<()>
[src]
Recursively removes a storage and all of its children. If called on the root storage, recursively removes all of its children but not the root storage itself (which cannot be removed).
pub fn set_storage_clsid<P: AsRef<Path>>(
&mut self,
path: P,
clsid: Uuid
) -> Result<()>
[src]
&mut self,
path: P,
clsid: Uuid
) -> Result<()>
Sets the CLSID for the storage object at the provided path. (To get
the current CLSID for a storage object, use
self.entry(path)?.clsid()
.)
pub fn create_stream<P: AsRef<Path>>(
&mut self,
path: P
) -> Result<Stream<'_, F>>
[src]
&mut self,
path: P
) -> Result<Stream<'_, F>>
Creates and returns a new, empty stream object at the provided path. If a stream already exists at that path, it will be replaced by the new stream. The parent storage object must already exist.
pub fn create_new_stream<P: AsRef<Path>>(
&mut self,
path: P
) -> Result<Stream<'_, F>>
[src]
&mut self,
path: P
) -> Result<Stream<'_, F>>
Creates and returns a new, empty stream object at the provided path. Returns an error if a stream already exists at that path. The parent storage object must already exist.
pub fn remove_stream<P: AsRef<Path>>(&mut self, path: P) -> Result<()>
[src]
Removes the stream object at the provided path.
pub fn set_state_bits<P: AsRef<Path>>(
&mut self,
path: P,
bits: u32
) -> Result<()>
[src]
&mut self,
path: P,
bits: u32
) -> Result<()>
Sets the user-defined bitflags for the object at the provided path.
(To get the current state bits for an object, use
self.entry(path)?.state_bits()
.)
pub fn touch<P: AsRef<Path>>(&mut self, path: P) -> Result<()>
[src]
Sets the modified time for the object at the given path to now. Has no effect when called on the root storage.
pub fn flush(&mut self) -> Result<()>
[src]
Flushes all changes to the underlying file.
Auto Trait Implementations
impl<F> RefUnwindSafe for CompoundFile<F> where
F: RefUnwindSafe,
F: RefUnwindSafe,
impl<F> Send for CompoundFile<F> where
F: Send,
F: Send,
impl<F> Sync for CompoundFile<F> where
F: Sync,
F: Sync,
impl<F> Unpin for CompoundFile<F> where
F: Unpin,
F: Unpin,
impl<F> UnwindSafe for CompoundFile<F> where
F: UnwindSafe,
F: UnwindSafe,
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,