mqi 0.3.0

Idiomatic IBM® MQ Interface (MQI) and MQ Administration Interface (MQAI) APIs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

use crate::{encoding, types};

#[derive(Clone, Copy, PartialEq, Eq, Hash, derive_more::From)]
#[repr(transparent)]
pub struct CCSID(pub types::MQLONG);

impl CCSID {
    #[must_use]
    pub fn name(self) -> Option<&'static str> {
        #[expect(clippy::cast_sign_loss)]
        encoding::ccsid_lookup(self.0 as u32).map(|(.., name)| *name)
    }

    #[must_use]
    pub fn is_ebcdic(self) -> Option<bool> {
        #[expect(clippy::cast_sign_loss)]
        encoding::ccsid_lookup(self.0 as u32).map(|(_, encoding, _)| *encoding == 1)
    }
}

impl AsRef<CCSID> for types::MQLONG {
    fn as_ref(&self) -> &CCSID {
        // SAFETY: CCSID is repr(transparent)
        unsafe { &*(std::ptr::from_ref(self).cast()) }
    }
}

impl AsMut<CCSID> for types::MQLONG {
    fn as_mut(&mut self) -> &mut CCSID {
        // SAFETY: CCSID is repr(transparent)
        unsafe { &mut *(std::ptr::from_mut(self).cast()) }
    }
}

impl std::fmt::Display for CCSID {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        write!(f, "{}", self.0)?;
        if let Some(name) = self.name() {
            write!(f, " ({name})")?;
        }
        Ok(())
    }
}

impl std::fmt::Debug for CCSID {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        #[expect(clippy::cast_sign_loss)]
        let encoding = encoding::ccsid_lookup(self.0 as u32);
        match encoding {
            Some(&(.., name)) => f.debug_tuple("CCSID").field(&format_args!("{}: {name}", self.0)).finish(),
            None => f.debug_tuple("CCSID").field(&format_args!("{}", self.0)).finish(),
        }
    }
}

impl Default for CCSID {
    fn default() -> Self {
        Self(libmqm_sys::MQCCSI_UNDEFINED)
    }
}

impl PartialEq<types::MQLONG> for CCSID {
    fn eq(&self, other: &types::MQLONG) -> bool {
        self.0 == *other
    }
}

#[cfg(test)]
#[cfg_attr(coverage_nightly, coverage(off))]
mod test {
    use std::convert::identity;

    use super::*;

    #[test]
    fn ccsid() {
        assert_eq!(format!("{:?}", CCSID(1208)), "CCSID(1208: UTF-8)");
        assert_eq!(format!("{}", CCSID(1208)), "1208 (UTF-8)");
        assert_eq!(format!("{}", CCSID(5050)), "5050 (EUC-JP)");
        assert!(CCSID(1208).is_ebcdic().is_some_and(|e| !e));
        assert!(CCSID(500).is_ebcdic().is_some_and(identity));
        assert!(CCSID(999).is_ebcdic().is_none());
        assert_eq!(format!("{}", CCSID(999)), "999");
        assert_eq!(format!("{:?}", CCSID(999)), "CCSID(999)");
    }
}