Struct calamine::vba::VbaProject

source ·
pub struct VbaProject { /* private fields */ }
Expand description

A struct for managing VBA reading

Implementations§

source§

impl VbaProject

source

pub fn new<R: Read>(r: &mut R, len: usize) -> Result<VbaProject, VbaError>

Create a new VbaProject out of the vbaProject.bin ZipFile or xls file

Starts reading project metadata (header, directories, sectors and minisectors).

source

pub fn from_cfb<R: Read>( r: &mut R, cfb: &mut Cfb ) -> Result<VbaProject, VbaError>

Creates a new VbaProject out of a Compound File Binary and the corresponding reader

source

pub fn get_references(&self) -> &[Reference]

Gets the list of References

source

pub fn get_module_names(&self) -> Vec<&str>

Gets the list of Module names

source

pub fn get_module(&self, name: &str) -> Result<String, VbaError>

Reads module content and tries to convert to utf8

While it works most of the time, the modules are MBCS encoding and the conversion may fail. If this is the case you should revert to read_module_raw as there is no built in decoding provided in this crate

§Examples
use calamine::{Reader, open_workbook, Xlsx};

let mut xl: Xlsx<_> = open_workbook(path).expect("Cannot find excel file");
if let Some(Ok(mut vba)) = xl.vba_project() {
    let vba = vba.to_mut();
    let modules = vba.get_module_names().into_iter()
                     .map(|s| s.to_string()).collect::<Vec<_>>();
    for m in modules {
        println!("Module {}:", m);
        println!("{}", vba.get_module(&m)
                          .expect(&format!("cannot read {:?} module", m)));
    }
}
source

pub fn get_module_raw(&self, name: &str) -> Result<&[u8], VbaError>

Reads module content (MBCS encoded) and output it as-is (binary output)

Trait Implementations§

source§

impl Clone for VbaProject

source§

fn clone(&self) -> VbaProject

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. 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> 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> ToOwned for T
where T: Clone,

§

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>,

§

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>,

§

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.