Struct StepCodec 

pub struct StepCodec;

The STEP physical file codec (.ifc). The STEP physical file codec.

Strict: a record this codec cannot read is an error, because an authoring tool that silently drops entities corrupts the file it edits.

A consumer that would rather load a damaged export uses StepCodec::lenient and reads Model::diagnostics to see what was dropped.

use ifc_model::Codec;
use ifc_step::StepCodec;

// A damaged export: strict reading refuses it.
assert!(StepCodec.read_bytes(bytes).is_err());

// A viewer opts into recovery and reports what was lost.
let model = StepCodec::lenient().read_bytes(bytes)?;
assert_eq!(model.len(), 1);
assert_eq!(model.diagnostics().len(), 1);

Implementations

impl StepCodec

pub const fn lenient() -> StepReader

A reader that skips unreadable data records and reports each one as a Model diagnostic.

Header structure and the physical-file marker remain fatal: a file whose identity cannot be established is not partially readable.

pub const fn with_options(options: ParseOptions) -> StepReader

A reader with an explicit malformed-record policy.

Trait Implementations

impl Clone for StepCodec

fn clone(&self) -> StepCodec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Codec for StepCodec

fn name(&self) -> &'static str

Human-readable name for diagnostics, e.g. STEP.

fn extensions(&self) -> &'static [&'static str]

Conventional file extensions, lower-case, without the dot.

fn detect(&self, bytes: &[u8]) -> bool

Does this look like a file this codec can read?

fn read_bytes(&self, bytes: &[u8]) -> Result<Model, ModelError>

Parse a model from bytes.

fn read_owned(&self, bytes: Vec<u8>) -> Result<Model, ModelError>

Parse a model from a buffer the model may keep.

fn write(&self, model: &Model, out: &mut dyn Write) -> Result<(), ModelError>

Serialize a model.

fn read_path(&self, path: &Path) -> Result<Model, ModelError>

Parse a file from disk.

fn read_from(&self, reader: &mut dyn Read) -> Result<Model, ModelError>

Parse from any reader. Override when the format can stream.

fn write_path(&self, model: &Model, path: &Path) -> Result<(), ModelError>

Serialize to a file on disk.

fn write_bytes(&self, model: &Model) -> Result<Vec<u8>, ModelError>

Serialize to a byte vector.

impl Copy for StepCodec

impl Debug for StepCodec

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

Formats the value using the given formatter.

impl Default for StepCodec

fn default() -> StepCodec

Returns the “default value” for a type.