Enum Section 

pub enum Section<'a> {
    ScriptInfo(ScriptInfo<'a>),
    Styles(Vec<Style<'a>>),
    Events(Vec<Event<'a>>),
    Fonts(Vec<Font<'a>>),
    Graphics(Vec<Graphic<'a>>),
}

Top-level section in an ASS script

Represents the main sections that can appear in an ASS subtitle file. Each variant contains the parsed content of that section with zero-copy string references to the original source text.

Examples

use ass_core::parser::ast::{Section, ScriptInfo, SectionType, Span};

let info = ScriptInfo { fields: vec![("Title", "Test")], span: Span::new(0, 10, 1, 1) };
let section = Section::ScriptInfo(info);
assert_eq!(section.section_type(), SectionType::ScriptInfo);

Variants

ScriptInfo(ScriptInfo<'a>)

[Script Info] section with metadata

Contains key-value pairs defining script metadata like title, script type, resolution, and other configuration values.

Styles(Vec<Style<'a>>)

[V4+ Styles] section with style definitions

Contains style definitions that can be referenced by events. Each style defines font, colors, positioning, and other visual properties for subtitle rendering.

Events(Vec<Event<'a>>)

[Events\] section with dialogue and commands

Contains dialogue lines, comments, and other timed events that make up the actual subtitle content.

Fonts(Vec<Font<'a>>)

[Fonts\] section with embedded font data

Contains UU-encoded font files embedded in the script. Allows scripts to include custom fonts for portable rendering.

Graphics(Vec<Graphic<'a>>)

[Graphics\] section with embedded images

Contains UU-encoded image files embedded in the script. Used for logos, textures, and other graphical elements.

Implementations

impl Section<'_>

pub fn span(&self) -> Option<Span>

Get the span covering this entire section

Computes the span by looking at the content’s spans. Returns None if the section is empty.

pub const fn section_type(&self) -> SectionType

Get section type discriminant for efficient matching

Returns the section type without borrowing the section content, allowing for efficient type-based filtering and routing.

Examples

let info = Section::ScriptInfo(ScriptInfo { fields: Vec::new(), span: Span::new(0, 0, 0, 0) });
assert_eq!(info.section_type(), SectionType::ScriptInfo);

pub fn validate_spans(&self, source_range: &Range<usize>) -> bool

Available on debug-assertions enabled only.

Validate all spans in this section reference valid source

Debug helper to ensure zero-copy invariants are maintained. Validates that all string references in the section point to memory within the specified source range.

Only available in debug builds to avoid performance overhead in release builds.

Arguments

• source_range - Valid memory range for source text

Returns

true if all spans are valid, false otherwise

Trait Implementations

impl<'a> Clone for Section<'a>

fn clone(&self) -> Section<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Section<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for Section<'a>

fn eq(&self, other: &Section<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Eq for Section<'a>

impl<'a> StructuralPartialEq for Section<'a>