rust-lang / rust-lang/rust

std-Vec docs: "slices are read-only objects"

Open
#143,889 6 comments 0 reactions 1 assignee View on GitHub

@JasonHonKL is already working on this.

Since Jul 13, 2025.

A-docs T-libs
Dominant language
Rust
Stars
119k
Forks
16.1k
PR merge metrics
PR metrics pending

Description

Location

https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#slicing

Summary

A Vec can be mutable. On the other hand, slices are read-only objects. To get a slice, use &.

I assume that &mut are slices as well (not just &[...]). Hence isn't that quote above inaccurate ? (see example below.)

#![allow(unused)]
fn main() {

    let mut v = vec![0, 1];

    let u: &mut [usize] = &mut v;
    u[0] = 42;
    println!("{v:?}");
}

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.