Struct life_backend::format::Rle

source ·

pub struct Rle { /* private fields */ }

Expand description

A representation for RLE file format.

The detail of this format is described in:

Examples

Parses the given RLE file, and checks live cells included in it:

use std::fs::File;
use life_backend::format::Rle;
use life_backend::Position;
let file = File::open("patterns/rpentomino.rle")?;
let parser = Rle::new(file)?;
assert!(parser.live_cells().eq([Position(1, 0), Position(2, 0), Position(0, 1), Position(1, 1), Position(1, 2)]));

Parses the given string in RLE format:

use life_backend::format::Rle;
use life_backend::Position;
let pattern = "\
    #N R-pentomino\n\
    x = 3, y = 3\n\
    b2o$2o$bo!\n\
";
let parser = pattern.parse::<Rle>()?;
assert!(parser.live_cells().eq([Position(1, 0), Position(2, 0), Position(0, 1), Position(1, 1), Position(1, 2)]));

Implementations§

source §

impl Rle

source

pub fn new<R>(read: R) -> Result<Self>where R: Read,

Creates from the specified implementor of Read, such as File or &[u8].

Examples

use life_backend::format::Rle;
let pattern = "\
    #N T-tetromino\n\
    x = 3, y = 2\n\
    3o$bo!\n\
";
let parser = Rle::new(pattern.as_bytes())?;

source

pub const fn width(&self) -> usize

Returns the width written in the pattern.

Examples

use life_backend::format::Rle;
let pattern = "\
    #N T-tetromino\n\
    x = 3, y = 2\n\
    3o$bo!\n\
";
let parser = Rle::new(pattern.as_bytes())?;
assert_eq!(parser.width(), 3);

source

pub const fn height(&self) -> usize

Returns the height written in the pattern.

Examples

use life_backend::format::Rle;
let pattern = "\
    #N T-tetromino\n\
    x = 3, y = 2\n\
    3o$bo!\n\
";
let parser = Rle::new(pattern.as_bytes())?;
assert_eq!(parser.height(), 2);

source

pub const fn rule(&self) -> &Rule

Returns the rule.

Examples

use life_backend::format::Rle;
use life_backend::Rule;
let pattern = "\
    #N T-tetromino\n\
    x = 3, y = 2, rule = B3/S23\n\
    3o$bo!\n\
";
let parser = Rle::new(pattern.as_bytes())?;
assert_eq!(parser.rule(), &Rule::conways_life());

source

pub const fn comments(&self) -> &Vec<String>

Returns comments of the pattern.

Examples

use life_backend::format::Rle;
let pattern = "\
    #N T-tetromino\n\
    x = 3, y = 2\n\
    3o$bo!\n\
";
let parser = Rle::new(pattern.as_bytes())?;
assert_eq!(parser.comments().len(), 1);
assert_eq!(parser.comments()[0], "#N T-tetromino");

source

pub fn live_cells(&self) -> impl Iterator<Item = Position<usize>> + '_

Creates an owning iterator over the series of live cell positions in ascending order.

Examples

use life_backend::format::Rle;
use life_backend::Position;
let pattern = "\
    #N T-tetromino\n\
    x = 3, y = 2\n\
    3o$bo!\n\
";
let parser = Rle::new(pattern.as_bytes())?;
assert!(parser.live_cells().eq([Position(0, 0), Position(1, 0), Position(2, 0), Position(1, 1)]));