Struct shapefile::writer::ShapeWriter

pub struct ShapeWriter<T: Write + Seek> { /* fields omitted */ }

struct that handles the writing of the .shp and (optionally) the .idx

The recommended way to create a ShapeWriter by using ShapeWriter::from_path

Important

As this writer does not write the .dbf, it does not write what is considered a complete (thus valid) shapefile.

Implementations

impl<T: Write + Seek> ShapeWriter<T>

pub fn new(shp_dest: T) -> Self

Creates a writer that can be used to write a new shapefile.

The dest argument is only for the .shp

pub fn with_shx(shp_dest: T, shx_dest: T) -> Self

pub fn write_shape<S: EsriShape>(&mut self, shape: &S) -> Result<(), Error>

Write the shape to the file

Examples

use shapefile::Point;
let mut writer = shapefile::ShapeWriter::from_path("points.shp")?;

writer.write_shape(&Point::new(0.0, 0.0))?;
writer.write_shape(&Point::new(1.0, 0.0))?;
writer.write_shape(&Point::new(2.0, 0.0))?;

pub fn write_shapes<'a, S: EsriShape + 'a, C: IntoIterator<Item = &'a S>>(
    self,
    container: C
) -> Result<(), Error>

Writes a collection of shapes to the file

Examples

use shapefile::Point;
let mut writer = shapefile::ShapeWriter::from_path("points.shp")?;
let points = vec![Point::new(0.0, 0.0), Point::new(1.0, 0.0), Point::new(2.0, 0.0)];

writer.write_shapes(&points)?;

use shapefile::{Point, Polyline};
let mut writer = shapefile::ShapeWriter::from_path("polylines.shp")?;
let points = vec![Point::new(0.0, 0.0), Point::new(1.0, 0.0), Point::new(2.0, 0.0)];
let polyline = Polyline::new(points);

writer.write_shapes(&vec![polyline])?;

impl ShapeWriter<BufWriter<File>>

pub fn from_path<P: AsRef<Path>>(path: P) -> Result<Self, Error>

Creates a new writer from a path. Creates both a .shp and .shx files

Examples

let writer = shapefile::ShapeWriter::from_path("new_file.shp");

Trait Implementations

impl<T: Write + Seek> Drop for ShapeWriter<T>

fn drop(&mut self)

Executes the destructor for this type.