Struct noodles_bam::AsyncWriter

pub struct AsyncWriter<W> where
    W: AsyncWrite,  { /* fields omitted */ }

An async BAM writer.

Implementations

impl<W> Writer<W> where
    W: AsyncWrite + Unpin, 

pub fn builder(inner: W) -> Builder<W>

Creates an async BAM writer builder.

Examples

use noodles_bam as bam;
let builder = bam::AsyncWriter::builder(Vec::new());
let writer = builder.build();

pub fn new(inner: W) -> Self

Creates an async BAM writer with a default compression level.

Examples

use noodles_bam as bam;
let writer = bam::AsyncWriter::new(Vec::new());

pub async fn shutdown(&mut self) -> Result<()>

Shuts down the output stream.

Examples

use noodles_bam as bam;
let mut writer = bam::AsyncWriter::new(Vec::new());
writer.shutdown().await?;

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

Writes a SAM header.

Examples

use noodles_bam as bam;
use noodles_sam as sam;

let mut writer = bam::AsyncWriter::new(Vec::new());

let header = sam::Header::builder().add_comment("noodles-bam").build();
writer.write_header(&header).await?;

pub async fn write_reference_sequences(
    &mut self,
    reference_sequences: &ReferenceSequences
) -> Result<()>

Writes the binary reference sequences after the SAM header.

Examples

use noodles_bam as bam;
use noodles_sam::{self as sam, header::ReferenceSequence};

let mut writer = bam::AsyncWriter::new(Vec::new());

let header = sam::Header::builder()
    .add_reference_sequence(ReferenceSequence::new("sq0", 8)?)
    .add_comment("noodles-bam")
    .build();

writer.write_header(&header).await?;
writer.write_reference_sequences(header.reference_sequences()).await?;

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

Writes a BAM record.

Examples

use noodles_bam as bam;
let mut writer = bam::AsyncWriter::new(Vec::new());
let record = bam::Record::default();
writer.write_record(&record).await?;

pub async fn write_sam_record(
    &mut self,
    reference_sequences: &ReferenceSequences,
    record: &Record
) -> Result<()>

Writes a SAM record.

Examples

use noodles_bam as bam;
use noodles_sam as sam;

let mut writer = bam::AsyncWriter::new(Vec::new());

let reference_sequences = sam::header::ReferenceSequences::default();
let record = sam::Record::default();
writer.write_sam_record(&reference_sequences, &record).await?;