Struct pica_record::matcher::RecordMatcher

pub struct RecordMatcher(/* private fields */);

A matcher that matches against a RecordRef.

Implementations

impl RecordMatcher

pub fn new(matcher: &str) -> Result<Self, ParseMatcherError>

Creates a new RecordMatcher.

Errors

This function fails if the given expression is not a valid record matcher.

Example

use pica_record::matcher::RecordMatcher;

let _matcher = RecordMatcher::new("#003@ > 1")?;
let _matcher = RecordMatcher::new("010@.a == 'ger'")?;

pub fn is_match(&self, record: &RecordRef<'_>, options: &MatcherOptions) -> bool

Returns true if the given field(s) matches against the field matcher.

Example

use pica_record::matcher::{MatcherOptions, RecordMatcher};
use pica_record::primitives::RecordRef;

let record = RecordRef::new(vec![
    ("003@", None, vec![('0', "123456789X")]),
    ("002@", None, vec![('0', "Tp1")]),
])?;

let options = MatcherOptions::default();
let matcher = RecordMatcher::new("002@.0 == 'Tp1'")?;
assert!(matcher.is_match(&record, &options));

Trait Implementations

impl BitAnd for RecordMatcher

fn bitand(self, rhs: Self) -> Self::Output

The bitwise AND operator & of two RecordMatcher.

Example

use pica_record::prelude::*;
use pica_record::primitives::RecordRef;

let options = MatcherOptions::default();
let record = RecordRef::new(vec![
    ("003@", None, vec![('0', "123456789X")]),
    ("002@", None, vec![('0', "Tp1")]),
])?;

let lhs = RecordMatcher::new("003@.0 == '123456789X'")?;
let rhs = RecordMatcher::new("002@.0 == 'Tp1'")?;
let matcher = lhs & rhs;

assert!(matcher.is_match(&record, &options));

type Output = RecordMatcher

The resulting type after applying the & operator.

impl BitAndAssign for RecordMatcher

fn bitand_assign(&mut self, rhs: Self)

The bitwise AND assignment operator &= of two RecordMatcher.

Example

use pica_record::prelude::*;
use pica_record::primitives::RecordRef;

let options = MatcherOptions::default();
let record = RecordRef::new(vec![
    ("003@", None, vec![('0', "123456789X")]),
    ("002@", None, vec![('0', "Tp1")]),
])?;

let mut matcher = RecordMatcher::new("003@.0 == '123456789X'")?;
matcher &= RecordMatcher::new("002@.0 == 'Tp1'")?;
assert!(matcher.is_match(&record, &options));

impl BitOr for RecordMatcher

fn bitor(self, rhs: Self) -> Self::Output

The bitwise OR operator | of two RecordMatcher.

Example

use pica_record::prelude::*;
use pica_record::primitives::RecordRef;

let options = MatcherOptions::default();
let record = RecordRef::new(vec![
    ("003@", None, vec![('0', "123456789X")]),
    ("002@", None, vec![('0', "Tp1")]),
])?;

let lhs = RecordMatcher::new("003@.0 == '234567890X'")?;
let rhs = RecordMatcher::new("002@.0 == 'Tp1'")?;
let matcher = lhs | rhs;

assert!(matcher.is_match(&record, &options));

type Output = RecordMatcher

The resulting type after applying the | operator.

impl BitOrAssign for RecordMatcher

fn bitor_assign(&mut self, rhs: Self)

The bitwise OR assignment operator |= of two RecordMatcher.

Example

use pica_record::prelude::*;
use pica_record::primitives::RecordRef;

let options = MatcherOptions::default();
let record = RecordRef::new(vec![
    ("003@", None, vec![('0', "123456789X")]),
    ("002@", None, vec![('0', "Tp1")]),
])?;

let mut matcher = RecordMatcher::new("003@.0 == '234567891X'")?;
matcher |= RecordMatcher::new("002@.0 == 'Tp1'")?;
assert!(matcher.is_match(&record, &options));

impl BitXor for RecordMatcher

fn bitxor(self, rhs: Self) -> Self::Output

The bitwise XOR operator ^ of two RecordMatcher.

Example

use pica_record::prelude::*;
use pica_record::primitives::RecordRef;

let options = MatcherOptions::default();
let record = RecordRef::new(vec![
    ("003@", None, vec![('0', "123456789X")]),
    ("002@", None, vec![('0', "Tp1")]),
])?;

let lhs = RecordMatcher::new("003@.0 == '123456789X'")?;
let rhs = RecordMatcher::new("002@.0 == 'Tp2'")?;
let matcher = lhs ^ rhs;

assert!(matcher.is_match(&record, &options));

type Output = RecordMatcher

The resulting type after applying the ^ operator.

impl BitXorAssign for RecordMatcher

fn bitxor_assign(&mut self, rhs: Self)

The bitwise XOR assignment operator ^= of two RecordMatcher.

Example

use pica_record::prelude::*;
use pica_record::primitives::RecordRef;

let options = MatcherOptions::default();
let record = RecordRef::new(vec![
    ("003@", None, vec![('0', "123456789X")]),
    ("002@", None, vec![('0', "Tp1")]),
])?;

let mut matcher = RecordMatcher::new("003@.0 == '123456789X'")?;
matcher ^= RecordMatcher::new("002@.0 == 'Tp2'")?;
assert!(matcher.is_match(&record, &options));

impl Clone for RecordMatcher

fn clone(&self) -> RecordMatcher

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RecordMatcher

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

Formats the value using the given formatter.

impl Display for RecordMatcher

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

Formats a RecordMatcher as a human-readable string.

Example

use pica_record::matcher::RecordMatcher;

let matcher = RecordMatcher::new("002@.0 == 'Tp1'")?;
assert_eq!(matcher.to_string(), "002@.0 == 'Tp1'");

impl Not for RecordMatcher

fn not(self) -> Self::Output

The unary logical negation operator ! applied to a RecordMatcher.

Example

use pica_record::prelude::*;
use pica_record::primitives::RecordRef;

let options = MatcherOptions::default();
let record = RecordRef::new(vec![
    ("003@", None, vec![('0', "123456789X")]),
    ("002@", None, vec![('0', "Tp1")]),
])?;

let matcher = !RecordMatcher::new("002@.0 == 'Tp2'")?;
assert!(matcher.is_match(&record, &options));

type Output = RecordMatcher

The resulting type after applying the ! operator.

impl PartialEq for RecordMatcher

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