Struct CommandBuilder

pub struct CommandBuilder<D> {
    pub p1: u8,
    pub p2: u8,
    /* private fields */
}

Fields

p1: u8

p2: u8

Implementations

impl<D: DataSource> CommandBuilder<D>

pub fn new( class: Class, instruction: Instruction, p1: u8, p2: u8, data: D, le: impl Into<ExpectedLen>, ) -> Self

Panics if data.len() > u16::MAX

Assumes that extended length is supported

pub fn force_extended(self) -> Self

Force the encoding of the APDU to be extended, even when the data and expected length are not neccessarily extended.

pub fn data(&self) -> D

where D: Copy,

pub fn required_len(&self) -> usize

Required length for serialization in only one command. Assumes extended length support

This can be useful to get the necessary dimension for the buffer to provide to serialize_into

pub fn serialize_into<W: Writer>(&self, writer: &mut W) -> Result<(), W::Error>

where D: DataStream<W>,

This assumes that the writer has enough space to encode the APDU. If that might not be the case, first use should_split

impl<'a> CommandBuilder<&'a [u8]>

pub fn new_non_extended( class: Class, instruction: Instruction, p1: u8, p2: u8, data: &'a [u8], le: u16, buffer_len: Option<usize>, ) -> ChainedCommandIterator<'a>

Panics if data.len() > u16::MAX

Assumes that extended length is supported

pub fn should_split(&self, available_len: usize) -> Option<(Self, Self)>

Given the available length and the extended length support, split the command in 2 commands that use command chaining to be sent

None means that the command can we serialized withinn available_len without needing Chaining Some(command, rem) means that command can be sent within available_len and that rem must then be sent (for command chaining). Note that should_split should also be called on rem as more than 2 commands might be required.

In certain conditions can panic if available_len <= 9 since 9 is the minimum length required to encode the header and trailer of a command.

Trait Implementations

impl<D: Clone> Clone for CommandBuilder<D>

fn clone(&self) -> CommandBuilder<D>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<D: DataSource> DataSource for CommandBuilder<D>

fn len(&self) -> usize

Length of the serialized data

fn is_empty(&self) -> bool

impl<W: Writer, D: DataStream<W>> DataStream<W> for CommandBuilder<D>

fn to_writer(&self, writer: &mut W) -> Result<(), <W as Writer>::Error>

Serialize the data to a writer.

impl<D: Debug> Debug for CommandBuilder<D>

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

Formats the value using the given formatter.

impl<'a, D: PartialEq<&'a [u8]>> PartialEq<CommandBuilder<D>> for CommandView<'a>

fn eq(&self, other: &CommandBuilder<D>) -> 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<'a, D: PartialEq<&'a [u8]>> PartialEq<CommandView<'a>> for CommandBuilder<D>

fn eq(&self, other: &CommandView<'a>) -> 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<D: PartialEq> PartialEq for CommandBuilder<D>

fn eq(&self, other: &CommandBuilder<D>) -> 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<D: Eq> Eq for CommandBuilder<D>

impl<D> StructuralPartialEq for CommandBuilder<D>