Struct rust_htslib::bam::record::Record

pub struct Record {
    pub inner: *mut bam1_t,
    /* private fields */
}

A BAM record.

Fields

inner: *mut bam1_t

Implementations

impl Record

pub fn new() -> Self

Create an empty BAM record.

pub fn from_inner(inner: *mut bam1_t) -> Self

pub fn from_sam(
    header_view: &HeaderView,
    sam: &[u8]
) -> Result<Record, ReadError>

pub fn inner_mut(&mut self) -> &mut bam1_t

pub fn inner(&self) -> &bam1_t

pub fn tid(&self) -> i32

Get target id.

pub fn set_tid(&mut self, tid: i32)

Set target id.

pub fn pos(&self) -> i32

Get position (0-based).

pub fn set_pos(&mut self, pos: i32)

Set position (0-based).

pub fn bin(&self) -> u16

pub fn set_bin(&mut self, bin: u16)

pub fn mapq(&self) -> u8

Get MAPQ.

pub fn set_mapq(&mut self, mapq: u8)

Set MAPQ.

pub fn flags(&self) -> u16

Get raw flags.

pub fn set_flags(&mut self, flags: u16)

Set raw flags.

pub fn unset_flags(&mut self)

Unset all flags.

pub fn mtid(&self) -> i32

Get target id of mate.

pub fn set_mtid(&mut self, mtid: i32)

Set target id of mate.

pub fn mpos(&self) -> i32

Get mate position.

pub fn set_mpos(&mut self, mpos: i32)

Set mate position.

pub fn insert_size(&self) -> i32

Get insert size.

pub fn set_insert_size(&mut self, insert_size: i32)

Set insert size.

pub fn qname(&self) -> &[u8]

Get qname (read name). Complexity: O(1).

pub fn set_data(&mut self, new_data: &[u8])

Set the variable length data buffer

pub fn set(&mut self, qname: &[u8], cigar: &CigarString, seq: &[u8], qual: &[u8])

Set variable length data (qname, cigar, seq, qual). Note: Pre-existing aux data will be invalidated if called on an existing record. For this reason, never call push_aux() before set().

pub fn set_qname(&mut self, new_qname: &[u8])

Replace current qname with a new one. Unlike set(), this preserves all the variable length data including the aux.

pub fn cigar_len(&self) -> usize

pub fn raw_cigar(&self) -> &[u32]

Get reference to raw cigar string representation (as stored in BAM file). Usually, the method Record::cigar should be used instead.

pub fn cigar(&self) -> CigarStringView

Return unpacked cigar string. This will create a fresh copy the Cigar data.

pub fn cigar_cached(&self) -> Option<&CigarStringView>

pub fn cache_cigar(&mut self)

Decode the cigar string and cache it inside the Record

pub fn seq(&self) -> Seq<'_>

Get read sequence. Complexity: O(1).

pub fn qual(&self) -> &[u8]

Get base qualities (PHRED-scaled probability that base is wrong). This does not entail any offsets, hence the qualities can be used directly without e.g. subtracting 33. Complexity: O(1).

pub fn aux(&self, tag: &[u8]) -> Option<Aux<'_>>

Get auxiliary data (tags).

pub fn push_aux(
    &mut self,
    tag: &[u8],
    value: &Aux<'_>
) -> Result<(), AuxWriteError>

Add auxiliary data. push_aux() should never be called before set().

pub fn remove_aux(&self, tag: &[u8]) -> bool

pub fn is_paired(&self) -> bool

pub fn set_paired(&mut self)

pub fn unset_paired(&mut self)

pub fn is_proper_pair(&self) -> bool

pub fn set_proper_pair(&mut self)

pub fn unset_proper_pair(&mut self)

pub fn is_unmapped(&self) -> bool

pub fn set_unmapped(&mut self)

pub fn unset_unmapped(&mut self)

pub fn is_mate_unmapped(&self) -> bool

pub fn set_mate_unmapped(&mut self)

pub fn unset_mate_unmapped(&mut self)

pub fn is_reverse(&self) -> bool

pub fn set_reverse(&mut self)

pub fn unset_reverse(&mut self)

pub fn is_mate_reverse(&self) -> bool

pub fn set_mate_reverse(&mut self)

pub fn unset_mate_reverse(&mut self)

pub fn is_first_in_template(&self) -> bool

pub fn set_first_in_template(&mut self)

pub fn unset_first_in_template(&mut self)

pub fn is_last_in_template(&self) -> bool

pub fn set_last_in_template(&mut self)

pub fn unset_last_in_template(&mut self)

pub fn is_secondary(&self) -> bool

pub fn set_secondary(&mut self)

pub fn unset_secondary(&mut self)

pub fn is_quality_check_failed(&self) -> bool

pub fn set_quality_check_failed(&mut self)

pub fn unset_quality_check_failed(&mut self)

pub fn is_duplicate(&self) -> bool

pub fn set_duplicate(&mut self)

pub fn unset_duplicate(&mut self)

pub fn is_supplementary(&self) -> bool

pub fn set_supplementary(&mut self)

pub fn unset_supplementary(&mut self)

Trait Implementations

impl Clone for Record

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Record

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

Formats the value using the given formatter.

impl Drop for Record

fn drop(&mut self)

Executes the destructor for this type.

impl PartialEq<Record> for Record

fn eq(&self, other: &Record) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Record

impl Send for Record

impl Sync for Record