Struct RowSet

pub struct RowSet { /* private fields */ }

Container for a sys::SRowSet structure, such as the rows returned from sys::IMAPITable::QueryRows.

The *mut sys::SRowSet should be freed with a call to sys::FreeProws in the destructor, but sys::SRowSet allows embedded sys::SPropValue pointers to be peeled off and freed separately, as long as the pointer in the sys::SRowSet is replaced with null. The sys::FreeProws function will free any non-null property pointers in the sys::SRowSet, but silently skip the ones that are null.

Implementations

impl RowSet

pub fn as_mut_ptr(&mut self) -> *mut *mut SRowSet

Get an out-param pointer for the sys::SRowSet pointer.

pub fn is_empty(&self) -> bool

Test for a null sys::SRowSet pointer or a pointer to 0 rows.

pub fn len(&self) -> usize

Get the count of rows contained in the sys::SRowSet.

Trait Implementations

impl Default for RowSet

fn default() -> Self

The initial state for RowSet should have a null *mut sys::SRowSet pointer. An allocation should be added to it later using the RowSet::as_mut_ptr method to fill in an out-param from one of the sys functions or interface methods which retrieve a sys::SRowSet structure.

impl Drop for RowSet

fn drop(&mut self)

Call sys::FreeProws to free the *mut sys::SRowSet. This will also free any sys::SPropValue pointers that have not been transfered to an instance of Row.

impl IntoIterator for RowSet

fn into_iter(self) -> Self::IntoIter

Transfer ownership of the embedded sys::SPropValue pointers to an Iterator of Row.

type Item = Row

The type of the elements being iterated over.

type IntoIter = <Vec<<RowSet as IntoIterator>::Item> as IntoIterator>::IntoIter

Which kind of iterator are we turning this into?