diff --git a/proposals/gc/MVP.md b/proposals/gc/MVP.md index a64ad58d7..da0f29658 100644 --- a/proposals/gc/MVP.md +++ b/proposals/gc/MVP.md @@ -602,35 +602,39 @@ In particular, `ref.null` is typed as before, despite the introduction of `none` #### Casts +TODO: ensure that this section (and implementations, and tests) is kept in sync with the results of the conversation [here](https://github.com/WebAssembly/gc/issues/342). + Casts work for both abstract and concrete types. In the latter case, they test if the operand's RTT is a sub-RTT of the target type. -* `ref.test ` tests whether a reference has a given type - - `ref.test rt : [rt'] -> [i32]` - - iff `rt <: trt` and `rt' <: trt` for some `trt` - - if `rt` contains `null`, returns 1 for null, otherwise 0 +* `ref.test null? ` checks whether a reference has a given heap type + - `ref.test null? ht : [(ref null ht')] -> [i32]` + - iff `ht <: tht` and `ht' <: tht` where `tht` is a common super type + - if `null?` is present, returns 1 for null, otherwise 0 -* `ref.cast ` tries to convert a reference to a given type - - `ref.cast rt : [rt'] -> [rt]` - - iff `rt <: trt` and `rt' <: trt` for some `trt` +* `ref.cast null? ` tries to convert to a given heap type + - `ref.cast null? ht : [(ref null ht')] -> [(ref null? ht)]` + - iff `ht <: tht` and `ht' <: tht` where `tht` is a common super type - traps if reference is not of requested type - - if `rt` contains `null`, a null operand is passed through, otherwise traps on null - - equivalent to `(block $l (param trt) (result rt) (br_on_cast $l rt) (unreachable))` + - if `null?` is present, a null operand is passed through, otherwise traps on null + - equivalent to `(block $l (param (ref null tht)) (result (ref null? ht)) (br_on_cast $l null? ht) (unreachable))` -* `br_on_cast ` branches if a reference has a given type - - `br_on_cast $l rt : [t0* rt'] -> [t0* rt']` +* `br_on_cast null? ` branches if a reference has a given heap type + - `br_on_cast $l null? ht : [t0* (ref null3? ht')] -> [t0* (ref null2? ht')]` - iff `$l : [t0* t']` - - and `rt <: t'` - - and `rt <: trt` and `rt' <: trt` for some `trt` + - and `(ref null4? ht) <: t'` + - and `ht <: tht` and `ht' <: tht` where `tht` is a common super type + - and `null? = null4? =/= null2? \/ null2? = null3? = null4? = epsilon` - passes operand along with branch under target type, plus possible extra args - - if `rt` contains `null`, branches on null, otherwise does not + - if `null?` is present, branches on null, otherwise does not -* `br_on_cast_fail ` branches if a reference does not have a given type - - `br_on_cast_fail $l rt : [t0* rt'] -> [t0* rt]` +* `br_on_cast_fail null? ` branches if a reference does not have a given heap type + - `br_on_cast_fail $l null? ht : [t0* (ref null3? ht')] -> [t0* (ref null2? ht)]` - iff `$l : [t0* t']` - - and `rt' <: t'` - - and `rt <: trt` and `rt' <: trt` for some `trt` + - and `(ref null4? ht') <: t'` + - and `ht <: tht` and `ht' <: tht` where `tht` is a common super type + - and `null? = null2? =/= null4? \/ null2? = null3? = null4? = epsilon` - passes operand along with branch, plus possible extra args - - if `rt` contains `null`, does not branch on null, otherwise does + - if `null?` is present, does not branch on null, otherwise does Note: Cast instructions do _not_ require the operand's source type to be a supertype of the target type. It can also be a "sibling" in the same hierarchy, i.e., they only need to have a common supertype (in practice, it is sufficient to test that both types share the same top heap type.). Allowing so is necessary to maintain subtype substitutability, i.e., the ability to maintain well-typedness when operands are replaced by subtypes.