Struct EuropePmcId 

pub struct EuropePmcId {
    pub source: EuropePmcSource,
    pub id: String,
}

A fully-qualified Europe PMC record address: a (source, id) pair.

Fields

source: EuropePmcSource

The source database.

id: String

The record identifier within that source (e.g. a PMID for MED, or a PMCnnn id for PMC).

Implementations

impl EuropePmcId

pub fn new(source: EuropePmcSource, id: impl Into<String>) -> Self

Construct an address from an explicit source and id.

pub fn pmc(id: &str) -> Result<Self>

Construct a PMC-sourced address, normalizing the id to PMCnnn form.

Accepts ids with or without the PMC prefix.

Errors

Returns an error if the id is not a valid PMC id.

pub fn med(pmid: impl Into<String>) -> Self

Construct a MED-sourced (PubMed) address from a PMID.

pub fn resolve(id: &str, source: Option<&str>) -> Result<Self>

Resolve the (source, id) pair a caller addressed.

Europe PMC identifies every record by a source database plus an id, but requiring callers to spell both out for the common cases would be noise, so three forms are accepted:

• a fully-qualified "SOURCE/ID" string (e.g. "PPR/PPR123456"), which takes precedence over any source argument;
• an explicit source plus a bare id;
• a bare id alone — a PMC-prefixed id implies the PMC source, anything else is treated as a PubMed (MED) record.

Every language binding routes its own id arguments through this so the three forms mean the same thing on every surface.

Errors

Returns an error if the id is blank, or if a qualified or PMC-sourced id is malformed.

Examples

use pubmed_client::{EuropePmcId, EuropePmcSource};

// A bare PMC id implies the PMC source.
let id = EuropePmcId::resolve("PMC3258128", None)?;
assert_eq!(id.to_string(), "PMC/PMC3258128");

// A bare non-PMC id is treated as a PubMed record.
let id = EuropePmcId::resolve("33515491", None)?;
assert_eq!(id.to_string(), "MED/33515491");

// A qualified id wins over the source argument.
let id = EuropePmcId::resolve("PPR/PPR123456", Some("MED"))?;
assert_eq!(id.source, EuropePmcSource::Ppr);

Trait Implementations

impl Clone for EuropePmcId

fn clone(&self) -> EuropePmcId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EuropePmcId

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

Formats the value using the given formatter.

impl Display for EuropePmcId

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

Formats the value using the given formatter.

impl FromStr for EuropePmcId

fn from_str(s: &str) -> Result<Self>

Parse a "SOURCE/ID" string, e.g. "PMC/PMC3258128" or "MED/12345".

type Err = PubMedError

The associated error which can be returned from parsing.

impl Hash for EuropePmcId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for EuropePmcId

fn eq(&self, other: &EuropePmcId) -> 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 Eq for EuropePmcId

impl StructuralPartialEq for EuropePmcId