feat: Add stdin.lock method prototype

Author: k-nasa

src/io/stdin.rs

@@ -1,3 +1,4 @@
+use lazy_static::lazy_static;
 use std::pin::Pin;
 use std::sync::Mutex;
 
@@ -7,6 +8,10 @@ use crate::future::{self, Future};
 use crate::io::{self, Read};
 use crate::task::{blocking, Context, Poll};
 
+lazy_static! {
+    static ref STDIN: std::io::Stdin = std::io::stdin();
+}
+
 /// Constructs a new handle to the standard input of the current process.
 ///
 /// This function is an async version of [`std::io::stdin`].
@@ -134,6 +139,29 @@ impl Stdin {
         })
         .await
     }
+
+    /// Reads a line of input into the specified buffer.
+    ///
+    /// # Examples
+    ///
+    /// ```no_run
+    /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
+    /// #
+    /// use async_std::io;
+    /// use std::io::Read;
+    ///
+    /// let mut buffer = String::new();
+    ///
+    /// let stdin = io::stdin();
+    /// let mut handle = stdin.lock().await;
+    ///
+    /// handle.read_to_string(&mut buffer)?;
+    /// #
+    /// # Ok(()) }) }
+    /// ```
+    pub async fn lock(&self) -> std::io::StdinLock<'static> {
+        STDIN.lock()
+    }
 }
 
 impl Read for Stdin {