Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add post for 1.77 #1271

Merged
merged 10 commits into from
Mar 21, 2024
124 changes: 124 additions & 0 deletions posts/2024-03-21-Rust-1.77.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,124 @@
---
layout: post
title: "Announcing Rust 1.77.0"
author: The Rust Release Team
release: true
---

The Rust team is happy to announce a new version of Rust, 1.77.0. Rust is a programming language empowering everyone to build reliable and efficient software.

If you have a previous version of Rust installed via `rustup`, you can get 1.77.0 with:

```console
$ rustup update stable
```

If you don't have it already, you can [get `rustup`](https://www.rust-lang.org/install.html) from the appropriate page on our website, and check out the [detailed release notes for 1.77.0](https://doc.rust-lang.org/nightly/releases.html#version-77-2024-03-21).

If you'd like to help us out by testing future releases, you might consider updating locally to use the beta channel (`rustup default beta`) or the nightly channel (`rustup default nightly`). Please [report](https://github.com/rust-lang/rust/issues/new/choose) any bugs you might come across!

## What's in 1.77.0 stable
Mark-Simulacrum marked this conversation as resolved.
Show resolved Hide resolved

This release is relatively minor, but as always, even incremental improvements lead to a greater whole. A few of those changes are highlighted in this post, and others may yet fill more niche needs.

### C-string literals

Rust now supports C-string literals (`c"abc"`) which expand to a nul-byte
terminated string in memory of type `&CStr`. This makes it easier to write code
Mark-Simulacrum marked this conversation as resolved.
Show resolved Hide resolved
interoperating with foreign language interfaces which require nul-terminated
strings, with all of the relevant error checking (e.g., lack of interior nul
byte) performed at compile time.

### Support for recursion in `async fn`

async functions previously could not call themselves due to a compiler analysis
limitation. In 1.77, that limitation has been lifted, so recursive calls are
Mark-Simulacrum marked this conversation as resolved.
Show resolved Hide resolved
permitted so long as they use some form of indirection to avoid an infinite
size for the state of the function.

This means that code like this now works:

```rust
async fn fib(n: u32) -> u32 {
match n {
0 | 1 => 1,
_ => Box::pin(fib(n-1)).await + Box::pin(fib(n-2)).await
}
}
```

### `offset_of!`

1.77.0 stabilizes [`offset_of!`] for struct fields, which provides access to the
byte offset of the relevant public field of a struct. This macro is most useful
when the offset of a field is required without an existing instance of a type.
Implementing such a macro is already possible on stable, but without an
instance of the type the implementation would require tricky unsafe code which
makes it easy to accidentally introduce undefined behavior.

Users can now access the offset of a public field with `offset_of!(StructName,
field)`. This expands to a `usize` expression with the offset in bytes from the
start of the struct.

[`offset_of!`]: https://doc.rust-lang.org/stable/std/mem/macro.offset_of.html

### Enable strip in release profiles by default

Cargo [profiles](https://doc.rust-lang.org/stable/cargo/reference/profiles.html)
which do not enable [debuginfo](https://doc.rust-lang.org/stable/cargo/reference/profiles.html#debug) in
outputs (e.g., `debug = 0`) will enable `strip = "debuginfo"` by default.

This is primarily needed because the (precompiled) standard library ships with
debuginfo, which means that statically linked results would include the
debuginfo from the standard library even if the local compilations didn't
explicitly request debuginfo.

Users which do want debuginfo can explicitly enable it with the
[debug](https://doc.rust-lang.org/stable/cargo/reference/profiles.html#debug)
flag in the relevant Cargo profile.

### Clippy adds a new `incompatible_msrv` lint

The Rust project only supports the latest stable release of Rust. Some
libraries aim to have an older minimum supported Rust version (MSRV), typically
verifying this support by compiling in CI with an older release. However, when
developing new code, it's convenient to use latest documentation and the latest
toolchain with fixed bugs, performance improvements, and other improvements.
This can make it easy to accidentally start using an API that's only available
on newer versions of Rust.

Clippy has added a new lint, [`incompatible_msrv`](https://rust-lang.github.io/rust-clippy/master/index.html#/incompatible_msrv),
which will inform users if functionality being referenced is only available on
newer versions than their
[declared MSRV](https://github.com/rust-lang/rust-clippy/?tab=readme-ov-file#specifying-the-minimum-supported-rust-version).

### Stabilized APIs

- [`array::each_ref`](https://doc.rust-lang.org/stable/std/primitive.array.html#method.each_ref)
- [`array::each_mut`](https://doc.rust-lang.org/stable/std/primitive.array.html#method.each_mut)
- [`core::net`](https://doc.rust-lang.org/stable/core/net/index.html)
- [`f32::round_ties_even`](https://doc.rust-lang.org/stable/std/primitive.f32.html#method.round_ties_even)
- [`f64::round_ties_even`](https://doc.rust-lang.org/stable/std/primitive.f64.html#method.round_ties_even)
- [`mem::offset_of!`](https://doc.rust-lang.org/stable/std/mem/macro.offset_of.html)
- [`slice::first_chunk`](https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first_chunk)
- [`slice::first_chunk_mut`](https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first_chunk_mut)
- [`slice::split_first_chunk`](https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first_chunk)
- [`slice::split_first_chunk_mut`](https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first_chunk_mut)
- [`slice::last_chunk`](https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last_chunk)
- [`slice::last_chunk_mut`](https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last_chunk_mut)
- [`slice::split_last_chunk`](https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last_chunk)
- [`slice::split_last_chunk_mut`](https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last_chunk_mut)
- [`slice::chunk_by`](https://doc.rust-lang.org/stable/std/primitive.slice.html#method.chunk_by)
Mark-Simulacrum marked this conversation as resolved.
Show resolved Hide resolved
- [`slice::chunk_by_mut`](https://doc.rust-lang.org/stable/std/primitive.slice.html#method.chunk_by_mut)
Mark-Simulacrum marked this conversation as resolved.
Show resolved Hide resolved
- [`Bound::map`](https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.map)
- [`File::create_new`](https://doc.rust-lang.org/stable/std/fs/struct.File.html#method.create_new)
- [`Mutex::clear_poison`](https://doc.rust-lang.org/stable/std/sync/struct.Mutex.html#method.clear_poison)
- [`RwLock::clear_poison`](https://doc.rust-lang.org/stable/std/sync/struct.RwLock.html#method.clear_poison)

### Other changes

Check out everything that changed in [Rust](https://github.com/rust-lang/rust/releases/tag/1.77.0), [Cargo](https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-177-2024-03-21), and [Clippy](https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-177).

## Contributors to 1.77.0

Many people came together to create Rust 1.77.0. We couldn't have done it without all of you. [Thanks!](https://thanks.rust-lang.org/rust/1.77.0/)