Struct NameTree 

pub struct NameTree<V> { /* private fields */ }

A parsed name tree mapping string keys to values of type V.

Implementations

impl<V> NameTree<V>

pub fn parse<S: PdfSource, F>( root: &Object, store: &ObjectStore<S>, convert: F, ) -> DocResult<Self>

where F: Fn(&Object) -> DocResult<V>,

Parse a name tree starting from the given root object.

The convert function transforms each value Object into a V. Traversal is fully iterative using an explicit stack.

pub fn count(&self) -> usize

Return the number of entries in this name tree.

Corresponds to CPDF_NameTree::GetCount() in PDFium.

pub fn get_count(&self) -> usize

Upstream-aligned alias for count().

Corresponds to CPDF_NameTree::GetCount() in PDFium.

pub fn get(&self, name: &str) -> Option<&V>

Look up a value by its string key.

pub fn entries(&self) -> &[(String, V)]

Return all entries as a slice of (String, V) pairs.

pub fn add(&mut self, name: String, value: V) -> DocResult<()>

Add an entry to the name tree, maintaining sorted order.

If an entry with the same name already exists it is replaced. The in-memory tree is updated; to persist the change to a PDF file use rpdfium-edit.

pub fn delete_by_index(&mut self, index: usize) -> DocResult<()>

Delete an entry by its index.

Returns DocError::InvalidIndex if index is out of range.

pub fn delete_by_name(&mut self, name: &str) -> DocResult<()>

Delete an entry by its name key.

Returns DocError::NotFound if no entry with the given name exists.

Trait Implementations

impl<V: Clone> Clone for NameTree<V>

fn clone(&self) -> NameTree<V>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<V: Debug> Debug for NameTree<V>

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

Formats the value using the given formatter.