Merge pull request #257 from rust-embedded/maybe_array

add maybe_array constructors

Author: Emilgardis

svd-rs/CHANGELOG.md

@@ -7,6 +7,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## Unreleased
 
+- add `maybe_array` constructors
 - Bump MSRV to 1.65.0
 - Bump `regex` to 1.10
 

svd-rs/src/cluster.rs

@@ -203,6 +203,14 @@ impl ClusterInfo {
     pub const fn array(self, dim: DimElement) -> Cluster {
         Cluster::Array(self, dim)
     }
+    /// Construct single [`Cluster`] or array
+    pub fn maybe_array(self, dim: Option<DimElement>) -> Cluster {
+        if let Some(dim) = dim {
+            self.array(dim)
+        } else {
+            self.single()
+        }
+    }
     /// Modify an existing [`ClusterInfo`] based on a [builder](ClusterInfoBuilder).
     pub fn modify_from(
         &mut self,

svd-rs/src/field.rs

@@ -248,6 +248,14 @@ impl FieldInfo {
     pub const fn array(self, dim: DimElement) -> Field {
         Field::Array(self, dim)
     }
+    /// Construct single [`Field`] or array
+    pub fn maybe_array(self, dim: Option<DimElement>) -> Field {
+        if let Some(dim) = dim {
+            self.array(dim)
+        } else {
+            self.single()
+        }
+    }
     /// Modify an existing [`FieldInfo`] based on a [builder](FieldInfoBuilder).
     pub fn modify_from(
         &mut self,

svd-rs/src/peripheral.rs

@@ -313,6 +313,14 @@ impl PeripheralInfo {
     pub const fn array(self, dim: DimElement) -> Peripheral {
         Peripheral::Array(self, dim)
     }
+    /// Construct single [`Peripheral`] or array
+    pub fn maybe_array(self, dim: Option<DimElement>) -> Peripheral {
+        if let Some(dim) = dim {
+            self.array(dim)
+        } else {
+            self.single()
+        }
+    }
     /// Modify an existing [`Peripheral`] based on a [builder](PeripheralInfoBuilder).
     pub fn modify_from(
         &mut self,

svd-rs/src/register.rs

@@ -288,6 +288,14 @@ impl RegisterInfo {
     pub const fn array(self, dim: DimElement) -> Register {
         Register::Array(self, dim)
     }
+    /// Construct single [`Register`] or array
+    pub fn maybe_array(self, dim: Option<DimElement>) -> Register {
+        if let Some(dim) = dim {
+            self.array(dim)
+        } else {
+            self.single()
+        }
+    }
     /// Modify an existing [`RegisterInfo`] based on a [builder](RegisterInfoBuilder).
     pub fn modify_from(
         &mut self,