nordic-dev.net/rust
nordic-dev.net/rust
2
0
Fork 0
mirror of https://github.com/rust-lang/rust.git synced 2025-05-14 02:49:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

Auto merge of #87820 - elichai:patch-2, r=kennytm

Browse Source 
Replace read_to_string with read_line in Stdin example

The current example results in infinitely reading from stdin, which can confuse newcomers trying to read from stdin.
(`@razmag` encountered this while learning the language from the docs)
This commit is contained in:
bors 2021-08-09 08:19:19 +00:00
commit eaf6f46359
1 changed files with 14 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
library/std/src/io/stdio.rs
View File

@ -216,12 +216,12 @@ fn handle_ebadf<T>(r: io::Result<T>, default: T) -> io::Result<T> {
/// # Examples
///
/// ```no_run
/// use std::io::{self, Read};
/// use std::io;
///
/// fn main() -> io::Result<()> {
/// let mut buffer = String::new();
/// let mut stdin = io::stdin(); // We get `Stdin` here.
/// stdin.read_to_string(&mut buffer)?;
/// stdin.read_line(&mut buffer)?;
/// Ok(())
/// }
/// ```
@ -244,14 +244,14 @@ pub struct Stdin {
/// # Examples
///
/// ```no_run
/// use std::io::{self, Read};
/// use std::io::{self, BufRead};
///
/// fn main() -> io::Result<()> {
/// let mut buffer = String::new();
/// let stdin = io::stdin(); // We get `Stdin` here.
/// {
/// let mut handle = stdin.lock(); // We get `StdinLock` here.
/// handle.read_to_string(&mut buffer)?;
/// handle.read_line(&mut buffer)?;
/// } // `StdinLock` is dropped here.
/// Ok(())
/// }
@ -277,11 +277,11 @@ pub struct StdinLock<'a> {
/// Using implicit synchronization:
///
/// ```no_run
/// use std::io::{self, Read};
/// use std::io;
///
/// fn main() -> io::Result<()> {
/// let mut buffer = String::new();
/// io::stdin().read_to_string(&mut buffer)?;
/// io::stdin().read_line(&mut buffer)?;
/// Ok(())
/// }
/// ```
@ -289,14 +289,14 @@ pub struct StdinLock<'a> {
/// Using explicit synchronization:
///
/// ```no_run
/// use std::io::{self, Read};
/// use std::io::{self, BufRead};
///
/// fn main() -> io::Result<()> {
/// let mut buffer = String::new();
/// let stdin = io::stdin();
/// let mut handle = stdin.lock();
///
/// handle.read_to_string(&mut buffer)?;
/// handle.read_line(&mut buffer)?;
/// Ok(())
/// }
/// ```
@ -337,13 +337,13 @@ pub fn stdin() -> Stdin {
///
/// ```no_run
/// #![feature(stdio_locked)]
/// use std::io::{self, Read};
/// use std::io::{self, BufRead};
///
/// fn main() -> io::Result<()> {
/// let mut buffer = String::new();
/// let mut handle = io::stdin_locked();
///
/// handle.read_to_string(&mut buffer)?;
/// handle.read_line(&mut buffer)?;
/// Ok(())
/// }
/// ```
@ -363,14 +363,14 @@ impl Stdin {
/// # Examples
///
/// ```no_run
/// use std::io::{self, Read};
/// use std::io::{self, BufRead};
///
/// fn main() -> io::Result<()> {
/// let mut buffer = String::new();
/// let stdin = io::stdin();
/// let mut handle = stdin.lock();
///
/// handle.read_to_string(&mut buffer)?;
/// handle.read_line(&mut buffer)?;
/// Ok(())
/// }
/// ```
@ -432,13 +432,13 @@ impl Stdin {
///
/// ```no_run
/// #![feature(stdio_locked)]
/// use std::io::{self, Read};
/// use std::io::{self, BufRead};
///
/// fn main() -> io::Result<()> {
/// let mut buffer = String::new();
/// let mut handle = io::stdin().into_locked();
///
/// handle.read_to_string(&mut buffer)?;
/// handle.read_line(&mut buffer)?;
/// Ok(())
/// }
/// ```