diff --git a/src/doc/reference.md b/src/doc/reference.md index 19cbd6f90a5..f9ffcc9eb28 100644 --- a/src/doc/reference.md +++ b/src/doc/reference.md @@ -2431,11 +2431,18 @@ Tuples are written by enclosing zero or more comma-separated expressions in parentheses. They are used to create [tuple-typed](#tuple-types) values. ```{.tuple} -(0,); (0.0, 4.5); ("a", 4usize, true); ``` +You can disambiguate a single-element tuple from a value in parentheses with a +comma: + +``` +(0,); // single-element tuple +(0); // zero in parentheses +``` + ### Unit expressions The expression `()` denotes the _unit value_, the only value of the type with diff --git a/src/doc/trpl/primitive-types.md b/src/doc/trpl/primitive-types.md index aca6e327c3b..e017e222c74 100644 --- a/src/doc/trpl/primitive-types.md +++ b/src/doc/trpl/primitive-types.md @@ -248,6 +248,14 @@ or “breaks up” the tuple, and assigns the bits to three bindings. This pattern is very powerful, and we’ll see it repeated more later. +You can disambiguate a single-element tuple from a value in parentheses with a +comma: + +``` +(0,); // single-element tuple +(0); // zero in parentheses +``` + ## Tuple Indexing You can also access fields of a tuple with indexing syntax: