Struct RawCoordinateKey 

#[repr(C)]
pub struct RawCoordinateKey {
    pub sort_key: u64,
}

Fixed-size coordinate sort key for raw BAM sorting (8 bytes).

This key is designed for efficient temp file storage and O(1) comparisons during merge phase. It packs:

• sort_key: (tid << 34) | ((pos+1) << 1) | reverse

Note: No read name tie-breaking is used, matching samtools behavior. Equal records maintain their original input order (stable sort).

Fields

sort_key: u64

Packed primary sort key: (tid << 34) | ((pos+1) << 1) | reverse.

Implementations

impl RawCoordinateKey

pub const SIZE: usize = 8

Size in bytes when serialized.

pub fn new(tid: i32, pos: i32, reverse: bool, nref: u32) -> Self

Create a new coordinate key from components.

Arguments

• tid - Reference sequence ID (-1 for unmapped)
• pos - 0-based alignment position
• reverse - True if reverse complemented
• nref - Number of reference sequences (for unmapped handling)

pub fn unmapped() -> Self

Create a key for unmapped records (sorts after all mapped).

pub fn zeroed() -> Self

Create a zeroed key (for memory operations).

Trait Implementations

impl Clone for RawCoordinateKey

fn clone(&self) -> RawCoordinateKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RawCoordinateKey

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

Formats the value using the given formatter.

impl Default for RawCoordinateKey

fn default() -> Self

Returns the “default value” for a type.

impl Ord for RawCoordinateKey

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for RawCoordinateKey

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for RawCoordinateKey

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl RawSortKey for RawCoordinateKey

const SERIALIZED_SIZE: Option<usize>

Fixed byte size when serialized, or None for variable-length keys.

fn extract(bam: &[u8], ctx: &SortContext) -> Self

Extract a sort key from raw BAM record bytes.

fn write_to<W: Write>(&self, writer: &mut W) -> Result<()>

Serialize the key to a writer for temp file storage.

fn read_from<R: Read>(reader: &mut R) -> Result<Self>

Deserialize a key from a reader.

impl Zeroable for RawCoordinateKey

fn zeroed() -> Self

Calls zeroed.

impl Copy for RawCoordinateKey

impl Eq for RawCoordinateKey

impl Pod for RawCoordinateKey

impl StructuralPartialEq for RawCoordinateKey