[−][src]Trait rust_htslib::bcf::Read
A trait for a BCF reader with a read method.
Required methods
fn read(&mut self, record: &mut Record) -> Result<bool>
Read the next record.
Arguments
- record - an empty record, that can be created with
bcf::Reader::empty_record
.
Returns
A result with an error in case of failure. Otherwise, true if a record was read, false if no record was read because the end of the file was reached.
fn records(&mut self) -> Records<Self>
Return an iterator over all records of the VCF/BCF file.
fn header(&self) -> &HeaderView
Return the header.
fn empty_record(&self) -> Record
Return empty record. Can be reused multiple times.
fn set_threads(&mut self, n_threads: usize) -> Result<()>
Activate multi-threaded BCF/VCF read support in htslib. This should permit faster reading of large VCF files.
Setting nthreads
to 0
does not change the current state. Note that it is not
possible to set the number of background threads below 1
once it has been set.
Arguments
n_threads
- number of extra background writer threads to use, must be> 0
.