Skip to content

Commit

Permalink
Clarify std::fmt width docs w.r.t. dollar syntax and give example.
Browse files Browse the repository at this point in the history
  • Loading branch information
birkenfeld committed Apr 28, 2016
1 parent 4751e45 commit 815987b
Showing 1 changed file with 13 additions and 2 deletions.
15 changes: 13 additions & 2 deletions src/libcollections/fmt.rs
Original file line number Diff line number Diff line change
Expand Up @@ -395,8 +395,19 @@
//! `0`.
//!
//! The value for the width can also be provided as a `usize` in the list of
//! parameters by using the `2$` syntax indicating that the second argument is a
//! `usize` specifying the width.
//! parameters by using the dollar syntax indicating that the second argument is
//! a `usize` specifying the width, for example:
//!
//! ```
//! // All of these print "Hello x !"
//! println!("Hello {:5}!", "x");
//! println!("Hello {:1$}!", "x", 5);
//! println!("Hello {1:0$}!", 5, "x");
//! ```
//!
//! Referring to an argument with the dollar syntax does not affect the "next
//! argument" counter, so it's usually a good idea to refer to all arguments by
//! their position explicitly.
//!
//! ## Precision
//!
Expand Down

0 comments on commit 815987b

Please sign in to comment.