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
93 changes: 93 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,93 @@
---
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:
Mark-Simulacrum marked this conversation as resolved.
Show resolved Hide resolved

```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
taking nul-terminated strings, with all of the relevant error checking (e.g.,
lack of interior nul byte) implemented within the compiler.
Mark-Simulacrum marked this conversation as resolved.
Show resolved Hide resolved

### `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 get into 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.

Note that the output of the macro is not typically stable across compiler
versions or across platforms. See the macro's documentation for details on when the output can be relied on.
Mark-Simulacrum marked this conversation as resolved.
Show resolved Hide resolved

[`offset_of!`]: https://doc.rust-lang.org/nightly/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 [debug info](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
debug info, which means that statically linked results would include the
debuginfo from the standard library even if the local compilations didn't
explicitly request debuginfo.
Mark-Simulacrum marked this conversation as resolved.
Show resolved Hide resolved

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.

### 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-02-08), and [Clippy](https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-177).
Mark-Simulacrum marked this conversation as resolved.
Show resolved Hide resolved

## 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/)