Struct geozero_shp::reader::Reader

pub struct Reader<T: Read> { /* fields omitted */ }

struct that reads the content of a shapefile

Implementations

impl<T: Read> Reader<T>

pub fn new(source: T) -> Result<Reader<T>, Error>

Creates a new Reader from a source that implements the Read trait

The Shapefile header is read upon creation (but no reading of the Shapes is done)

Errors

Will forward any std::io::Error

Will also return an error if the data is not a shapefile (Wrong file code)

Will also return an error if the shapetype read from the input source is invalid

pub fn header(&self) -> &Header

Returns a non-mutable reference to the header read

pub fn read_records(self) -> Result<Vec<Record>, Error>

Read and return only the records contained in the .dbf file

pub fn iter_geometries<P: FeatureProcessor>(
    self,
    processor: P
) -> ShapeIterator<P, T>

pub fn iter_features<P: FeatureProcessor>(
    self,
    processor: P
) -> Result<ShapeRecordIterator<P, T>, Error>

Returns an iterator over the Shapes and their Records

Errors

The Result will be an error if the .dbf wasn't found

pub fn add_index_source(&mut self, source: T) -> Result<(), Error>

Reads the index file from the source This allows to later read shapes by giving their index without reading the whole file

(see read_nth_shape())

pub fn add_dbf_source(&mut self, source: T) -> Result<(), Error>

Adds the source as the source where the dbf record will be read from

impl Reader<BufReader<File>>

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

Creates a reader from a path to a file

Will attempt to read both the .shx and .dbf associated with the file, if they do not exists the function will not fail, and you will get an error later if you try to use a function that requires the file to be present.