Enum Key 

pub enum Key {
    Name(String),
    Occurrence(String, usize),
}

Selects a record by keyword.

A bare name is strict: get/set/remove error with FitsError::AmbiguousKeyword if the keyword is duplicated. The (name, occurrence) form targets exactly one record (0-based).

Examples

let mut h = Header::new();
h.append("GAIN", 100).unwrap();
h.append("GAIN", 200).unwrap();

assert!(h.get::<i64>("GAIN").is_err()); // ambiguous bare name
assert_eq!(h.get::<i64>(("GAIN", 1)).unwrap(), Some(200)); // explicit occurrence

Variants

Name(String)

The sole occurrence of a keyword (strict).

Occurrence(String, usize)

The n-th (0-based) occurrence of a keyword.

Implementations

impl Key

pub fn name(&self) -> &str

The keyword this key refers to.

Examples

let bare: Key = "GAIN".into();
let occ: Key = ("GAIN", 1).into();
assert_eq!(bare.name(), "GAIN");
assert_eq!(occ.name(), "GAIN");

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

The selected occurrence index, if any.

Examples

let bare: Key = "GAIN".into();
let occ: Key = ("GAIN", 1).into();
assert_eq!(bare.occurrence(), None);
assert_eq!(occ.occurrence(), Some(1));

Trait Implementations

impl Clone for Key

fn clone(&self) -> Key

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Key

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

Formats the value using the given formatter.

impl Eq for Key

impl From<&String> for Key

fn from(name: &String) -> Self

Converts to this type from the input type.

impl From<&str> for Key

fn from(name: &str) -> Self

Converts to this type from the input type.

impl From<(&str, usize)> for Key

fn from((name, n): (&str, usize)) -> Self

Converts to this type from the input type.

impl From<(String, usize)> for Key

fn from((name, n): (String, usize)) -> Self

Converts to this type from the input type.

impl From<String> for Key

fn from(name: String) -> Self

Converts to this type from the input type.

impl PartialEq for Key

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Key