Struct i8583::packer::Packer

pub struct Packer<'a> { /* fields omitted */ }

i8583::Packer type and associated functions for creating iso8583 messages.

Examples

use i8583::Packer;

let mut iso_packer = Packer::new(&i8583::nibss::SPEC);

let pan = String::from("5432101234567898");

if let Err(msg) = iso_packer.set_field(0, "0200".as_bytes().into()) {
    eprintln!("{}", msg);
    return;
}

if let Err(msg) = iso_packer.set_field(2, pan.into_bytes().into()) {
    eprintln!("{}", msg);
    return;
}

let iso = match iso_packer.pack(Vec::with_capacity(1024)) {
    Ok(iso) => iso,
    Err(msg) => {
        eprintln!("{}", msg);
        return;
    }
};
let iso = String::from_utf8(iso).unwrap();
println!("{}", iso);

Implementations

impl<'a> Packer<'a>

pub fn new(spec: &'a [Option<Spec>; 129]) -> Packer

Create a new packer with the given iso specification. The provided spec will be used to validate set_field inputs

pub fn toggle_bit_64(&mut self, val: bool)

Manually set bit 64 to on or off.

Rationale

Message authentication codes (MAC) can only be generated after obtaining a full iso 8583 message, this function provides a way to indicate the presence of a MAC in the bitmap while defering the computation and addition of the actual message authentication code.

Warning

Do not set both toggle_bit_64 and toggle_bit_128 to on.

Use of this function to set bit 64 to on will render pack output bitmap incorrect, a MAC must be appended to re-establish correctness.

pub fn toggle_bit_128(&mut self, val: bool)

Manually set bit 128 to on or off.

Rationale

Message authentication codes (MAC) can only be generated after obtaining a full iso 8583 message, this function provides a way to indicate the presence of a MAC in the bitmap while defering the computation and addition of the actual message authentication code.

Warning

Do not set both toggle_bit_64 and toggle_bit_128 to on.

Use of this function to set bit 128 to on will render pack output bitmap incorrect, a MAC must be appended to re-establish correctness.

pub fn set_field(
    &mut self,
    field: usize,
    val: Cow<'a, [u8]>
) -> Result<(), String>

Set val for field in iso message. This will replace existing value if previously set

Errors

Will fail if specification is not found for field or val size is invalid

pub fn unset_field(&mut self, field: usize)

Unset val for field in iso message.

pub fn pack(&self, buffer: Vec<u8>) -> Result<Vec<u8>, &'static str>

Generate iso message. Call this function after setting all fields

Errors

Will fail if MTI(field 0) is not set