Files
carbon-lang/core/prelude/operators/as.carbon
T
Chandler Carruth 8be274cf60 Replace :! binding syntax with phase keywords and contextual defaults (#7479)
Implement the toolchain side of proposal #7254, removing the `:!`
binding
syntax for generic and template parameters in favor of the keywords
`generic`,
`template`, and `runtime` plus contextual defaults for phase.

For valid programs this is semantics-preserving: each binding resolves
to the
same phase, and produces the same SemIR, as it did under `:!`/`:`. The
parser
derives a binding's phase from its syntactic context plus any explicit
phase
keyword; new diagnostics and error recovery for misused keywords are
described
below.

Implementation details for each component:

- Lexer: remove the `:!` (`ColonExclaim`) token, move its virtual
parse-node
  budget onto `:`, and add the `generic` and `runtime` keywords.
- Parser: thread a `BindingContext` (`ExplicitParam`, `DeducedParam`, or
`CompileTimeEntityParam`) from declaration introducers down through
parameter
lists to each binding pattern, using a one-token lookahead to
distinguish a
name-qualifier parameter list from a declaration's own final list.
Parameters
of a compile-time entity (`class`, `interface`, `constraint`, `choice`,
`alias`, `export`, `namespace`) and deduced `[]` parameters default to
checked
generic; explicit function parameters and local bindings default to
runtime.
`HandleBindingPattern` resolves the phase from that context plus the
keyword: a
`generic` keyword needs no node of its own (the phase is carried by the
  binding's node kind), while a `runtime` keyword is preserved as a
`RuntimeBindingName` node so `check` can name it in a diagnostic. A
phase
keyword that is merely redundant with the contextual default is
diagnosed
  here, without invalidating the parse tree.
- Check: a phase keyword that is invalid for its context (for example
`runtime`
on a checked-generic parameter) is diagnosed here, and recovers by
building an
error binding that still introduces the name so that later uses of it do
not
  produce cascading errors.

The removed `:!` syntax is now rejected as an ordinary parse error.

The `form`/`:?`/`->?` ("extended types") portion of proposal #7254 is
left for a
separate change.

Assisted-by: Claude Code
2026-07-11 01:22:44 +00:00

85 lines
2.6 KiB
Plaintext

// Part of the Carbon Language project, under the Apache License v2.0 with LLVM
// Exceptions. See /LICENSE for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
package Core library "prelude/operators/as";
import library "prelude/copy";
import library "prelude/types/char_literal";
import library "prelude/types/int_literal";
import library "prelude/types/float_literal";
interface UnsafeAs(Dest: type) {
fn Convert(self) -> Dest;
}
interface As(Dest: type) {
// TODO: extend UnsafeAs(Dest);
fn Convert(self) -> Dest;
}
interface ImplicitAs(Dest: type) {
// TODO: extend As(Dest);
fn Convert(self) -> Dest;
}
// Workaround: ImplicitAs extends As.
impl forall [U: type, T: ImplicitAs(U)] T as As(U) {
fn Convert(self) -> U { return self.Convert(); }
}
// Workaround: As extends UnsafeAs.
impl forall [U: type, T: As(U)] T as UnsafeAs(U) {
fn Convert(self) -> U { return self.Convert(); }
}
// Copyable types have an identity conversion that performs a copy.
impl forall [T: Copy] T as ImplicitAs(T) {
fn Convert(self) -> Self { return self.(Copy.Op)(); }
}
// `const` can be added and removed when converting a value.
impl forall [T: type, U: ImplicitAs(T)] U as ImplicitAs(const T) {
fn Convert(self) -> const T { return self.Convert(); }
}
impl forall [T: type, U: ImplicitAs(T)] const U as ImplicitAs(T) {
fn Convert(self) -> T { return (self as U).Convert(); }
}
// `const` can be added to a pointer.
// TODO: This is also provided as a builtin conversion. We provide it here so
// that Optional(T*) can implicitly convert to Optional(const T*). See #5750.
impl forall [T: type] T* as ImplicitAs(const T*) {
fn Convert(self) -> const T* = "pointer.unsafe_convert";
}
impl forall [T: type] T* as As(const T*) {
fn Convert(self) -> const T* = "pointer.unsafe_convert";
}
// Pointer types can be unsafely cast to other pointer types.
// TODO: Should `unsafe as` be able to remove `const`?
impl forall [T: type, U: type] T* as UnsafeAs(U*) {
fn Convert(self) -> U* = "pointer.unsafe_convert";
}
// Integer literals can be implicitly converted to floating-point literals.
impl IntLiteral as ImplicitAs(FloatLiteral) {
fn Convert(self) -> FloatLiteral = "int.convert_float_checked";
}
// Floating-point literals can be explicitly cast to integer literals.
impl FloatLiteral as UnsafeAs(IntLiteral) {
fn Convert(self) -> IntLiteral = "float.convert_int";
}
// Integer literals can be explicitly cast to char literals.
impl IntLiteral as As(CharLiteral) {
fn Convert(self) -> CharLiteral = "int.convert_char_literal";
}
interface IntFitsIn(Dest: type) {}
interface FloatFitsIn(Src: type) {}