Struct iso7816_tlv::simple::Tlv

pub struct Tlv { /* private fields */ }

SIMPLE-TLV data object representation.

Each SIMPLE-TLV data object shall consist of two or three consecutive fields: a mandatory tag field, a mandatory length field and a conditional value field

Implementations

impl Tlv

pub fn new(tag: Tag, value: Value) -> Result<Self, TlvError>

Create a SIMPLE-TLV data object from valid tag and value. A value has a maximum size of 65_535 bytes.

Errors

Fails with TlvError::InvalidLength if value is longer than 65_535 bytes.

pub fn tag(&self) -> Tag

Get SIMPLE-TLV tag.

pub fn length(&self) -> usize

Get SIMPLE-TLV value length

pub fn value(&self) -> &[u8]

Get SIMPLE-TLV value

pub fn to_vec(&self) -> Vec<u8>

serializes self into a byte vector.

pub fn parse(input: &[u8]) -> (Result<Self, TlvError>, &[u8])

Parses a byte array into a SIMPLE-TLV structure. This also returns the unprocessed data.

Example (parse mulitple tlv in input)

use iso7816_tlv::simple::Tlv;
use hex_literal::hex;

let in_data = hex!(
  "03 01 01"
  "04 01 04"
  "07 07 85 66 C9 6A 14 49 04"
  "01 08 57 5F 93 6E 01 00 00 00"
  "09 01 00");
let mut buf: &[u8] = &in_data;
let mut parsed_manual = Vec::new();
while !buf.is_empty() {
  let (r, remaining) = Tlv::parse(buf);
  buf = remaining;
  if r.map(|res| parsed_manual.push(res)).is_err() {
      break;
  }
}

pub fn parse_all(input: &[u8]) -> Vec<Self>

Parses a byte array into a vector of SIMPLE-TLV.

Note

Errors are discarded and parsing stops at first error Prefer using the parse() method and iterate over returned processed data.

pub fn from_bytes(input: &[u8]) -> Result<Self, TlvError>

Parses a byte array into a SIMPLE-TLV structure. Input must exactly match a SIMPLE-TLV object.

Errors

Fails with TlvError::InvalidInput if input does not match a SIMPLE-TLV object.

Trait Implementations

impl Clone for Tlv

fn clone(&self) -> Tlv

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Tlv

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

Formats the value using the given formatter.

impl PartialEq for Tlv

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