Add try_clone() function for SerialPort.

CHANGELOG

@@ -1,3 +1,6 @@
+# Unreleased
+- [add][minor] Add `SerialPort::try_clone()`.
+
 # Version 0.2.14 - 2023-12-16
 - [fix][minor] Make `TryFromError` public.
 

src/serial_port.rs

@@ -80,6 +80,18 @@ impl SerialPort {
 		})
 	}
 
+	/// Try to clone the serial port handle.
+	///
+	/// The cloned object refers to the same serial port.
+	///
+	/// Mixing reads and writes on different handles to the same serial port from different threads may lead to unexpect results.
+	/// The data may end up interleaved in unpredictable ways.
+	pub fn try_clone(&self) -> std::io::Result<Self> {
+		Ok(Self {
+			inner: self.inner.try_clone()?,
+		})
+	}
+
 	/// Read bytes from the serial port.
 	///
 	/// This is identical to [`std::io::Read::read()`], except that this function takes a const reference `&self`.

src/sys/unix/mod.rs

@@ -120,6 +120,14 @@ impl SerialPort {
 		}
 	}
 
+	pub fn try_clone(&self) -> std::io::Result<Self> {
+		Ok(Self {
+			file: self.file.try_clone()?,
+			read_timeout_ms: self.read_timeout_ms,
+			write_timeout_ms: self.write_timeout_ms,
+		})
+	}
+
 	pub fn get_configuration(&self) -> std::io::Result<Settings> {
 		Settings::get_from_file(&self.file)
 	}

src/sys/windows/mod.rs

@@ -54,6 +54,12 @@ impl SerialPort {
 		Self { file }
 	}
 
+	pub fn try_clone(&self) -> std::io::Result<Self> {
+		Ok(Self {
+			file: self.file.try_clone()?,
+		})
+	}
+
 	pub fn get_configuration(&self) -> std::io::Result<Settings> {
 		unsafe {
 			let mut dcb: winbase::DCB = std::mem::zeroed();