Struct Section 

pub struct Section<'a> {
    pub table_id: u8,
    pub section_syntax_indicator: bool,
    pub private_indicator: bool,
    pub section_length: u16,
    pub extension_id: u16,
    pub version_number: u8,
    pub current_next_indicator: bool,
    pub section_number: u8,
    pub last_section_number: u8,
    pub payload: &'a [u8],
    pub crc32: Option<u32>,
}

A parsed PSI/SI section header, borrowing the raw input buffer for payload.

Created via Section::parse(bytes). Does not validate the CRC on construction — call Section::validate_crc explicitly.

Fields

table_id: u8

Table identifier.

section_syntax_indicator: bool

When true the section uses the long-form syntax (has extension header and CRC). When false only the 3-byte header is present (short form, e.g. TDT — but see the module docs for the TOT exception: SSI=0 yet CRC present; parse TOT via tables::tot, not this path).

private_indicator: bool

Private indicator bit (meaning is table-specific).

section_length: u16

Number of bytes following byte 2 of the section header.

extension_id: u16

Table ID extension (aka table_id_extension). Present only for long-form sections; zero for short-form.

version_number: u8

Version number (5 bits). Present only for long-form sections.

current_next_indicator: bool

current_next_indicator flag. Present only for long-form sections.

section_number: u8

Section number within the table sub-table.

last_section_number: u8

Number of the last section in the table sub-table.

payload: &'a [u8]

Section payload: excludes the header bytes and the trailing CRC for long-form sections. For short-form sections this is bytes 3..(section_length + 3).

crc32: Option<u32>

Declared CRC value (last 4 bytes, big-endian). None for short-form sections which carry no CRC.

Implementations

impl<'a> Section<'a>

pub fn payload(&self) -> &'a [u8]

Return the payload slice (same as the payload field — convenience getter for code that has a &Section reference).

pub fn validate_crc(&self, raw: &[u8]) -> Result<()>

Validate the CRC-32 of the section against raw — the complete section bytes (including header and CRC suffix).

For short-form sections (section_syntax_indicator == false) this returns Ok(()) immediately because no CRC is present.

Errors

Returns Error::CrcMismatch when the computed CRC over raw[..raw.len() - 4] does not match the declared value at raw[raw.len()-4..].

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

Formats the value using the given formatter.

impl<'de: 'a, 'a> Deserialize<'de> for Section<'a>

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

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

impl<'a> Parse<'a> for Section<'a>

fn parse(bytes: &'a [u8]) -> Result<Self>

Parse a complete section from bytes.

Errors

• Error::BufferTooShort — fewer than 3 bytes supplied.
• Error::SectionLengthOverflow — section_length field declares more data than bytes contains.

type Error = Error

The error type this implementer returns. Typically the enclosing crate’s Error enum.

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 Serialize for Section<'_>

type Error = Error

The error type this implementer returns (usually the same as the corresponding Parse impl, but need not be).

fn serialized_len(&self) -> usize

Number of bytes serialize_into will write.

fn serialize_into(&self, buf: &mut [u8]) -> Result<usize>

Write the serialised form into buf. Returns the number of bytes written (always equal to serialized_len()).

fn to_bytes(&self) -> Vec<u8>

where Self::Error: Debug,

Convenience: allocate a Vec and serialise into it. Panics only if serialize_into misreports serialized_len() — a contract every implementer is responsible for upholding.

impl<'a> Serialize for Section<'a>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

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