Struct noodles_vcf::header::record::value::map::Map

pub struct Map<I>where
    I: Inner,{ /* private fields */ }

A VCF header map value.

Implementations

impl Map<AlternativeAllele>

pub fn new<D>(description: D) -> Selfwhere D: Into<String>,

Creates a VCF header alternative allele map value.

Examples

use noodles_vcf::{
    header::record::value::{map::AlternativeAllele, Map},
    record::alternate_bases::allele::{
        symbol::{structural_variant::Type, StructuralVariant},
        Symbol,
    },
};

let id = Symbol::StructuralVariant(StructuralVariant::from(Type::Deletion));
let map = Map::<AlternativeAllele>::new("Deletion");

impl Map<Contig>

pub fn new() -> Self

Creates a VCF header contig map value.

Examples

use noodles_vcf::header::record::value::{map::Contig, Map};
let map = Map::<Contig>::new();

pub fn length(&self) -> Option<usize>

Returns the length.

Examples

use noodles_vcf::header::record::value::{map::Contig, Map};
let map = Map::<Contig>::new();
assert!(map.length().is_none());

pub fn length_mut(&mut self) -> &mut Option<usize>

Returns a mutable reference to the length.

Examples

use noodles_vcf::header::record::value::{map::Contig, Map};

let mut map = Map::<Contig>::new();
assert!(map.length().is_none());

*map.length_mut() = Some(8);
assert_eq!(map.length(), Some(8));

pub fn md5(&self) -> Option<&str>

Returns the MD5 hexdigest.

Examples

use noodles_vcf::header::record::value::{map::Contig, Map};
let map = Map::<Contig>::new();
assert!(map.md5().is_none());

pub fn md5_mut(&mut self) -> &mut Option<String>

Returns a mutable reference to the MD5 hexdigest.

Examples

use noodles_vcf::header::record::value::{map::Contig, Map};

let mut map = Map::<Contig>::new();
assert!(map.md5().is_none());

*map.md5_mut() = Some(String::from("d7eba311421bbc9d3ada44709dd61534"));
assert_eq!(map.md5(), Some("d7eba311421bbc9d3ada44709dd61534"));

pub fn url(&self) -> Option<&str>

Returns the URL.

Examples

use noodles_vcf::header::record::value::{map::Contig, Map};
let map = Map::<Contig>::new();
assert!(map.url().is_none());

pub fn url_mut(&mut self) -> &mut Option<String>

Returns a mutable reference to the URL.

Examples

use noodles_vcf::header::record::value::{map::Contig, Map};

let mut map = Map::<Contig>::new();
assert!(map.url().is_none());

*map.url_mut() = Some(String::from("https://example.com/reference.fa"));
assert_eq!(map.url(), Some("https://example.com/reference.fa"));

impl Map<Filter>

pub fn pass() -> Self

Creates a default VCF header filter map value for “PASS”.

Examples

use noodles_vcf::header::record::value::{map::Filter, Map};
let actual = Map::<Filter>::pass();
let expected = Map::<Filter>::new("All filters passed");
assert_eq!(actual, expected);

pub fn new<D>(description: D) -> Selfwhere D: Into<String>,

Creates a VCF header filter map value.

Examples

use noodles_vcf::header::record::value::{map::Filter, Map};
let map = Map::<Filter>::new("Quality below 10");

impl Map<Format>

pub fn new<D>(number: Number, ty: Type, description: D) -> Selfwhere D: Into<String>,

Creates a VCF header format map value.

Examples

use noodles_vcf::{
    header::{record::value::{map::{format::Type, Format}, Map}, Number},
    record::genotypes::keys::key,
};

let id = key::GENOTYPE;
let map = Map::<Format>::new(Number::Count(1), Type::String, "Genotype");

impl Map<Info>

pub fn new<D>(number: Number, ty: Type, description: D) -> Selfwhere D: Into<String>,

Creates a VCF header info map value.

Examples

use noodles_vcf::{
    header::{record::value::{map::{info::Type, Info}, Map}, Number},
    record::info::field::key,
};

let id = key::SAMPLES_WITH_DATA_COUNT;
let map = Map::<Info>::new(
    Number::Count(1),
    Type::Integer,
    "Number of samples with data",
);

impl Map<Meta>

pub fn new(values: Vec<String>) -> Self

Creates a VCF header meta map value.

Examples

use noodles_vcf::header::record::value::{map::Meta, Map};

let id = "Assay";
let map = Map::<Meta>::new(
    vec![String::from("WholeGenome"), String::from("Exome")],
);

pub fn values(&self) -> &[String]

Returns the meta values.

Examples

use noodles_vcf::header::record::value::{map::Meta, Map};
let values = vec![String::from("WholeGenome"), String::from("Exome")];
let map = Map::<Meta>::new(values.clone());
assert_eq!(map.values(), &values);

impl Map<Other>

pub fn new() -> Self

Creates a nonstandard VCF header map value.

Examples

use noodles_vcf::header::record::value::{map::Other, Map};
let map = Map::<Other>::new();

impl<I> Map<I>where I: Inner,

pub fn builder() -> Builder<I>

Creates a VCF header map value builder.

pub fn other_fields(&self) -> &IndexMap<Other<I::StandardTag>, String>

Returns the nonstandard fields in the map.

impl<I> Map<I>where I: Typed,

pub fn number(&self) -> Number

Returns the cardinality of the field value.

pub fn number_mut(&mut self) -> &mut Number

Returns a mutable reference to the number.

pub fn ty(&self) -> I::Type

Returns the type of the field value.

pub fn type_mut(&mut self) -> &mut I::Type

Returns a mutable reference to the type.

impl<I> Map<I>where I: Described,

pub fn description(&self) -> &str

Returns the description.

pub fn description_mut(&mut self) -> &mut String

Returns a mutable reference to the description.

impl<I> Map<I>where I: Indexed,

pub fn idx(&self) -> Option<usize>

Returns the index of the ID in the dictionary of strings.

pub fn idx_mut(&mut self) -> &mut Option<usize>

Returns a mutable reference to the index.

Trait Implementations

impl<I> Clone for Map<I>where I: Inner + Clone, I::StandardTag: Clone,

fn clone(&self) -> Map<I>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<I> Debug for Map<I>where I: Inner + Debug, I::StandardTag: Debug,

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

Formats the value using the given formatter.

impl<I> Default for Map<I>where I: Inner + Default,

fn default() -> Self

Returns the “default value” for a type.

impl Display for Map<AlternativeAllele>

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

Formats the value using the given formatter.

impl Display for Map<Contig>

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

Formats the value using the given formatter.

impl Display for Map<Filter>

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

Formats the value using the given formatter.

impl Display for Map<Format>

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

Formats the value using the given formatter.

impl Display for Map<Info>

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

Formats the value using the given formatter.

impl Display for Map<Meta>

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

Formats the value using the given formatter.

impl Display for Map<Other>

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

Formats the value using the given formatter.

impl From<&Key> for Map<Format>

fn from(key: &Key) -> Self

Converts to this type from the input type.

impl From<&Key> for Map<Info>

fn from(key: &Key) -> Self

Converts to this type from the input type.

impl From<(FileFormat, &Key)> for Map<Format>

fn from((file_format, key): (FileFormat, &Key)) -> Self

Converts to this type from the input type.

impl From<(FileFormat, &Key)> for Map<Info>

fn from((file_format, key): (FileFormat, &Key)) -> Self

Converts to this type from the input type.

impl<I> PartialEq<Map<I>> for Map<I>where I: Inner + PartialEq, I::StandardTag: PartialEq,

fn eq(&self, other: &Map<I>) -> 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 TryFrom<(FileFormat, Vec<(String, String), Global>)> for Map<Format>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( (_, fields): (FileFormat, Vec<(String, String)>) ) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<(FileFormat, Vec<(String, String), Global>)> for Map<Info>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( (_, fields): (FileFormat, Vec<(String, String)>) ) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Vec<(String, String), Global>> for Map<AlternativeAllele>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(fields: Vec<(String, String)>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Vec<(String, String), Global>> for Map<Contig>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(fields: Vec<(String, String)>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Vec<(String, String), Global>> for Map<Filter>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(fields: Vec<(String, String)>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Vec<(String, String), Global>> for Map<Format>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(fields: Vec<(String, String)>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Vec<(String, String), Global>> for Map<Info>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(fields: Vec<(String, String)>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Vec<(String, String), Global>> for Map<Meta>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(fields: Vec<(String, String)>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Vec<(String, String), Global>> for Map<Other>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(fields: Vec<(String, String)>) -> Result<Self, Self::Error>

Performs the conversion.

impl<I> Eq for Map<I>where I: Inner + Eq, I::StandardTag: Eq,

impl<I> StructuralEq for Map<I>where I: Inner,

impl<I> StructuralPartialEq for Map<I>where I: Inner,