Struct ContentMarks 

pub struct ContentMarks { /* private fields */ }

The mark stack a page object is stamped with.

Cheap to clone: Arc inside, and page objects snapshot it at creation.

Implementations

impl ContentMarks

pub fn new() -> Self

An empty stack.

pub fn marks(&self) -> &[Mark]

The marks, outermost first.

pub fn len(&self) -> usize

How many marks are open.

pub fn is_empty(&self) -> bool

Whether nothing is marked.

pub fn push(&mut self, tag: Name)

BMC: push a tag with no properties.

pub fn push_with_properties( &mut self, tag: Name, properties: &MarkProperties, resolve: impl FnOnce(&Name) -> Option<Dict>, ) -> bool

BDC: push a tag with a property list.

resolve is what turns a named property list into a dictionary; when it yields nothing, no mark is pushed at all.

pub fn pop(&mut self) -> bool

EMC: pop one mark, never past the sentinel.

Answers whether anything was popped — a question, not a failed mutation — so a caller can record the imbalance.

pub fn content_id(&self) -> Option<i64>

The /MCID of the first mark that declares one, or None.

pub fn optional_content(&self) -> Option<&Dict>

The optional-content group this content belongs to, if any.

Only a mark tagged exactly OC whose properties came from the /Properties resource counts — an inline BDC /OC << … >> is ignored entirely and its content stays visible.

pub fn optional_content_all(&self) -> Vec<&Dict>

Every optional-content dictionary enclosing this content, outermost first.

A visibility test scans the whole mark stack and any one entry can veto, so nested BDC /OC sequences each get a say — which the innermost alone does not capture. The same two conditions apply to each: the tag is exactly OC, and the properties came from the /Properties resource rather than being written inline.

Trait Implementations

impl Clone for ContentMarks

fn clone(&self) -> ContentMarks

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContentMarks

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

Formats the value using the given formatter.

impl Default for ContentMarks

fn default() -> ContentMarks

Returns the “default value” for a type.

impl PartialEq for ContentMarks

fn eq(&self, other: &ContentMarks) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ContentMarks