Fuzion Logo
fuzion-lang.dev — The Fuzion Language Portal
JavaScript seems to be disabled. Functionality is limited.

Persistent_Map

container.Persistent_Map

(K 
type
:
Type, V 
type
:
Type)
 ref
:
Map K, V
 is
[Contains abstract features]
Persistent_Map -- an abstract persistent map from keys K to values V

Type Parameters

Functions

(LM 
type
:
Type)
 => 
container.Mutable_Map K V
[Inherited from  Map]
[Abstract feature]
create a mutable map from this

NYI: maybe add default implementation when there is a naive implementation only requiring property.equatable
 => 
String
[Inherited from  Map]
create a string containing all mappings

redefines:

 => 
Type
[Inherited from  Any]
Get the dynamic type of this instance. For value instances `x`, this is
equal to `type_of x`, but for `x` with a `ref` type `x.dynamic_type` gives
the actual runtime type, while `type_of x` results in the static
compile-time type.

There is no dynamic type of a type instance since this would result in an
endless hierarchy of types. So for Type values, dynamic_type is redefined
to just return Type.type.
(k K)
 => 
bool
[Inherited from  Map]
check if key k is present in the set of keys
(k K)
 => 
option V
[Inherited from  Map]
[Abstract feature]
get the value k is mapped to, or nil if none.
 => 
Sequence (tuple K V)
[Inherited from  Map]
[Abstract feature]
get a sequence of all key/value pairs in this map
 => 
Sequence K
[Inherited from  Map]
get a sequence of all keys in this map
 => 
String
[Inherited from  Any]
convenience prefix operator to create a string from a value.

This permits usage of `$` as a prefix operator in a similar way both
inside and outside of constant strings: $x and "$x" will produce the
same string.
(k K, v V)
 => 
container.Persistent_Map K V
[Abstract feature]
returns a new Persistent_Map
which contains all entries of the
current Map and k,v.
An already existing k will be replaced.
 => 
i32
[Inherited from  Map]
[Abstract feature]
number of entries in this map
 => 
Sequence V
[Inherited from  Map]
get a sequence of all values in this map

Type Functions

 => 
String
[Inherited from  Type]
string representation of this type to be used for debugging.

result has the form "Type of '<name>'", but this might change in the future

redefines:

 => 
Type
[Inherited from  Type]
There is no dynamic type of a type instance since this would result in an
endless hierarchy of types, so dynamic_type is redefined to just return
Type.type here.

redefines:

 => 
container.Map.this.type
[Inherited from  Map]
[Abstract feature]
initializer for this map

every map implementation needs to implement this
(T 
type
:
Type)
 => 
bool
[Inherited from  Type]
Is this type assignable to a type parameter with constraint `T`?

The result of this is a compile-time constant that can be used to specialize
code for a particular type.


it is most useful in conjunction with preconditions or `if` statements as in


or

 => 
String
[Inherited from  Type]
name of this type, including type parameters, e.g. 'option (list i32)'.
 => 
String
[Inherited from  Type]
convenience prefix operator to create a string from a value.

This permits usage of `$` as a prefix operator in a similar way both
inside and outside of constant strings: $x and "$x" will produce the
same string.

NYI: Redefinition allows the type feature to be distinguished from its normal counterpart, see #3913

redefines:

 => 
Type
[Inherited from  Any]
Get a type as a value.

This is a feature with the effect equivalent to Fuzion's `expr.type` call tail.
It is recommended to use `expr.type` and not `expr.type_value`.

`type_value` is here to show how this can be implemented and to illustrate the
difference to `dynamic_type`.
0.095dev (2025-08-15 12:02:22 GIT hash 301b5b75e77076d091b38f555473f9f0e31e5b5c built by fridi@fzen)