Struct noodles_vcf::writer::Writer

source ·
pub struct Writer<W> { /* private fields */ }
Expand description

A VCF writer.

Examples

use noodles_vcf::{
    self as vcf,
    header::record::value::{map::Contig, Map},
    record::Position,
};

let mut writer = vcf::Writer::new(Vec::new());

let header = vcf::Header::builder()
    .add_contig("sq0".parse()?, Map::<Contig>::new())
    .build();

writer.write_header(&header)?;

let record = vcf::Record::builder()
    .set_chromosome("sq0".parse()?)
    .set_position(Position::from(1))
    .set_reference_bases("A".parse()?)
    .build()?;

writer.write_record(&header, &record);

let expected = b"##fileformat=VCFv4.4
##contig=<ID=sq0>
#CHROM\tPOS\tID\tREF\tALT\tQUAL\tFILTER\tINFO
sq0\t1\t.\tA\t.\t.\t.\t.
";

assert_eq!(&writer.get_ref()[..], &expected[..]);

Implementations§

source§

impl<W> Writer<W>where W: Write,

source

pub fn new(inner: W) -> Self

Creates a VCF writer.

Examples
use noodles_vcf as vcf;
let writer = vcf::Writer::new(Vec::new());
source

pub fn get_ref(&self) -> &W

Returns a reference to the underlying writer.

Examples
use noodles_vcf as vcf;
let writer = vcf::Writer::new(Vec::new());
assert!(writer.get_ref().is_empty());
source

pub fn get_mut(&mut self) -> &mut W

Returns a mutable reference to the underlying writer.

Examples
use noodles_vcf as vcf;
let mut writer = vcf::Writer::new(Vec::new());
assert!(writer.get_mut().is_empty());
source

pub fn into_inner(self) -> W

Unwraps and returns the underlying writer.

Examples
use noodles_vcf as vcf;
let writer = vcf::Writer::new(Vec::new());
assert!(writer.into_inner().is_empty());
source

pub fn write_header(&mut self, header: &Header) -> Result<()>

Writes a VCF header.

Examples
use noodles_vcf as vcf;

let mut writer = vcf::Writer::new(Vec::new());

let header = vcf::Header::default();
writer.write_header(&header)?;
source

pub fn write_record(&mut self, _: &Header, record: &Record) -> Result<()>

Writes a VCF record.

Examples
use noodles_vcf::{self as vcf, record::Position};

let header = vcf::Header::default();

let record = vcf::Record::builder()
    .set_chromosome("sq0".parse()?)
    .set_position(Position::from(1))
    .set_reference_bases("A".parse()?)
    .build()?;

let mut writer = vcf::Writer::new(Vec::new());
writer.write_record(&header, &record)?;

Trait Implementations§

source§

impl<W: Debug> Debug for Writer<W>

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl<W> VariantWriter for Writer<W>where W: Write,

source§

fn write_variant_header(&mut self, header: &Header) -> Result<()>

Writes a VCF header.
source§

fn write_variant_record( &mut self, header: &Header, record: &Record ) -> Result<()>

Writes a variant record.

Auto Trait Implementations§

§

impl<W> RefUnwindSafe for Writer<W>where W: RefUnwindSafe,

§

impl<W> Send for Writer<W>where W: Send,

§

impl<W> Sync for Writer<W>where W: Sync,

§

impl<W> Unpin for Writer<W>where W: Unpin,

§

impl<W> UnwindSafe for Writer<W>where W: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more