Struct marc::record::Field

pub struct Field { /* private fields */ }

A MARC Data Field with tag, indicators, and subfields.

Implementations

impl Field

pub fn to_breaker(&self) -> String

impl Field

pub fn new(tag: impl Into<String>) -> Result<Self, String>

Create a Field with the provided tag.

• tag - Must have the correct byte count.

Examples

use marc::record::Field;

let field: Field = match Field::new("245") {
  Ok(f) => f,
  Err(e) => panic!("Field::new() failed with: {}", e),
};
assert_eq!(field.tag(), "245");
assert_eq!(field.ind1(), " ");
assert_eq!(field.ind2(), " ");
assert_eq!(field.subfields().len(), 0);

pub fn tag(&self) -> &str

Get the tag

pub fn ind1(&self) -> &str

Get the value of indicator-1, defaulting to DEFAULT_INDICATOR.

pub fn ind2(&self) -> &str

Get the value of indicator-2, defaulting to DEFAULT_INDICATOR.

pub fn subfields(&self) -> &Vec<Subfield>

Get the full list of subfields

pub fn subfields_mut(&mut self) -> &mut Vec<Subfield>

Get a mutable list of subfields.

pub fn set_ind1(&mut self, ind: impl Into<String>) -> Result<(), String>

Set the indicator-1 value.

• ind - Must have the correct byte count.

pub fn set_ind2(&mut self, ind: impl Into<String>) -> Result<(), String>

Set the indicator-2 value.

• ind - Must have the correct byte count.

pub fn get_subfields(&self, code: &str) -> Vec<&Subfield>

Get a list of subfields with the provided code.

pub fn first_subfield(&self, code: &str) -> Option<&Subfield>

pub fn has_subfield(&self, code: &str) -> bool

pub fn get_subfields_mut(&mut self, code: &str) -> Vec<&mut Subfield>

Get a mutable list of subfields with the provided code.

pub fn add_subfield( &mut self, code: impl Into<String>, content: impl Into<String>, ) -> Result<(), String>

Adds a new Subfield to this field using the provided code and content.

• code - Must have the correct byte count.

pub fn remove_first_subfield(&mut self, code: &str) -> Option<Subfield>

Remove the first subfield with the specified code.

pub fn remove_subfields(&mut self, code: &str) -> usize

Remove all subfields with the specified code and returns the count of removed subfields.

Examples

use marc::record::Field;
let mut field = Field::new("505").unwrap();
let _ = field.add_subfield("t", "Chapter 1 /");
let _ = field.add_subfield("r", "Cool author --");
let _ = field.add_subfield("t", "Chapter 2.");
assert_eq!(field.subfields().len(), 3);

assert_eq!(field.remove_subfields("t"), 2);

assert_eq!(field.subfields().len(), 1);

Trait Implementations

impl Clone for Field

fn clone(&self) -> Field

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Field

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

Formats the value using the given formatter.

impl PartialEq for Field

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