use crate::isa::Target;
#[derive(Clone, Copy, PartialEq, Eq, Debug, Hash)]
#[allow(dead_code)] pub(crate) enum EncForm {
T1,
T2,
T3,
T4,
}
impl From<&str> for EncForm {
fn from(s: &str) -> Self {
match s {
"T1" => EncForm::T1,
"T2" => EncForm::T2,
"T3" => EncForm::T3,
"T4" => EncForm::T4,
other => panic!(
"EncForm::from: unknown encoding string {other:?} — decoder \
grew a form the legality table does not know"
),
}
}
}
#[derive(Clone, Copy, PartialEq, Eq, Debug, Hash)]
#[non_exhaustive]
#[allow(dead_code)] pub(crate) enum OpExtra {
Plain,
}
pub(crate) fn defined_on(mnemonic: &str, form: EncForm, target: Target, extra: OpExtra) -> bool {
if target == Target::Union {
return true;
}
let _ = extra;
match (mnemonic, form) {
("sdiv" | "udiv", EncForm::T1) => {
!matches!(target, Target::V7A | Target::V7AR | Target::Thumb1)
}
_ => true,
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn union_is_permissive_for_every_mnemonic_and_form() {
for m in ["sdiv", "udiv", "push", "cmp", "bl", "bxns", "enterx"] {
for f in [EncForm::T1, EncForm::T2, EncForm::T3, EncForm::T4] {
assert!(
defined_on(m, f, Target::Union, OpExtra::Plain),
"Union must accept {m}/{f:?}"
);
}
}
}
#[test]
fn the_per_target_false_set_matches_the_0_14_0_pinned_literal() {
let cases: &[(Target, &[(&str, EncForm)])] = &[
(Target::Union, &[]),
(Target::V7M, &[]),
(Target::V7EM, &[]),
(Target::V7A, &[("sdiv", EncForm::T1), ("udiv", EncForm::T1)]),
(Target::V7R, &[]),
(
Target::V7AR,
&[("sdiv", EncForm::T1), ("udiv", EncForm::T1)],
),
(Target::V8M, &[]),
(Target::ThumbEE, &[]),
(
Target::Thumb1,
&[("sdiv", EncForm::T1), ("udiv", EncForm::T1)],
),
];
let universe: &[(&str, EncForm)] = &[("sdiv", EncForm::T1), ("udiv", EncForm::T1)];
for (target, expected_false) in cases {
for probe in universe {
let result = defined_on(probe.0, probe.1, *target, OpExtra::Plain);
let should_fail = expected_false.contains(probe);
assert_eq!(
result, !should_fail,
"defined_on({:?}, {:?}, {:?}) disagreed with pinned literal",
probe.0, probe.1, target
);
}
}
}
#[test]
fn every_target_variant_appears_in_the_pin_set() {
let all: &[Target] = &[
Target::Union,
Target::V7M,
Target::V7EM,
Target::V7A,
Target::V7R,
Target::V7AR,
Target::V8M,
Target::ThumbEE,
Target::Thumb1,
];
for t in all {
let _ = defined_on("push", EncForm::T1, *t, OpExtra::Plain);
}
}
#[test]
#[should_panic(expected = "decoder grew a form")]
fn encform_from_str_panics_on_unknown_form() {
let _ = EncForm::from("A1");
}
#[test]
fn encform_from_str_covers_every_known_form() {
assert_eq!(EncForm::from("T1"), EncForm::T1);
assert_eq!(EncForm::from("T2"), EncForm::T2);
assert_eq!(EncForm::from("T3"), EncForm::T3);
assert_eq!(EncForm::from("T4"), EncForm::T4);
}
}