Commit 21dafd7a54f1b3233e0e73439daee82aa08d4900 | zig

author	Manlio Perillo <manlio.perillo@gmail.com> 2022-12-13 20:58:52+01:00
committer	GitHub <noreply@github.com> 2022-12-13 14:58:52-05:00
log	21dafd7a54f1b3233e0e73439daee82aa08d4900
tree	16a7199a0dd4c832ac907d488054b96639e6945f
parent	478544239e001eac5bd4840b3c36bc097b1c49ae
signature	Signed by PGP key 4AEE18F83AFDEB23

langref: update comments in the slices.zig doctest (#13819)

In the slices.zig doctest, the code
`const all_together_slice = all_together[0..]` is incorrect, since the
actual type is a pointer to an array, instead of a slice.

Use a runtime-known value to slice the array.

In the next "slice pointer" test, clarify that slicing a slice to
produce a pointer to an array, requires comptime-known indexes, not just
constant indexes.

1 files changed, 6 insertions(+), 3 deletions(-)

doc
- langref.html.in

doc/langref.html.in+6-3

 @@ -2975,8 +2975,10 @@ test "using slices for strings" {
     const world: []const u8 = "世界";
     var all_together: [100]u8 = undefined;
-    // You can use slice syntax on an array to convert an array into a slice.
+    // You can use slice syntax with at least one runtime-know index on an
-    const all_together_slice = all_together[0..];
+    // array to convert an array into a slice.
+    var start : usize = 0;
+    const all_together_slice = all_together[start..];
     // String concatenation example.
     const hello_world = try fmt.bufPrint(all_together_slice, "{s} {s}", .{ hello, world });
 @@ -3002,7 +3004,8 @@ test "slice pointer" {
     // The slice is mutable because we sliced a mutable pointer.
     try expect(@TypeOf(slice) == []u8);
-    // Again, slicing with constant indexes will produce another pointer to an array:
+    // Again, slicing with comptime-known indexes will produce another pointer
+    // to an array:
     const ptr2 = slice[2..3];
     try expect(ptr2.len == 1);
     try expect(ptr2[0] == 3);