Struct Record 

pub struct Record { /* private fields */ }

A single contact record, composed of multiple data fields

Implementations

impl Record

pub fn new() -> Self

Create a new record.

use difa::Record;
let mut record = Record::new();
record.insert("call", "W1AW").unwrap();
record.insert("freq", "14.074").unwrap();
assert_eq!(record.get("call").unwrap().as_str(), "W1AW");

pub fn new_header() -> Self

Create a new header record.

use difa::Record;
let mut header = Record::new_header();
header.insert("adifver", "3.1.4").unwrap();
assert!(header.is_header());
assert_eq!(header.get("adifver").unwrap().as_str(), "3.1.4");

pub fn is_header(&self) -> bool

True if this record represents an ADIF header.

use difa::RecordStream;
use futures::StreamExt;
let mut s = RecordStream::new(
    "<adifver:5>3.1.4<eoh><call:4>W1AW<eor>".as_bytes(),
    true,
);
let header = s.next().await.unwrap().unwrap();
assert!(header.is_header());
let record = s.next().await.unwrap().unwrap();
assert!(!record.is_header());

pub fn get(&self, name: &str) -> Option<&Datum>

Return the value of the requested field.

use difa::RecordStream;
use futures::StreamExt;
let mut s = RecordStream::new(
    "<call:4>W1AW<freq:6>14.074<eor>".as_bytes(),
    true,
);
let record = s.next().await.unwrap().unwrap();
assert_eq!(record.get("call").unwrap().as_str(), "W1AW");
assert_eq!(record.get("freq").unwrap().as_str(), "14.074");
assert!(record.get("missing").is_none());

pub fn insert<N, V>(&mut self, name: N, value: V) -> Result<(), Error>

where N: Into<CiString>, V: Into<Datum>,

Add a field to the record.

Overwriting a previous value is not permitted and will return an error. Transformations can only add new keys, not delete or replace them.

Since colons cannot occur in tag names, a custom transformation may wish to convert tag “xxx” to “myapp:xxx”.

use difa::{Datum, RecordStream};
use futures::StreamExt;
let mut s = RecordStream::new("<call:4>W1AW<eor>".as_bytes(), true);
let mut record = s.next().await.unwrap().unwrap();
record
    .insert("band".to_string(), Datum::String("20M".to_string()))
    .unwrap();
assert_eq!(record.get("band").unwrap().as_str(), "20M");
let err = record
    .insert("call".to_string(), Datum::String("AB9BH".to_string()));
assert!(err.is_err());

pub fn into_fields(self) -> impl Iterator<Item = (String, Datum)>

Consume the record and return an iterator over owned fields.

pub fn fields(&self) -> impl Iterator<Item = (&str, &Datum)>

Return an iterator over all fields in this record.

Trait Implementations

impl Clone for Record

fn clone(&self) -> Record

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Record

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

Formats the value using the given formatter.

impl Default for Record

fn default() -> Record

Returns the “default value” for a type.

impl PartialEq for Record

fn eq(&self, other: &Record) -> 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<W> Sink<Record> for CabrilloSink<W>

where W: AsyncWrite + Unpin,

type Error = Error

The type of value produced by the sink when an error occurs.

fn poll_ready( self: Pin<&mut Self>, cx: &mut Context<'_>, ) -> Poll<Result<(), Error>>

Attempts to prepare the Sink to receive a value.

fn start_send(self: Pin<&mut Self>, r: Record) -> Result<(), Error>

Begin the process of sending a value to the sink. Each call to this function must be preceded by a successful call to poll_ready which returned Poll::Ready(Ok(())).

fn poll_flush( self: Pin<&mut Self>, cx: &mut Context<'_>, ) -> Poll<Result<(), Error>>

Flush any remaining output from this sink.

fn poll_close( self: Pin<&mut Self>, cx: &mut Context<'_>, ) -> Poll<Result<(), Error>>

Flush any remaining output and close this sink, if necessary.

impl<W> Sink<Record> for RecordSink<W>

where W: AsyncWrite + Unpin,

type Error = Error

The type of value produced by the sink when an error occurs.

fn poll_ready( self: Pin<&mut Self>, cx: &mut Context<'_>, ) -> Poll<Result<(), Self::Error>>

Attempts to prepare the Sink to receive a value.

fn start_send(self: Pin<&mut Self>, item: Record) -> Result<(), Self::Error>

Begin the process of sending a value to the sink. Each call to this function must be preceded by a successful call to poll_ready which returned Poll::Ready(Ok(())).

fn poll_flush( self: Pin<&mut Self>, cx: &mut Context<'_>, ) -> Poll<Result<(), Self::Error>>

Flush any remaining output from this sink.

fn poll_close( self: Pin<&mut Self>, cx: &mut Context<'_>, ) -> Poll<Result<(), Self::Error>>

Flush any remaining output and close this sink, if necessary.

impl Eq for Record

impl StructuralPartialEq for Record