`const` expression can borrow static items #1610

dingxiangfei2009 · 2024-09-11T13:04:53Z

Tracked by rust-lang/rust#119618

Stabilization report: rust-lang/rust#128183

This PR updates the documentation to mention that now static items can be used for borrowing, explicitly or implicitly, which permits general use of them in const context.

ehuss

Can you also update https://github.com/rust-lang/reference/blob/master/src/items/static-items.md which mentions this isn't possible?

I'm wondering if this might be confusion (and perhaps my understanding is missing) with regards to what counts as a borrow. IIUC, statics have an implied &, is that correct? For example, if you see const C: i32 = SOME_STATIC;, there's no obvious borrow there.

dingxiangfei2009 · 2024-09-11T17:34:14Z

@ehuss I updated the wording to include simply "use of statics".

I have updated static-items page as well with tweaks on wording.

traviscross · 2024-09-17T21:18:41Z

We probably want to update the constant-items page that currently says:

Constants may refer to the address of other constants...

Since it'd now make sense for that to also address the fact that constants may refer to statics with some limitations.

traviscross · 2024-09-17T21:24:59Z

Also in const_eval.md, where it says:

Paths to statics. These are only allowed within the initializer of a static.

...that seems to need to change also.

traviscross · 2024-09-17T21:27:56Z

More generally, it seems what we need to do here is to loosen the various places in the Reference that have these restrictions, and in loosening them, add the necessary caveats, e.g. with respect to Freeze as described in rust-lang/rust#128183.

RalfJung · 2024-09-21T21:12:50Z

For example, if you see const C: i32 = SOME_STATIC;, there's no obvious borrow there.

There's no borrow at all there, obvious or otherwise.

MIR happens to represent SOME_STATIC as a pointer, making this look like *SOME_STATIC_PTR -- so even there, there's no borrow. Also that is an implementation detail and should not affect the reference at all.

RalfJung · 2024-09-21T21:14:53Z

src/items/constant-items.md

+## Use and reference to `static` items
+
+When a constant item or constant block is defined, [`static` items] can be used, borrowed or taken address of.
+By extension, you are allowed to call methods that immutably borrows the `static` items as receivers.


Yeah this should definitely explain that it is not allowed to read from or write to any mutable static (static mut and static !Freeze).

Do we already have a link into the reference to explain the static !Freeze items? It makes sense to me to make a reference here.

Oh this is largely missing. I guess I have to expand this section in const_eval.md. I can do that.

RalfJung · 2024-09-21T21:15:13Z

Constants may refer to the address of other constants...

That's a somewhat nonsensical statement as constants are values, they don't have an address.

RalfJung · 2024-09-22T06:02:41Z

I opened #1624 to fix the part about "address of a constant".

dingxiangfei2009 · 2024-09-22T19:39:25Z

@rustbot ready

I sieved through the document and I believe these are the places where use of static is mentioned.
I managed to add some sort of document about Freeze without mentioning it, given that it is not stabilized. In case [RFC] core::marker::Freeze in bounds rfcs#3633 lands and stabilization of the trait actually happens, I will follow up with the edits.

ehuss

Is there anywhere that mentions the extern static restrictions mentioned in the stabilization report?

src/const_eval.md

dingxiangfei2009 · 2024-10-01T21:29:04Z

@ehuss I added a section on extern { static }.

ehuss · 2024-10-09T14:25:11Z

I pushed a commit to simplify things. After reading more carefully, I was feeling like this was duplicating content that is already specified in the const_eval chapter. I'm reluctant to duplicate things since it makes it more challenging to maintain. I'm also a little reluctant to add deeper "exploration" style content which is essentially restating other rules. There is more specific reasoning in the commit message. If you disagree or think there is something that is now not documented, please let me know!

I realize this removes a lot of content from this PR, and I apologize for that. I probably should have been paying more attention earlier on and provided some guidance.

As for having more examples that illustrate specific const-eval limitations, I expect those to be added later over time (perhaps through the test suite links).

@traviscross Would you be willing to give this a final look? I think this is ready to go from my perspective.

ehuss

Thanks! ❤️

RalfJung · 2024-10-09T14:32:49Z

src/items/static-items.md

-* The type must have the `Sync` trait bound to allow thread-safe access.
-* Constants cannot refer to statics.
+All access to a static is safe,
+provided that the type must have the `Sync` trait bound to allow thread-safe access.


This makes it sound like a !Sync static would be unsafe to access. But actually it's just rejected.

Thanks! I have rewritten this to use more direct language. I'm not sure why the original was written to say "it is safe to ...", since there isn't anything to imply that it was unsafe.

I fixed the wording, to mention that a type with !Sync is rejected.

I picked the changeset from @ehuss actually. I think those wordings are better.

RalfJung · 2024-10-09T14:38:24Z

src/const_eval.md

@@ -23,7 +23,8 @@ to be run.
 * [Const parameters].
 * [Paths] to [functions] and [constants].
  Recursively defining constants is not allowed.
-* Paths to [statics]. These are only allowed within the initializer of a static.
+* Paths to immutable [statics].
+    * Reads of [`extern` statics] are not allowed.


Reads from and writes to static mut and static with interior mutability are also not allowed.

And then there are restrictions on references that escape into the final value of the const/static. More precisely, this is about expressions that have been subject to lifetime extension in the top-level scope of a const/static initializer. Those references must also be of type &T and point to a value without an UnsafeCell.

And finally, specifically for const there also can't be any references to anything mutable in the final value.

Hm, I'm trying to unpack what you are saying here and align that with the current rules.

Reads from and writes to static mut …

Isn't this implied by the fact that you are not allowed to refer to static mut at all by the rule that says paths only to immutable statics are allowed?

Reads from and writes to [..] static with interior mutability are also not allowed.

Thanks, I have added that.

And then there are restrictions on references that escape into the final value of the const/static.

Isn't this specified in the later rule that limits borrows of UnsafeCell that are transient? (That was my reading of it, and why I didn't say it explicitly.)

And finally, specifically for const there also can't be any references to anything mutable in the final value.

Thanks, I have added that to the constant-items chapter.

I actually have found the points mentioned down in the list here, in a bullet point starting with All forms of [borrow]s, including raw borrows, with one limitation .... I think we have it covered.

Isn't this implied by the fact that you are not allowed to refer to static mut at all by the rule that says paths only to immutable statics are allowed?

That's not correct, referring to static mut is permitted.
https://play.rust-lang.org/?version=nightly&mode=debug&edition=2021&gist=7519fded08041a618e0b57c710ab6c25

Isn't this specified in the later rule that limits borrows of UnsafeCell that are transient? (That was my reading of it, and why I didn't say it explicitly.)

Ah right, I forgot that those are already documented.

That's not correct, referring to static mut is permitted.

OK, then I go back to my comment earlier about why the word "immutable" is being added here.

I would think this PR shouldn't add the word immutable, and the edit @dingxiangfei2009 just added about not being allowed to read or write from static mut should cover everything?

(Because as written now, it says you can only do paths to immutable statics, but that does not seem to be true based on the playground above.)

Yeah you are right, immutable should not be mentioned here.

ehuss

I think this should be the last edit, do you agree?

ehuss · 2024-10-10T01:48:24Z

src/const_eval.md

@@ -23,7 +23,10 @@ to be run.
 * [Const parameters].
 * [Paths] to [functions] and [constants].
  Recursively defining constants is not allowed.
-* Paths to [statics]. These are only allowed within the initializer of a static.
+* Paths to immutable [statics] with these exception with these restrictions.


Suggested change

* Paths to immutable [statics] with these exception with these restrictions.

* Paths to [statics] with the following restrictions:

RalfJung · 2024-10-10T06:02:02Z

src/const_eval.md

+* Paths to immutable [statics] with these exception with these restrictions.
+    * Reads out of and writes into [`extern` statics] are not allowed.
+    * Reads out of and writes into either a `static` with data equipped with interior mutability,
+      or a whole or parts of `static mut`, are not allowed.


I am confused by the wording here. Why does static mut emphasize this "whole or part of", but interior mutable static does not? The two are treated exactly the same so they should also be described the same.

The actual underlying check is simply "is this global mutable memory -- if yes, reject read", and "if this memory global -- if yes, reject write".

Is this code accepted?

static FOO: (u8, UnsafeCell<u8>) = (0, UnsafeCell::new(1)); const BAR: u8 = FOO.0;

Edit: Checked and indeed it is not. So yeah, the text shouldn't differ in wording between the two.

ehuss · 2024-10-25T15:01:45Z

@RalfJung How do you feel about the final wording here?

RalfJung · 2024-10-25T17:53:59Z

src/const_eval.md

@@ -42,7 +42,10 @@ r[const-eval.const-expr.path-item]
  Recursively defining constants is not allowed.

 r[const-eval.const-expr.path-static]
-* Paths to [statics]. These are only allowed within the initializer of a static.
+* Paths to [statics] with these restrictions and observations.
+    * In particular, reads and writes to any `static`, `static mut` or [`extern` statics] is not allowed.


Reads from immutable statics are allowed.

RalfJung · 2024-10-25T17:55:57Z

src/const_eval.md

+    * Immutable borrows and pointers into immutable part of a `static` are allowed and observes the same restriction
+      on all other forms of [borrow]s as mentioned below.


This doesn't quite parse for me. I'm also not sure what the point of this bullet is -- is there any reason to not just entirely remove it?

traviscross · 2024-11-05T23:07:20Z

src/const_eval.md

@@ -42,7 +42,8 @@ r[const-eval.const-expr.path-item]
  Recursively defining constants is not allowed.

 r[const-eval.const-expr.path-static]
-* Paths to [statics]. These are only allowed within the initializer of a static.
+* Paths to [statics] with these restrictions and observations.
+  * In particular, reads and writes to any `static mut` or [`extern` statics] is not allowed.


So over in #1657, there is proposed language:

Static initializers may refer to and even read from other statics.
When reading from mutable statics, they read the initial value of that static.

The language in this PR seems contradictory to the language in that one, no? Or is there a subtle distinction we're making? Do we need some carve-out here?

(We talked this through on the lang-docs call and couldn't immediately work it out.)

Yeah this already works on stable
https://play.rust-lang.org/?version=stable&mode=debug&edition=2021&gist=59b79563db4fe5d5df26ab3f27cd4f1c

@RalfJung Can you write down exactly what we should say here? It would be helpful since we don't know exactly what the rules are. From looking at the implementation, I'm guessing, is it the CanAccessMutGlobal setting, which appears to be set only when in a static initializer? Does this need to say that you cannot read from static mut unless inside a static initializer, and that you can never write to a static mut, and that reading and writing extern statics always disallowed?

Yes:

reads from mutable statics (static mut, and interior mutable static) are forbidden except when evaluating the initializer expression of a static/static mut (so to be clear, the read can be syntactically inside a const fn or not, what matters is the const context, i.e. whether this is computing the initial value of a static or not)

writes to mutable statics are forbidden everywhere

reads from and writes to extern static are forbidden everywhere

@dingxiangfei2009 could you update the text accordingly? This is about to hit stable, would be good to get at least the nightly reference updated properly.

I have updated the text just now, so that the cases for the two evaluation contexts are clearer.

RalfJung · 2024-11-21T19:24:58Z

src/items/constant-items.md

@@ -48,6 +48,8 @@ const BITS_N_STRINGS: BitsNStrings<'static> = BitsNStrings {
 };
 ```

+The final value of a `const` item cannot contain references to anything mutable.


This should probably get some r label.

Suggested change

The final value of a `const` item cannot contain references to anything mutable.

r[items.const.final-value-immutable]

The final value of a `const` item cannot contain references to anything mutable.

RalfJung · 2024-11-22T06:33:04Z

src/const_eval.md

@@ -42,7 +42,9 @@ r[const-eval.const-expr.path-item]
  Recursively defining constants is not allowed.

 r[const-eval.const-expr.path-static]
-* Paths to [statics]. These are only allowed within the initializer of a static.
+* Paths to [statics] with these restrictions and observations.
+  * If the evaluation is carried out in an initializer of a `const` item, or inside a `const` block, reads and writes to any `static mut` or [`extern` statics] are not allowed.


This is missing some things, like array lengths or enum discriminants. I wouldn't try to list them all. Instead, I would say "If the evaluation is not carried out in an initializer of a static item, ...".

Also, saying static mut is wrong since it fails to mention interior mutability. By summary carefully mentioned interior mutability. Please ensure your text matches my summary.

Suggested change

* If the evaluation is carried out in an initializer of a `const` item, or inside a `const` block, reads and writes to any `static mut` or [`extern` statics] are not allowed.

* If the evaluation is *not* carried out in an initializer of a `static` item, then reads and writes to any mutable `static` (`static mut` or `static` with an interior mutable type) or [`extern` statics] are not allowed.

Applied with edits. I am also reordering the bullets around.

RalfJung · 2024-11-22T06:34:18Z

src/const_eval.md

-* Paths to [statics]. These are only allowed within the initializer of a static.
+* Paths to [statics] with these restrictions and observations.
+  * If the evaluation is carried out in an initializer of a `const` item, or inside a `const` block, reads and writes to any `static mut` or [`extern` statics] are not allowed.
+  * If the evaluation is carried out in an initializer of a `static` item, reads into a `static`, or inside `unsafe` blocks reads into `static mut` are allowed. Reads and writes to `extern` statics are still not allowed.


Suggested change

* If the evaluation is carried out in an initializer of a `static` item, reads into a `static`, or inside `unsafe` blocks reads into `static mut` are allowed. Reads and writes to `extern` statics are still not allowed.

* If the evaluation is carried out in an initializer of a `static` item, then *writes* to a mutable `static` are not allowed, but reads are allowed. Reads and writes to `extern` statics are still not allowed.

ehuss · 2024-11-22T15:30:10Z

src/const_eval.md

+* Paths to [statics] with these restrictions and observations.
+  * Reads and writes to `extern` statics are not allowed in any constant evaluation context.
+  * If the evaluation is carried out in an initializer of a `static` item, then *writes* into mutable `static` are not allowed, such as `static mut`s and `static`s containing an interior-mutable type.
+  * If the evaluation is *not* carried out in an initializer of a `static` item, then reads and writes to any mutable `static`, such as `static mut`s and `static`s containing an interior-mutable type.


Something (a verb?) seems to have been lost in this sentence. Maybe this?

Suggested change

* If the evaluation is *not* carried out in an initializer of a `static` item, then reads and writes to any mutable `static`, such as `static mut`s and `static`s containing an interior-mutable type.

* If the evaluation is *not* carried out in an initializer of a `static` item, then reads and writes to any mutable `static`, such as `static mut`s and `static`s containing an interior-mutable type, are not allowed.

With writes being handled separately by my suggestion above, this can just say "reads from any mutable `static".

RalfJung · 2024-11-24T11:34:32Z

src/const_eval.md

+  * Reads and writes to `extern` statics are not allowed in any constant evaluation context.
+  * If the evaluation is carried out in an initializer of a `static` item, then *writes* into mutable `static` are not allowed, such as `static mut`s and `static`s containing an interior-mutable type.


Suggested change

* Reads and writes to `extern` statics are not allowed in any constant evaluation context.

* If the evaluation is carried out in an initializer of a `static` item, then *writes* into mutable `static` are not allowed, such as `static mut`s and `static`s containing an interior-mutable type.

* Writes to `static` items are not allowed in any constant evaluation context.

* Reads from `extern` statics are not allowed in any constant evaluation context.

I think that is simpler than what you have.

RalfJung · 2024-11-24T21:20:28Z

src/const_eval.md

+  * If the evaluation is *not* carried out in an initializer of a `static` item,
+  then reads from any mutable `static` are not allowed.
+  By mutable `static` it includes `static mut`s and `static`s containing an interior-mutable type.


Suggested change

* If the evaluation is *not* carried out in an initializer of a `static` item,

then reads from any mutable `static` are not allowed.

By mutable `static` it includes `static mut`s and `static`s containing an interior-mutable type.

* If the evaluation is *not* carried out in an initializer of a `static` item,

then reads from any mutable `static` are not allowed.

A mutable `static` is a `static mut` item, or a `static` item with an interior-mutable type.

src/const_eval.md

Co-authored-by: Eric Huss <eric@huss.org>

RalfJung · 2024-12-02T21:03:12Z

Ah right they all got fixed, great. Thanks all!

Update books ## rust-lang/book 12 commits in e16dd73690a6cc3ecdc5f5d94bbc3ce158a42e16..614c19cb4025636eb2ba68ebb3d44e3bd3a5e6e4 2024-12-02 16:22:15 UTC to 2024-11-26 21:15:51 UTC - Fix more inverted uses of “shadowed” (rust-lang/book#4122) - Fix a couple inverted uses of “shadowed” (rust-lang/book#4121) - Fix confusion between variable `hello` and string `"hello"` (rust-lang/book#4118) - Ch. 17: fix some wording issues (rust-lang/book#4117) - Rephrase for clarity (rust-lang/book#3809) - Link to tests section of rustc book for `cargo test -- --help` docs (rust-lang/book#4116) - Drop a pedantry-triggering sentence about IEEE-754 (rust-lang/book#4114) - Very small clarification on if let (rust-lang/book#4113) - Ch17-05: Typos (rust-lang/book#4099) - Ch20-01: Fix typos (rust-lang/book#4105) - Add a short paragraph on editors and IDEs in installation (rust-lang/book#4112) - Rust 2024: update Ch. 20 for new `unsafe` rules (rust-lang/book#4111) ## rust-lang/reference 8 commits in 5c86c739ec71b8bc839310ff47fa94e94635bba9..ede56d1bbe132bac476b5029cd6d7508ca9572e9 2024-11-25 17:23:35 +0000 to 2024-12-03 22:26:55 +0000 - Claim to follow Unicode 16 for lexing identifiers. (rust-lang/reference#1688) - Clarify rules for on_unimplemented warnings (rust-lang/reference#1680) - Enable triagebot merge-conflict notifications (rust-lang/reference#1682) - Update default edition to 2024 for code examples (rust-lang/reference#1684) - Fix weak keywords (rust-lang/reference#1685) - `const` expression can borrow static items (rust-lang/reference#1610) - Update function-pointer.md for stabilization of `extended_varargs_abi_support` (rust-lang/reference#1687) - fix inconsistent spacing in example (rust-lang/reference#1686) ## edition-guide 1 commits in f48b0e842a3911c63240e955d042089e9e0894c7..128669297c8a7fdf771042eaec18b8adfaeaf0cd 2024-11-25 16:20:27 +0000 to 2024-12-03 22:02:43 +0000 - Fix `if_let_rescope` applicability (rust-lang/edition-guide#339) ## rust-lang/rustc-dev-guide 6 commits in 787b416..b21d99b 2024-12-02 04:45:30 UTC to 2024-11-27 10:31:58 UTC - Spell out `git submodule deinit -f --all` (rust-lang/rustc-dev-guide#2153) - Explain how to deal with exploded git submodules (rust-lang/rustc-dev-guide#2152) - Update `//@ proc-macro` aux build directive docs (rust-lang/rustc-dev-guide#2149) - Remove `pretty-expanded` as it no longer exists (rust-lang/rustc-dev-guide#2147) - Fix trivial typo (rust-lang/rustc-dev-guide#2148) - Remove -Zfuel. (rust-lang/rustc-dev-guide#2032)

Rollup merge of rust-lang#133761 - rustbot:docs-update, r=ehuss Update books ## rust-lang/book 12 commits in e16dd73690a6cc3ecdc5f5d94bbc3ce158a42e16..614c19cb4025636eb2ba68ebb3d44e3bd3a5e6e4 2024-12-02 16:22:15 UTC to 2024-11-26 21:15:51 UTC - Fix more inverted uses of “shadowed” (rust-lang/book#4122) - Fix a couple inverted uses of “shadowed” (rust-lang/book#4121) - Fix confusion between variable `hello` and string `"hello"` (rust-lang/book#4118) - Ch. 17: fix some wording issues (rust-lang/book#4117) - Rephrase for clarity (rust-lang/book#3809) - Link to tests section of rustc book for `cargo test -- --help` docs (rust-lang/book#4116) - Drop a pedantry-triggering sentence about IEEE-754 (rust-lang/book#4114) - Very small clarification on if let (rust-lang/book#4113) - Ch17-05: Typos (rust-lang/book#4099) - Ch20-01: Fix typos (rust-lang/book#4105) - Add a short paragraph on editors and IDEs in installation (rust-lang/book#4112) - Rust 2024: update Ch. 20 for new `unsafe` rules (rust-lang/book#4111) ## rust-lang/reference 8 commits in 5c86c739ec71b8bc839310ff47fa94e94635bba9..ede56d1bbe132bac476b5029cd6d7508ca9572e9 2024-11-25 17:23:35 +0000 to 2024-12-03 22:26:55 +0000 - Claim to follow Unicode 16 for lexing identifiers. (rust-lang/reference#1688) - Clarify rules for on_unimplemented warnings (rust-lang/reference#1680) - Enable triagebot merge-conflict notifications (rust-lang/reference#1682) - Update default edition to 2024 for code examples (rust-lang/reference#1684) - Fix weak keywords (rust-lang/reference#1685) - `const` expression can borrow static items (rust-lang/reference#1610) - Update function-pointer.md for stabilization of `extended_varargs_abi_support` (rust-lang/reference#1687) - fix inconsistent spacing in example (rust-lang/reference#1686) ## edition-guide 1 commits in f48b0e842a3911c63240e955d042089e9e0894c7..128669297c8a7fdf771042eaec18b8adfaeaf0cd 2024-11-25 16:20:27 +0000 to 2024-12-03 22:02:43 +0000 - Fix `if_let_rescope` applicability (rust-lang/edition-guide#339) ## rust-lang/rustc-dev-guide 6 commits in 787b416..b21d99b 2024-12-02 04:45:30 UTC to 2024-11-27 10:31:58 UTC - Spell out `git submodule deinit -f --all` (rust-lang/rustc-dev-guide#2153) - Explain how to deal with exploded git submodules (rust-lang/rustc-dev-guide#2152) - Update `//@ proc-macro` aux build directive docs (rust-lang/rustc-dev-guide#2149) - Remove `pretty-expanded` as it no longer exists (rust-lang/rustc-dev-guide#2147) - Fix trivial typo (rust-lang/rustc-dev-guide#2148) - Remove -Zfuel. (rust-lang/rustc-dev-guide#2032)

Update books ## rust-lang/book 12 commits in e16dd73690a6cc3ecdc5f5d94bbc3ce158a42e16..614c19cb4025636eb2ba68ebb3d44e3bd3a5e6e4 2024-12-02 16:22:15 UTC to 2024-11-26 21:15:51 UTC - Fix more inverted uses of “shadowed” (rust-lang/book#4122) - Fix a couple inverted uses of “shadowed” (rust-lang/book#4121) - Fix confusion between variable `hello` and string `"hello"` (rust-lang/book#4118) - Ch. 17: fix some wording issues (rust-lang/book#4117) - Rephrase for clarity (rust-lang/book#3809) - Link to tests section of rustc book for `cargo test -- --help` docs (rust-lang/book#4116) - Drop a pedantry-triggering sentence about IEEE-754 (rust-lang/book#4114) - Very small clarification on if let (rust-lang/book#4113) - Ch17-05: Typos (rust-lang/book#4099) - Ch20-01: Fix typos (rust-lang/book#4105) - Add a short paragraph on editors and IDEs in installation (rust-lang/book#4112) - Rust 2024: update Ch. 20 for new `unsafe` rules (rust-lang/book#4111) ## rust-lang/reference 8 commits in 5c86c739ec71b8bc839310ff47fa94e94635bba9..ede56d1bbe132bac476b5029cd6d7508ca9572e9 2024-11-25 17:23:35 +0000 to 2024-12-03 22:26:55 +0000 - Claim to follow Unicode 16 for lexing identifiers. (rust-lang/reference#1688) - Clarify rules for on_unimplemented warnings (rust-lang/reference#1680) - Enable triagebot merge-conflict notifications (rust-lang/reference#1682) - Update default edition to 2024 for code examples (rust-lang/reference#1684) - Fix weak keywords (rust-lang/reference#1685) - `const` expression can borrow static items (rust-lang/reference#1610) - Update function-pointer.md for stabilization of `extended_varargs_abi_support` (rust-lang/reference#1687) - fix inconsistent spacing in example (rust-lang/reference#1686) ## edition-guide 1 commits in f48b0e842a3911c63240e955d042089e9e0894c7..128669297c8a7fdf771042eaec18b8adfaeaf0cd 2024-11-25 16:20:27 +0000 to 2024-12-03 22:02:43 +0000 - Fix `if_let_rescope` applicability (rust-lang/edition-guide#339) ## rust-lang/rustc-dev-guide 6 commits in 787b4166ccc67bd8f72a6e3ef6685ce9ce82909a..b21d99b770f9aceb0810c843847c52f86f45d2ed 2024-12-02 04:45:30 UTC to 2024-11-27 10:31:58 UTC - Spell out `git submodule deinit -f --all` (rust-lang/rustc-dev-guide#2153) - Explain how to deal with exploded git submodules (rust-lang/rustc-dev-guide#2152) - Update `//@ proc-macro` aux build directive docs (rust-lang/rustc-dev-guide#2149) - Remove `pretty-expanded` as it no longer exists (rust-lang/rustc-dev-guide#2147) - Fix trivial typo (rust-lang/rustc-dev-guide#2148) - Remove -Zfuel. (rust-lang/rustc-dev-guide#2032)

ehuss added the S-waiting-on-stabilization Waiting for a stabilization PR to be merged in the main Rust repository label Sep 11, 2024

dingxiangfei2009 changed the title ~~const expression can borrow static items~~ const expression can borrow static items Sep 11, 2024

ehuss reviewed Sep 11, 2024

View reviewed changes

dingxiangfei2009 force-pushed the const-ref-to-static branch 2 times, most recently from 3d0233b to 75faa87 Compare September 11, 2024 17:32

traviscross mentioned this pull request Aug 28, 2024

Tracking Issue for const_refs_to_static rust-lang/rust#119618

Closed

6 tasks

ehuss mentioned this pull request Sep 17, 2024

Places based on misaligned pointers: also mention 'static's as a possible base for place projections #1606

Merged

RalfJung mentioned this pull request Sep 21, 2024

Stabilize const_refs_to_static rust-lang/rust#129759

Merged

RalfJung reviewed Sep 21, 2024

View reviewed changes

rustbot added the S-waiting-on-review Status: The marked PR is awaiting review from a maintainer label Sep 22, 2024

ehuss reviewed Sep 28, 2024

View reviewed changes

src/const_eval.md Outdated Show resolved Hide resolved

src/const_eval.md Outdated Show resolved Hide resolved

src/const_eval.md Outdated Show resolved Hide resolved

RalfJung reviewed Sep 28, 2024

View reviewed changes

src/const_eval.md Outdated Show resolved Hide resolved

dingxiangfei2009 requested a review from ehuss October 1, 2024 21:29

dingxiangfei2009 force-pushed the const-ref-to-static branch from a2dde9c to 8f8cf46 Compare October 1, 2024 21:30

ehuss force-pushed the const-ref-to-static branch from 8f8cf46 to 97abd04 Compare October 9, 2024 14:17

ehuss approved these changes Oct 9, 2024

View reviewed changes

RalfJung reviewed Oct 9, 2024

View reviewed changes

ehuss reviewed Oct 10, 2024

View reviewed changes

RalfJung reviewed Oct 10, 2024

View reviewed changes

dingxiangfei2009 force-pushed the const-ref-to-static branch from 67f4754 to e8c43a6 Compare October 12, 2024 16:37

RalfJung reviewed Oct 25, 2024

View reviewed changes

dingxiangfei2009 force-pushed the const-ref-to-static branch from 51f2499 to 4a6ac9c Compare November 1, 2024 08:38

traviscross reviewed Nov 5, 2024

View reviewed changes

nikomatsakis mentioned this pull request Nov 6, 2024

Resolve the biggest blockers to Linux building on stable Rust rust-lang/rust-project-goals#116

Open

40 tasks

RalfJung mentioned this pull request Nov 21, 2024

Announcing Rust 1.83.0 rust-lang/blog.rust-lang.org#1432

Merged

RalfJung reviewed Nov 21, 2024

View reviewed changes

dingxiangfei2009 force-pushed the const-ref-to-static branch from 4a6ac9c to ad06623 Compare November 21, 2024 21:47

RalfJung reviewed Nov 22, 2024

View reviewed changes

ehuss reviewed Nov 22, 2024

View reviewed changes

RalfJung reviewed Nov 24, 2024

View reviewed changes

chorman0773 mentioned this pull request Dec 1, 2024

The reference is wrong about constants referencing statics since v1.83.0 #1690

Closed

RalfJung reviewed Dec 2, 2024

View reviewed changes

src/const_eval.md Outdated Show resolved Hide resolved

RalfJung reviewed Dec 2, 2024

View reviewed changes

src/const_eval.md Outdated Show resolved Hide resolved

Const expression can borrow static items

2bc4396

Co-authored-by: Eric Huss <eric@huss.org>

traviscross force-pushed the const-ref-to-static branch from b086fc0 to 2bc4396 Compare December 2, 2024 20:12

traviscross approved these changes Dec 2, 2024

View reviewed changes

traviscross added this pull request to the merge queue Dec 2, 2024

Merged via the queue into rust-lang:master with commit 270c2b9 Dec 2, 2024
5 checks passed

dingxiangfei2009 deleted the const-ref-to-static branch December 3, 2024 09:30

ehuss mentioned this pull request Dec 4, 2024

Update books rust-lang/rust#133761

Merged

	* Paths to immutable [statics] with these exception with these restrictions.
	* Paths to [statics] with the following restrictions:

		* Immutable borrows and pointers into immutable part of a `static` are allowed and observes the same restriction
		on all other forms of [borrow]s as mentioned below.

	The final value of a `const` item cannot contain references to anything mutable.
	r[items.const.final-value-immutable]
	The final value of a `const` item cannot contain references to anything mutable.

	* If the evaluation is carried out in an initializer of a `const` item, or inside a `const` block, reads and writes to any `static mut` or [`extern` statics] are not allowed.
	* If the evaluation is not carried out in an initializer of a `static` item, then reads and writes to any mutable `static` (`static mut` or `static` with an interior mutable type) or [`extern` statics] are not allowed.

		* Reads and writes to `extern` statics are not allowed in any constant evaluation context.
		* If the evaluation is carried out in an initializer of a `static` item, then writes into mutable `static` are not allowed, such as `static mut`s and `static`s containing an interior-mutable type.

const expression can borrow static items #1610

const expression can borrow static items #1610

Conversation

dingxiangfei2009 commented Sep 11, 2024 • edited Loading

ehuss left a comment

Choose a reason for hiding this comment

dingxiangfei2009 commented Sep 11, 2024

traviscross commented Sep 17, 2024

traviscross commented Sep 17, 2024

traviscross commented Sep 17, 2024 • edited Loading

RalfJung commented Sep 21, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

RalfJung commented Sep 21, 2024 • edited Loading

RalfJung commented Sep 22, 2024

dingxiangfei2009 commented Sep 22, 2024 • edited Loading

ehuss left a comment

Choose a reason for hiding this comment

dingxiangfei2009 commented Oct 1, 2024

ehuss commented Oct 9, 2024

ehuss left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

RalfJung Oct 9, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ehuss left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

chorman0773 Oct 12, 2024 • edited Loading

Choose a reason for hiding this comment

ehuss commented Oct 25, 2024

Choose a reason for hiding this comment

Choose a reason for hiding this comment

traviscross Nov 5, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

RalfJung Nov 6, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

RalfJung Nov 22, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

RalfJung Nov 22, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

RalfJung commented Dec 2, 2024 via email

`const` expression can borrow static items #1610

`const` expression can borrow static items #1610

dingxiangfei2009 commented Sep 11, 2024 •

edited

Loading

traviscross commented Sep 17, 2024 •

edited

Loading

RalfJung commented Sep 21, 2024 •

edited

Loading

RalfJung commented Sep 21, 2024 •

edited

Loading

dingxiangfei2009 commented Sep 22, 2024 •

edited

Loading

RalfJung Oct 9, 2024 •

edited

Loading

chorman0773 Oct 12, 2024 •

edited

Loading

traviscross Nov 5, 2024 •

edited

Loading

RalfJung Nov 6, 2024 •

edited

Loading

RalfJung Nov 22, 2024 •

edited

Loading

RalfJung Nov 22, 2024 •

edited

Loading