Struct WKBWriter

pub struct WKBWriter { /* private fields */ }

The WKBWriter type is used to generate HEX or WKB formatted output from Geometry.

Example

use geos::{Geom, Geometry, WKBWriter};

let point_geom = Geometry::new_from_wkt("POINT (2.5 2.5)").expect("Invalid geometry");
let mut writer = WKBWriter::new().expect("Failed to create WKBWriter");

// Output as WKB
let v: Vec<u8> = writer.write_wkb(&point_geom).unwrap().into();
assert_eq!(Geometry::new_from_wkb(&v).unwrap().to_wkt_precision(1).unwrap(),
           "POINT (2.5 2.5)");

// Output as HEX
let v: Vec<u8> = writer.write_hex(&point_geom).unwrap().into();
assert_eq!(Geometry::new_from_hex(&v).unwrap().to_wkt_precision(1).unwrap(),
           "POINT (2.5 2.5)");

Implementations

impl WKBWriter

pub fn new() -> GResult<WKBWriter>

Creates a new WKBWriter instance.

Example

use geos::{Geom, Geometry, WKBWriter};

let point_geom = Geometry::new_from_wkt("POINT (2.5 2.5)").expect("Invalid geometry");
let mut writer = WKBWriter::new().expect("Failed to create WKBWriter");

let v: Vec<u8> = writer.write_wkb(&point_geom).unwrap().into();
assert_eq!(Geometry::new_from_wkb(&v).unwrap().to_wkt_precision(1).unwrap(),
           "POINT (2.5 2.5)");

pub fn write_wkb<G: Geom>(&mut self, geometry: &G) -> GResult<CVec<u8>>

Writes out the given geometry as WKB format.

Example

use geos::{Geometry, WKBWriter};

let point_geom = Geometry::new_from_wkt("POINT (2.5 2.5)").expect("Invalid geometry");
let mut writer = WKBWriter::new().expect("Failed to create WKBWriter");

let v: Vec<u8> = writer.write_wkb(&point_geom).unwrap().into();
let expected = vec![1u8, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 4, 64, 0, 0, 0, 0, 0, 0, 4, 64];
assert_eq!(v, expected);

pub fn write_hex<G: Geom>(&mut self, geometry: &G) -> GResult<CVec<u8>>

Writes out the given geometry as WKB format.

Example

use geos::{Geometry, WKBWriter};

let point_geom = Geometry::new_from_wkt("POINT (2.5 2.5)").expect("Invalid geometry");
let mut writer = WKBWriter::new().expect("Failed to create WKBWriter");

let v: Vec<u8> = writer.write_hex(&point_geom).unwrap().into();
let expected = vec![48u8,49,48,49,48,48,48,48,48,48,48,48,48,48,48,48,48,48,48,48,48,48,48,
                    52,52,48,48,48,48,48,48,48,48,48,48,48,48,48,48,52,52,48];
assert_eq!(v, expected);

pub fn set_output_dimension(&mut self, dimension: OutputDimension)

Sets the number of dimensions to be used when calling WKBWriter::write_wkb or WKBWriter::write_hex. By default, it is 2.

Example

use geos::{Geometry, OutputDimension, WKBWriter, WKTWriter};

let mut wkt_writer = WKTWriter::new().expect("Failed to create WKTWriter");
wkt_writer.set_output_dimension(OutputDimension::ThreeD);
wkt_writer.set_trim(true);

let point_geom = Geometry::new_from_wkt("POINT (1.1 2.2 3.3)").expect("Invalid geometry");
let mut writer = WKBWriter::new().expect("Failed to create WKBWriter");

let v: Vec<u8> = writer.write_wkb(&point_geom).unwrap().into();
let geom = Geometry::new_from_wkb(&v).unwrap();
assert_eq!(wkt_writer.write(&geom).unwrap(), "POINT (1.1 2.2)");

writer.set_output_dimension(OutputDimension::ThreeD);
let v: Vec<u8> = writer.write_wkb(&point_geom).unwrap().into();
let geom = Geometry::new_from_wkb(&v).unwrap();
assert_eq!(wkt_writer.write(&geom).unwrap(), "POINT Z (1.1 2.2 3.3)");

pub fn get_out_dimension(&self) -> GResult<OutputDimension>

Returns the number of dimensions to be used when calling WKBWriter::write_wkb. By default, it is 2.

Example

use geos::{OutputDimension, WKBWriter};

let mut writer = WKBWriter::new().expect("Failed to create WKBWriter");

assert_eq!(writer.get_out_dimension(), Ok(OutputDimension::TwoD));
writer.set_output_dimension(OutputDimension::ThreeD);
assert_eq!(writer.get_out_dimension(), Ok(OutputDimension::ThreeD));

pub fn get_wkb_byte_order(&self) -> GResult<ByteOrder>

Gets WKB byte order.

Example

use geos::{ByteOrder, WKBWriter};

let mut writer = WKBWriter::new().expect("Failed to create WKBWriter");

writer.set_wkb_byte_order(ByteOrder::LittleEndian);
assert_eq!(writer.get_wkb_byte_order(), Ok(ByteOrder::LittleEndian));

pub fn set_wkb_byte_order(&mut self, byte_order: ByteOrder)

Sets WKB byte order.

Example

use geos::{WKBWriter, ByteOrder};

let mut writer = WKBWriter::new().expect("Failed to create WKBWriter");

writer.set_wkb_byte_order(ByteOrder::LittleEndian);
assert_eq!(writer.get_wkb_byte_order(), Ok(ByteOrder::LittleEndian));

pub fn get_include_SRID(&self) -> GResult<bool>

Gets if output will include SRID.

Example

use geos::WKBWriter;

let mut writer = WKBWriter::new().expect("Failed to create WKBWriter");

writer.set_include_SRID(true);
assert_eq!(writer.get_include_SRID(), Ok(true));

pub fn set_include_SRID(&mut self, include_SRID: bool)

Sets if output will include SRID.

Example

use geos::WKBWriter;

let mut writer = WKBWriter::new().expect("Failed to create WKBWriter");

writer.set_include_SRID(true);
assert_eq!(writer.get_include_SRID(), Ok(true));

Trait Implementations

impl Drop for WKBWriter

fn drop(&mut self)

Executes the destructor for this type.

impl Send for WKBWriter

impl Sync for WKBWriter