Struct RecordNode 

pub struct RecordNode { /* private fields */ }

A record node that contains other nodes as children.

Record nodes are the structural backbone of ESF files, organizing data into a hierarchical tree. Each record has a name (referencing the string table), a version number, and zero or more child nodes.

Children Organization

Children can be organized in two ways depending on the HAS_NESTED_BLOCKS flag:

• Without nested blocks: Single flat list of children (children[0])
• With nested blocks: Multiple groups of children, each group representing a logical grouping (e.g., multiple instances of the same record type)

Example Structure

A typical ESF might have a structure like:

ROOT
├── CAMPAIGN_SAVE_GAME (record)
│   ├── FACTION (record, nested blocks for multiple factions)
│   │   ├── [Group 0: Faction 1 data...]
│   │   └── [Group 1: Faction 2 data...]
│   └── DATE (record)
│       ├── year (u32)
│       └── turn (u32)

Implementations

impl RecordNode

pub fn record_flags(&self) -> &RecordNodeFlags

Encoding flags controlling how this record is serialized.

pub fn version(&self) -> &u8

Version number of this record’s schema (0-255). Used by the game to handle format changes across patches.

pub fn name(&self) -> &String

Name of the record (e.g., “FACTION”, “CAMPAIGN_SAVE_GAME”). This is resolved from the record names string table during decode.

pub fn children(&self) -> &Vec<Vec<NodeType>>

Child nodes organized into groups.

• Without HAS_NESTED_BLOCKS: Single group at index 0
• With HAS_NESTED_BLOCKS: Multiple groups, each a separate logical unit

impl RecordNode

pub fn record_flags_mut(&mut self) -> &mut RecordNodeFlags

Encoding flags controlling how this record is serialized.

pub fn version_mut(&mut self) -> &mut u8

Version number of this record’s schema (0-255). Used by the game to handle format changes across patches.

pub fn name_mut(&mut self) -> &mut String

Name of the record (e.g., “FACTION”, “CAMPAIGN_SAVE_GAME”). This is resolved from the record names string table during decode.

pub fn children_mut(&mut self) -> &mut Vec<Vec<NodeType>>

Child nodes organized into groups.

• Without HAS_NESTED_BLOCKS: Single group at index 0
• With HAS_NESTED_BLOCKS: Multiple groups, each a separate logical unit

impl RecordNode

pub fn set_record_flags(&mut self, val: RecordNodeFlags) -> &mut Self

Encoding flags controlling how this record is serialized.

pub fn set_version(&mut self, val: u8) -> &mut Self

Version number of this record’s schema (0-255). Used by the game to handle format changes across patches.

pub fn set_name(&mut self, val: String) -> &mut Self

Name of the record (e.g., “FACTION”, “CAMPAIGN_SAVE_GAME”). This is resolved from the record names string table during decode.

pub fn set_children(&mut self, val: Vec<Vec<NodeType>>) -> &mut Self

Child nodes organized into groups.

• Without HAS_NESTED_BLOCKS: Single group at index 0
• With HAS_NESTED_BLOCKS: Multiple groups, each a separate logical unit

Trait Implementations

impl Clone for RecordNode

fn clone(&self) -> RecordNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecordNode

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

Formats the value using the given formatter.

impl Default for RecordNode

fn default() -> RecordNode

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RecordNode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RecordNode

fn eq(&self, other: &RecordNode) -> 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 RecordNode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RecordNode