%---------------------------------------------------------------------------%
% vim: ft=mercury ts=4 sw=4 et
%---------------------------------------------------------------------------%
% Copyright (C) 2021-2026 The Mercury team.
% This file may only be copied under the terms of the GNU General
% Public License - see the file COPYING in the Mercury distribution.
%---------------------------------------------------------------------------%
%
% File: polymorphism_type_info.m.
% Main authors: fjh and zs (when this code was in polymorphism.m).
%
% This module provides predicates that construct type_infos, the structures
% that provide type information to the parts of the runtime system that need
% such information. These are mainly the predicates that unify, compare,
% construct, deconstruct, read in, or write out values of arbitrary types,
% and the debugger.
%
%---------------------------------------------------------------------------%
%
% Representation of type information:
%
% IMPORTANT: ANY MATERIAL CHANGES TO THE DOCUMENTATION HERE
% MUST BE REFLECTED BY SIMILAR CHANGES
%
% - to the #defines in mercury_type_info.h in the runtime directory, and
% - to the type specialization code in higher_order.specialize_unify_compare.m
%   in the compiler directory.
%
% We represent type information using one or two cells. The cell which
% is always present is the type_ctor_info structure, whose structure is
% defined in runtime/mercury_type_info.h. The other cell is the type_info
% structure, which is laid out like this:
%
%   word 0      <pointer to the type_ctor_info structure>
%   word 1+     <the type_infos for the type params, at least one>
%
%   (but see note below for how variable arity types differ).
%
%---------------------------------------------------------------------------%
%
% Optimization of common case (zero arity type constructors):
%
% The type_info structure itself is redundant if the type has no type
% parameters (i.e. its arity is zero). Therefore if the arity is zero,
% we pass the address of the type_ctor_info structure directly, instead of
% wrapping it up in another cell. The runtime system will look at the first
% field of the cell it is passed.
%
% - If this field is zero, the cell is a type_ctor_info structure
%   for an arity zero type constructor.
%
% - If this field is not zero, the cell is a type_info structure,
%   with the first field being the pointer to the type_ctor_info structure.
%
%---------------------------------------------------------------------------%
%
% Variable arity type constructors:
%
% There is a slight variation on this for variable-arity type constructors,
% of which there are exactly three: pred, func and tuple. Typeinfos of
% these types always have a pointer to the pred/0, func/0 or tuple/0
% type_ctor_info, regardless of their true arity, so we store the real arity
% in the type_info as well, resulting in this layout:
%
%   word 0      <pointer to the arity 0 type_ctor_info structure>
%   word 1      <arity of predicate>
%   word 2+     <the type_infos for the type params, if any>
%
%---------------------------------------------------------------------------%
%
% Sharing type_ctor_info structures:
%
% For compilation models that can put code addresses in static ground terms,
% we can arrange to create one copy of the type_ctor_info structure statically,
% avoiding the need to create other copies at runtime. For compilation models
% that cannot put code addresses in static ground terms, there are two
% approaches we could take.
%
%   1. Allocate all cells at runtime.
%   2. Use a shared static type_ctor_info, but initialize its code addresses
%      during startup (that is, during the module initialization code).
%
% We take approach 2.
%
%---------------------------------------------------------------------------%

:- module check_hlds.polymorphism_type_info.
:- interface.

:- import_module check_hlds.polymorphism_info.
:- import_module hlds.
:- import_module hlds.const_struct.
:- import_module hlds.hlds_goal.
:- import_module hlds.hlds_module.
:- import_module hlds.hlds_pred.
:- import_module hlds.hlds_rtti.
:- import_module parse_tree.
:- import_module parse_tree.prog_data.
:- import_module parse_tree.var_table.

:- import_module assoc_list.
:- import_module list.
:- import_module maybe.
:- import_module term.

%---------------------------------------------------------------------------%

    % Given a type, create a variable to hold the type_info for that type,
    % and create a list of goals to initialize that type_info variable
    % to the appropriate type_info structure for the type.
    % Update the var_table accordingly.
    %
:- pred polymorphism_make_type_info_var(mer_type::in, term.context::in,
    prog_var::out, list(hlds_goal)::out, poly_info::in, poly_info::out) is det.

    % Given a list of types, create a list of variables to hold the type_infos
    % for those types, and create a list of goals to initialize those type_info
    % variables to the appropriate type_info structures for the types.
    % Update the var_table accordingly.
    %
:- pred polymorphism_make_type_info_vars(list(mer_type)::in, term.context::in,
    list(prog_var)::out, list(hlds_goal)::out, poly_info::in, poly_info::out)
    is det.

    % A version of polymorphism_make_type_info_vars that also returns
    % information for each var that can be useful when putting type_infos
    % into static data.
    %
:- pred polymorphism_do_make_type_info_vars(list(mer_type)::in,
    term.context::in,
    assoc_list(prog_var, maybe(const_struct_arg))::out, list(hlds_goal)::out,
    poly_info::in, poly_info::out) is det.

%---------------------%

    % Versions of the above predicates that get their info from, and update,
    % module_infos, pred_infos and proc_infos, rather than a poly_info.
    % These do not store the updated pred_infos and proc_infos back into
    % the module_info.
    %
:- pred polymorphism_make_type_info_var_mi(mer_type::in,
    term.context::in, prog_var::out, list(hlds_goal)::out,
    module_info::in, module_info::out,
    pred_info::in, pred_info::out, proc_info::in, proc_info::out) is det.
:- pred polymorphism_make_type_info_vars_mi(list(mer_type)::in,
    term.context::in, list(prog_var)::out, list(hlds_goal)::out,
    module_info::in, module_info::out,
    pred_info::in, pred_info::out, proc_info::in, proc_info::out) is det.

%---------------------------------------------------------------------------%

    % init_type_info_var(Type, ArgVars, TypeInfoVar, TypeInfoGoal,
    %   !RttiVarMaps):
    %
    % Create the unification that constructs the second cell of a type_info
    % for Type. ArgVars should contain the arguments of this unification.
    %
    % This unification WILL lead to the creation of cells on the heap
    % at runtime.
    %
    % The first variable in ArgVars should be bound to the type_ctor_info
    % for Type's principal type constructor. If that type constructor is
    % variable arity, and we are not targeting Java, the next variable
    % in ArgVars should be bound to an integer giving Type's actual arity.
    % The remaining variables in ArgVars should be bound to the type_infos
    % or type_ctor_infos giving Type's argument types.
    %
:- pred init_type_info_var(mer_type::in, list(prog_var)::in, prog_var::in,
    hlds_goal::out, rtti_varmaps::in, rtti_varmaps::out) is det.

    % init_const_type_ctor_info_var(Type, TypeCtor,
    %   TypeCtorInfoVar, TypeCtorConsId, TypeCtorInfoGoal,
    %   !VarTable, !RttiVarMaps):
    %
    % Create the unification (returned as TypeCtorInfoGoal) that binds a
    % new variable (returned as TypeCtorInfoVar) to the type_ctor_info
    % representing TypeCtor. This will be the constant represented by
    % TypeCtorConsId.
    %
    % This unification WILL NOT lead to the creation of a cell on the
    % heap at runtime; it will cause TypeCtorInfoVar to refer to the
    % statically allocated type_ctor_info cell for the type, allocated
    % in the module that defines the type.
    %
    % We take Type as input for historical reasons: we record Type as
    % the type whose type constructor TypeCtor is, in the type of
    % TypeCtorInfoVar.
    %
:- pred init_const_type_ctor_info_var(mer_type::in, type_ctor::in,
    prog_var::out, cons_id::out, hlds_goal::out,
    var_table::in, var_table::out, rtti_varmaps::in, rtti_varmaps::out) is det.

%---------------------%

:- type type_info_kind
    --->    type_info
    ;       type_ctor_info.

:- pred new_type_info_var(mer_type::in, type_info_kind::in, prog_var::out,
    poly_info::in, poly_info::out) is det.
:- pred new_type_info_var_vt(mer_type::in, type_info_kind::in, prog_var::out,
    var_table::in, var_table::out, rtti_varmaps::in, rtti_varmaps::out) is det.

%---------------------%

:- pred poly_get_type_info_locn(tvar::in, type_info_locn::out,
    poly_info::in, poly_info::out) is det.
:- pred poly_get_type_info_locn_raw(tvar_kind_map::in,
    tvar::in, type_info_locn::out,
    var_table::in, var_table::out, rtti_varmaps::in, rtti_varmaps::out) is det.

%---------------------%

:- type int_or_var
    --->    iov_int(int)
    ;       iov_var(prog_var).

    % gen_extract_type_info(ModuleInfo, TypeVar, Kind,
    %   TypeClassInfoVar, IndexIntOrVar, Context, Goals, TypeInfoVar,
    %   !VarTable, !RttiVarMaps):
    %
    % Generate code to extract a type_info variable from a given slot of a
    % typeclass_info variable, by calling type_info_from_typeclass_info from
    % private_builtin. TypeVar is the type variable to which this type_info
    % variable corresponds. Kind is the kind of the type variable.
    % TypeClassInfoVar is the variable holding the type_class_info.
    % IndexIntOrVar specifies which slot it is. The procedure returns
    % TypeInfoVar, which is a fresh variable holding the type_info,
    % and Goals, which is the code generated to initialize TypeInfoVar.
    % The context of these goals will be Context.
    %
:- pred gen_extract_type_info(module_info::in, tvar::in, kind::in,
    prog_var::in, int_or_var::in, prog_context::in,
    list(hlds_goal)::out, prog_var::out,
    var_table::in, var_table::out, rtti_varmaps::in, rtti_varmaps::out) is det.

    % A version of gen_extract_type_info that gets its data from the poly_info,
    % and puts the updated date there as well.
    %
:- pred polymorphism_extract_type_info(tvar::in, prog_var::in, int::in,
    prog_context::in, list(hlds_goal)::out, prog_var::out,
    poly_info::in, poly_info::out) is det.

%---------------------------------------------------------------------------%
%---------------------------------------------------------------------------%

:- implementation.

:- import_module hlds.goal_util.
:- import_module hlds.hlds_code_util.
:- import_module hlds.instmap.
:- import_module hlds.make_goal.
:- import_module hlds.pred_table.
:- import_module libs.
:- import_module libs.globals.
:- import_module libs.optimization_options.
:- import_module mdbcomp.
:- import_module mdbcomp.builtin_modules.
:- import_module mdbcomp.prim_data.
:- import_module parse_tree.builtin_lib_types.
:- import_module parse_tree.prog_type.
:- import_module parse_tree.prog_type_test.
:- import_module parse_tree.set_of_var.

:- import_module int.
:- import_module map.
:- import_module pair.
:- import_module require.
:- import_module set.

%---------------------------------------------------------------------------%

polymorphism_make_type_info_var(Type, Context, Var, ExtraGoals, !Info) :-
    polymorphism_do_make_type_info_var(Type, Context,
        VarMCA, ExtraGoals, !Info),
    VarMCA = Var - _.

polymorphism_make_type_info_vars(Types, Context, Vars, ExtraGoals, !Info) :-
    polymorphism_do_make_type_info_vars(Types, Context,
        VarsMCAs, ExtraGoals, !Info),
    assoc_list.keys(VarsMCAs, Vars).

:- pred polymorphism_do_make_type_info_var(mer_type::in, term.context::in,
    pair(prog_var, maybe(const_struct_arg))::out, list(hlds_goal)::out,
    poly_info::in, poly_info::out) is det.

polymorphism_do_make_type_info_var(Type, Context, VarMCA, ExtraGoals, !Info) :-
    ( if type_has_variable_arity_ctor(Type, TypeCtor, TypeArgs) then
        % This occurs for code where a predicate calls a polymorphic predicate
        % with a type whose type constructor is of variable arity. The
        % transformation we perform is basically the same as in the usual case
        % below, except that we map pred types to pred/0, func types to func/0
        % and tuple types to tuple/0 for the purposes of creating type_infos.
        % To allow univ_to_type to check the type_infos correctly, the actual
        % arity is added to the type_info we create.
        %
        % XXX FIXME (RTTI for higher order impure code)
        % we should not ignore the purity of higher order procs;
        % it should get included in the RTTI.
        polymorphism_make_type_info(Type, TypeCtor, TypeArgs,
            tc_is_var_arity, Context, VarMCA, ExtraGoals, !Info)
    else
        (
            ( Type = defined_type(_, _, _)
            ; Type = builtin_type(_)
            ; Type = tuple_type(_, _)
            ; Type = higher_order_type(_,_, _, _)
            ; Type = apply_n_type(_, _, _)
            ; Type = kinded_type(_, _)
            ),
            type_to_ctor_and_args_det(Type, TypeCtor, TypeArgs),
            % This occurs for code where a predicate calls a polymorphic
            % predicate with a known value of the type variable. The
            % transformation we perform is shown in the comment at the top
            % of the module.
            polymorphism_make_type_info(Type, TypeCtor, TypeArgs,
                tc_is_not_var_arity, Context, VarMCA, ExtraGoals, !Info)
        ;
            Type = type_variable(TypeVar, _),
            poly_get_type_info_locn(TypeVar, TypeInfoLocn, !Info),
            get_type_info_from_locn(TypeVar, TypeInfoLocn, Context,
                Var, ExtraGoals, !Info),
            VarMCA = Var - no
        )
    ).

polymorphism_do_make_type_info_vars([], _, [], [], !Info).
polymorphism_do_make_type_info_vars([Type | Types], Context,
        VarsMCAs, ExtraGoals, !Info) :-
    polymorphism_do_make_type_info_var(Type, Context, HeadVarMCA,
        HeadGoals, !Info),
    polymorphism_do_make_type_info_vars(Types, Context, TailVarsMCAs,
        TailGoals, !Info),
    VarsMCAs = [HeadVarMCA | TailVarsMCAs],
    ExtraGoals = HeadGoals ++ TailGoals.

%---------------------%

polymorphism_make_type_info_var_mi(Type, Context, Var, ExtraGoals,
        !ModuleInfo, !PredInfo, !ProcInfo) :-
    create_poly_info(!.ModuleInfo, !.PredInfo, !.ProcInfo, PolyInfo0),
    polymorphism_make_type_info_var(Type, Context, Var, ExtraGoals,
        PolyInfo0, PolyInfo),
    poly_info_extract(PolyInfo, PolySpecs, !PredInfo, !ProcInfo, !:ModuleInfo),
    expect(unify(PolySpecs, []), $pred, "errors while making type_info var").

polymorphism_make_type_info_vars_mi(Types, Context, Vars, ExtraGoals,
        !ModuleInfo, !PredInfo, !ProcInfo) :-
    create_poly_info(!.ModuleInfo, !.PredInfo, !.ProcInfo, PolyInfo0),
    polymorphism_make_type_info_vars(Types, Context, Vars, ExtraGoals,
        PolyInfo0, PolyInfo),
    poly_info_extract(PolyInfo, PolySpecs, !PredInfo, !ProcInfo, !:ModuleInfo),
    expect(unify(PolySpecs, []), $pred, "errors while making type_info vars").

%---------------------%

:- type type_ctor_is_var_arity
    --->    tc_is_not_var_arity
    ;       tc_is_var_arity.

:- pred polymorphism_make_type_info(mer_type::in, type_ctor::in,
    list(mer_type)::in, type_ctor_is_var_arity::in, prog_context::in,
    pair(prog_var, maybe(const_struct_arg))::out,
    list(hlds_goal)::out, poly_info::in, poly_info::out) is det.

polymorphism_make_type_info(Type, TypeCtor, TypeArgs, TypeCtorIsVarArity,
        Context, TypeInfoVarMCA, ExtraGoals, !Info) :-
    poly_info_get_type_info_var_map(!.Info, TypeInfoVarMap0),
    ( if
        map.search(TypeInfoVarMap0, TypeCtor, TypeCtorVarMap0),
        map.search(TypeCtorVarMap0, TypeArgs, OldTypeInfoVarMCA)
    then
        poly_info_get_num_reuses(!.Info, NumReuses),
        poly_info_set_num_reuses(NumReuses + 1, !Info),
        TypeInfoVarMCA = OldTypeInfoVarMCA,
        ExtraGoals = []
    else
        polymorphism_construct_type_info(Type, TypeCtor, TypeArgs,
            TypeCtorIsVarArity, Context, TypeInfoVar, TypeInfoConstArg,
            ExtraGoals, !Info),
        TypeInfoVarMCA = TypeInfoVar - TypeInfoConstArg,
        % We have to get the type_info_var_map again since the call just above
        % could have added relevant new entries to it.
        poly_info_get_type_info_var_map(!.Info, TypeInfoVarMap1),
        ( if map.search(TypeInfoVarMap1, TypeCtor, TypeCtorVarMap1) then
            map.det_insert(TypeArgs, TypeInfoVarMCA,
                TypeCtorVarMap1, TypeCtorVarMap),
            map.det_update(TypeCtor, TypeCtorVarMap,
                TypeInfoVarMap1, TypeInfoVarMap)
        else
            TypeCtorVarMap = map.singleton(TypeArgs, TypeInfoVarMCA),
            map.det_insert(TypeCtor, TypeCtorVarMap,
                TypeInfoVarMap1, TypeInfoVarMap)
        ),
        poly_info_set_type_info_var_map(TypeInfoVarMap, !Info)
    ).

:- pred polymorphism_construct_type_info(mer_type::in, type_ctor::in,
    list(mer_type)::in, type_ctor_is_var_arity::in, prog_context::in,
    prog_var::out, maybe(const_struct_arg)::out,
    list(hlds_goal)::out, poly_info::in, poly_info::out) is det.

polymorphism_construct_type_info(Type, TypeCtor, TypeArgs, TypeCtorIsVarArity,
        Context, Var, MCA, ExtraGoals, !Info) :-
    get_var_maps_snapshot("polymorphism_construct_type_info",
        InitialVarMapsSnapshot, !Info),

    % Create the typeinfo vars for the arguments.
    polymorphism_do_make_type_info_vars(TypeArgs, Context,
        ArgTypeInfoVarsMCAs, ArgTypeInfoGoals, !Info),

    TypeCtorConsId = type_ctor_info_cons_id(TypeCtor),
    % We record the type of type_ctor_info_cons_ids as *type_info*,
    % not *type_ctor_info*, even though the latter is the actual truth,
    % because
    %
    % - type_ctor_info consts *can* be used as type_infos, as in
    %   the then arm of the if-then-else just below;
    %
    % - the type of any type_ctor_info const *must* be recorded as
    %   type_info in such cases; and
    %
    % - the type of any type_ctor_info const that is *not* used as a type_info
    %   does not really matter, in the sense that no part of the compiler
    %   currently cares about it.
    TypeCtorConsIdConstArg = csa_constant(TypeCtorConsId, type_info_type),
    poly_info_get_const_struct_var_map(!.Info, ConstStructVarMap0),
    ( if
        map.search(ConstStructVarMap0, TypeCtorConsIdConstArg, OldTypeCtorVar)
    then
        poly_info_get_num_reuses(!.Info, NumReuses),
        poly_info_set_num_reuses(NumReuses + 1, !Info),
        TypeCtorVar = OldTypeCtorVar,
        TypeCtorGoals = []
    else
        poly_info_get_var_table(!.Info, VarTable0),
        poly_info_get_rtti_varmaps(!.Info, RttiVarMaps0),
        new_type_info_var_vt(Type, type_ctor_info, TypeCtorVar,
            VarTable0, VarTable1, RttiVarMaps0, RttiVarMaps1),
        init_const_type_ctor_info_var_from_cons_id(TypeCtorConsId, TypeCtorVar,
            TypeCtorGoal),
        TypeCtorGoals = [TypeCtorGoal],
        map.det_insert(TypeCtorConsIdConstArg, TypeCtorVar,
            ConstStructVarMap0, ConstStructVarMap1),
        poly_info_set_const_struct_var_map(ConstStructVarMap1, !Info),
        poly_info_set_var_table_rtti(VarTable1, RttiVarMaps1, !Info)
    ),

    polymorphism_maybe_construct_second_type_info_cell(Type, TypeCtor,
        TypeCtorIsVarArity, TypeCtorVar, TypeCtorConsId, TypeCtorGoals,
        ArgTypeInfoVarsMCAs, ArgTypeInfoGoals, InitialVarMapsSnapshot,
        Var, MCA, ExtraGoals, !Info).

:- type maybe_need_arity
    --->    do_not_need_arity
    ;       need_arity_in_second_ti_cell.

    % Create code that constructs the second cell of a type_info for Type
    % if we need a second cell for Type. This cell will usually have the form:
    %
    %   TypeInfoVar = type_info(TypeCtorVar, ArgTypeInfoVars...)
    %
    % However, if TypeCtorIsVarArity is tc_is_var_arity and we are
    % not compiling for the Java backend, then it will be of the form
    %
    %   TypeInfoVar = type_info(TypeCtorVar, Arity, ArgTypeInfoVars...)
    %
    % TypeCtorVar should be the variable holding the type_ctor_info for the
    % principal type constructor of Type, and TypeCtorIsVarArity should be
    % tc_is_var_arity iff the type constructor it represents has a
    % variable arity.
    %
    % ArgTypeInfoVars should be variables holding the type_infos (or
    % type_ctor_infos for zero-arity types) of the argument types of Type.
    %
    % The returned Var will be bound to the type_info cell of Type if such
    % a cell had to be allocated, and to the type_ctor_info of Type's only
    % type constructor if it didn't.
    %
    % NOTE: the special handling for the java backend must be kept
    % consistent with:
    %   rtti_to_mlds.gen_type_info_defn/6
    %   java/runtime/TypeInfo_Struct.java
    %
:- pred polymorphism_maybe_construct_second_type_info_cell(mer_type::in,
    type_ctor::in, type_ctor_is_var_arity::in,
    prog_var::in, cons_id::in, list(hlds_goal)::in,
    assoc_list(prog_var, maybe(const_struct_arg))::in, list(hlds_goal)::in,
    var_maps::in, prog_var::out, maybe(const_struct_arg)::out,
    list(hlds_goal)::out, poly_info::in, poly_info::out) is det.
:- pragma inline(pred(polymorphism_maybe_construct_second_type_info_cell/14)).

polymorphism_maybe_construct_second_type_info_cell(Type, TypeCtor,
        TypeCtorIsVarArity, TypeCtorVar, TypeCtorConsId, TypeCtorGoals,
        ArgTypeInfoVarsMCAs, ArgTypeInfoGoals, InitialVarMapsSnapshot,
        TypeInfoVar, MCA, ExtraGoals, !Info) :-
    % We have eight situations in which we have to choose between
    % three courses of action.
    %
    % The eight situations are a 2x2x2 matrix, based on
    %
    % - whether the type_ctor has arg types or not,
    % - whether the type_ctor is variable arity or not,
    % - whether we are targeting java or not.
    %
    % The three possible courses of action are
    %
    % - use a one cell type_info
    % - use a two cell type_info with no arity slot
    % - use a two cell type_info with arity slot
    %
    % The decision table is as follows:
    %
    % #     args?         arity?      java?       decision
    %
    % 1     none          fixed       no          one cell
    % 2     none          fixed       yes         one cell
    % 3     none          variable    no          two cell arity slot
    % 4     none          variable    yes         one cell
    % 5     some          fixed       no          two cell no arity slot
    % 6     some          fixed       yes         two cell no arity slot
    % 7     some          variable    no          two cell arity slot
    % 8     some          variable    yes         two cell no arity slot

    % Determine if we need to explicitly record the arity.
    (
        TypeCtorIsVarArity = tc_is_not_var_arity,
        NeedTypeCtorArity = do_not_need_arity
    ;
        TypeCtorIsVarArity = tc_is_var_arity,
        poly_info_get_module_info(!.Info, ModuleInfo),
        module_info_get_globals(ModuleInfo, Globals),
        get_target(Globals, Target),
        (
            Target = target_java,
            NeedTypeCtorArity = do_not_need_arity
        ;
            ( Target = target_c
            ; Target = target_csharp
            ),
            NeedTypeCtorArity = need_arity_in_second_ti_cell
        )
    ),

    ( if
        % If the type's type constructor has variable arity and we need
        % to record its actual arity, we cannot use a one-cell representation.
        NeedTypeCtorArity = do_not_need_arity,
        ArgTypeInfoVarsMCAs = []
    then
        % We do not need a second cell for a separate typeinfo; we will use
        % the type_ctor_info as the type_info.

        % Since this type_ctor_info is pretending to be a type_info,
        % we *would* need to adjust its type, but the code that constructed it
        % has already set its type to type_info.
        TypeInfoType = type_info_type,
        TypeCtorConstArg = csa_constant(TypeCtorConsId, TypeInfoType),
        MCA = yes(TypeCtorConstArg),
        ExtraGoals = ArgTypeInfoGoals ++ TypeCtorGoals,
        TypeInfoVar = TypeCtorVar
    else
        % We do need a second cell for a separate typeinfo.
        polymorphism_construct_second_type_info_cell(Type, TypeCtor,
            NeedTypeCtorArity, TypeCtorVar, TypeCtorConsId, TypeCtorGoals,
            ArgTypeInfoVarsMCAs, ArgTypeInfoGoals, InitialVarMapsSnapshot,
            TypeInfoVar, MCA, ExtraGoals, !Info)
    ).

:- pred polymorphism_construct_second_type_info_cell(mer_type::in,
    type_ctor::in, maybe_need_arity::in,
    prog_var::in, cons_id::in, list(hlds_goal)::in,
    assoc_list(prog_var, maybe(const_struct_arg))::in, list(hlds_goal)::in,
    var_maps::in, prog_var::out, maybe(const_struct_arg)::out,
    list(hlds_goal)::out, poly_info::in, poly_info::out) is det.
:- pragma inline(pred(polymorphism_construct_second_type_info_cell/14)).

polymorphism_construct_second_type_info_cell(Type, TypeCtor, NeedTypeCtorArity,
        TypeCtorVar, TypeCtorConsId, TypeCtorGoals,
        ArgTypeInfoVarsMCAs, ArgTypeInfoGoals, InitialVarMapsSnapshot,
        TypeInfoVar, MCA, ExtraGoals, !Info) :-
    Cell = type_info_cell(TypeCtor),
    ConsId = cell_cons_id(Cell),

    poly_info_get_const_struct_db(!.Info, ConstStructDb0),
    const_struct_db_get_poly_enabled(ConstStructDb0, Enabled),
    ( if
        Enabled = enable_const_struct_poly,
        all_are_const_struct_args(ArgTypeInfoVarsMCAs, ArgTypeInfoConstArgs)
    then
        TypeCtorConstArg = csa_constant(TypeCtorConsId, type_info_type),
        TypeCtorInst = bound(shared, inst_test_results_fgtc,
            [bound_functor(TypeCtorConsId, [])]),
        list.map(get_inst_of_const_struct_arg(ConstStructDb0),
            ArgTypeInfoConstArgs, ArgTypeInfoInsts),
        (
            NeedTypeCtorArity = need_arity_in_second_ti_cell,
            list.length(ArgTypeInfoVarsMCAs, ActualArity),
            ArityConsId = some_int_const(int_const(ActualArity)),
            ArityConstArg = csa_constant(ArityConsId, int_type),
            ArityInst = bound(shared, inst_test_results_fgtc,
                [bound_functor(ArityConsId, [])]),
            StructConstArgs =
                [TypeCtorConstArg, ArityConstArg | ArgTypeInfoConstArgs],
            StructArgInsts = [TypeCtorInst, ArityInst | ArgTypeInfoInsts]
        ;
            NeedTypeCtorArity = do_not_need_arity,
            StructConstArgs = [TypeCtorConstArg | ArgTypeInfoConstArgs],
            StructArgInsts = [TypeCtorInst | ArgTypeInfoInsts]
        ),
        StructType = type_info_type,
        list.length(StructConstArgs, NumArgs),
        InstConsId = cell_inst_cons_id(Cell, NumArgs),
        StructInst = bound(shared, inst_test_results_fgtc,
            [bound_functor(InstConsId, StructArgInsts)]),

        poly_info_get_defined_where(!.Info, DefinedWhere),
        ConstStruct = const_struct(ConsId, StructConstArgs,
            StructType, StructInst, DefinedWhere),
        lookup_insert_const_struct(ConstStruct, ConstNum,
            ConstStructDb0, ConstStructDb),
        MCA = yes(csa_const_struct(ConstNum)),
        poly_info_set_const_struct_db(ConstStructDb, !Info),

        % Throw away the updates to !Info since InitialVarMapsSnapshot
        % was taken, which contain the changes that construct the terms
        % to put into the type_info cell dynamically. We won't need those
        % changes, because we are constructing the type_info cell statically.
        set_var_maps_snapshot("maybe_init_second_cell",
            InitialVarMapsSnapshot, !Info),

        % We cannot allocate TypeInfoVar between the creation of
        % InitialVarMapsSnapshot and its restoration into !Info just above.
        % If we did, the restore would overwrite the effect of the allocation.
        % Since we only find out that we need a TypeInfoVar for Type *after*
        % we create InitialVarMapsSnapshot, this is earliest time we can
        % allocate it.
        new_type_info_var(Type, type_info, TypeInfoVar, !Info),

        Unification = construct(TypeInfoVar, type_info_const(ConstNum),
            [], [], construct_statically(born_static), cell_is_shared,
            no_construct_sub_info),
        Ground = ground(shared, none_or_default_func),
        UnifyMode = unify_modes_li_lf_ri_rf(free, Ground, Ground, Ground),
        UnifyContext = unify_context(umc_implicit("type_info_cell"), []),
        TypeInfoRHS = rhs_functor(type_info_const(ConstNum),
            is_not_exist_constr, []),
        Unify = unify(TypeInfoVar, TypeInfoRHS, UnifyMode, Unification,
            UnifyContext),

        % Create a goal_info for the unification.
        NonLocals = set_of_var.make_singleton(TypeInfoVar),
        % Note that we could be more accurate than `ground(shared)',
        % but it shouldn't make any difference.
        TypeInfoVarInst = bound(shared, inst_test_results_fgtc,
            [bound_functor(InstConsId, [])]),
        InstMapDelta =
            instmap_delta_from_assoc_list([TypeInfoVar - TypeInfoVarInst]),
        goal_info_init(NonLocals, InstMapDelta, detism_det, purity_pure,
            GoalInfo),
        TypeInfoGoal = hlds_goal(Unify, GoalInfo),
        ExtraGoals = [TypeInfoGoal]
    else
        new_type_info_var(Type, type_info, TypeInfoVar, !Info),
        assoc_list.keys(ArgTypeInfoVarsMCAs, ArgTypeInfoVars),
        (
            NeedTypeCtorArity = need_arity_in_second_ti_cell,
            list.length(ArgTypeInfoVars, ActualArity),
            get_poly_const(ActualArity, ArityVar, ArityGoals, !Info),
            % The call get_poly_const may (and probably will) allocate
            % a variable, though it shouldn't affect the rtti_varmaps.
            poly_info_get_rtti_varmaps(!.Info, RttiVarMaps1),
            init_type_info_var(Type, [TypeCtorVar, ArityVar | ArgTypeInfoVars],
                TypeInfoVar, TypeInfoGoal, RttiVarMaps1, RttiVarMaps),
            ExtraGoals = TypeCtorGoals ++ ArityGoals ++ ArgTypeInfoGoals
                ++ [TypeInfoGoal]
        ;
            NeedTypeCtorArity = do_not_need_arity,
            poly_info_get_rtti_varmaps(!.Info, RttiVarMaps0),
            init_type_info_var(Type, [TypeCtorVar | ArgTypeInfoVars],
                TypeInfoVar, TypeInfoGoal, RttiVarMaps0, RttiVarMaps),
            ExtraGoals = TypeCtorGoals ++ ArgTypeInfoGoals ++ [TypeInfoGoal]
        ),
        poly_info_set_rtti_varmaps(RttiVarMaps, !Info),
        MCA = no
    ).

%---------------------%

init_type_info_var(Type, ArgVars, TypeInfoVar, TypeInfoGoal,
        RttiVarMaps0, RttiVarMaps) :-
    type_to_ctor_det(Type, TypeCtor),
    Cell = type_info_cell(TypeCtor),
    ConsId = cell_cons_id(Cell),
    TypeInfoRHS = rhs_functor(ConsId, is_not_exist_constr, ArgVars),

    % Create the construction unification to initialize the variable.
    Ground = ground(shared, none_or_default_func),
    ArgMode = unify_modes_li_lf_ri_rf(free, Ground, Ground, Ground),
    list.length(ArgVars, NumArgVars),
    list.duplicate(NumArgVars, ArgMode, ArgModes),
    Unification = construct(TypeInfoVar, ConsId, ArgVars, ArgModes,
        construct_dynamically, cell_is_unique, no_construct_sub_info),
    UnifyMode = unify_modes_li_lf_ri_rf(free, Ground, Ground, Ground),
    % XXX The UnifyContext is wrong.
    UnifyContext = unify_context(umc_explicit, []),
    Unify = unify(TypeInfoVar, TypeInfoRHS, UnifyMode, Unification,
        UnifyContext),

    % Create a goal_info for the unification.
    set_of_var.list_to_set([TypeInfoVar | ArgVars], NonLocals),
    list.duplicate(NumArgVars, Ground, ArgInsts),
    % Note that we could perhaps be more accurate than `ground(shared)',
    % but it shouldn't make any difference.
    InstConsId = cell_inst_cons_id(Cell, NumArgVars),
    InstResults = inst_test_results(inst_result_is_ground,
        inst_result_does_not_contain_any,
        inst_result_contains_inst_names_known(set.init),
        inst_result_contains_inst_vars_unknown,
        inst_result_contains_types_unknown,
        inst_result_no_type_ctor_propagated),
    TypeInfoVarInst = bound(unique, InstResults,
        [bound_functor(InstConsId, ArgInsts)]),
    InstMapDelta = instmap_delta_from_assoc_list(
        [TypeInfoVar - TypeInfoVarInst]),
    goal_info_init(NonLocals, InstMapDelta, detism_det, purity_pure, GoalInfo),
    TypeInfoGoal = hlds_goal(Unify, GoalInfo),

    % XXX This may be a bug.
    RttiVarMaps = RttiVarMaps0.

init_const_type_ctor_info_var(Type, TypeCtor, TypeCtorInfoVar,
        ConsId, TypeCtorInfoGoal, !VarTable, !RttiVarMaps) :-
    ConsId = type_ctor_info_cons_id(TypeCtor),
    new_type_info_var_vt(Type, type_ctor_info, TypeCtorInfoVar,
        !VarTable, !RttiVarMaps),
    init_const_type_ctor_info_var_from_cons_id(ConsId, TypeCtorInfoVar,
        TypeCtorInfoGoal).

:- pred init_const_type_ctor_info_var_from_cons_id(cons_id::in, prog_var::in,
    hlds_goal::out) is det.

init_const_type_ctor_info_var_from_cons_id(ConsId, TypeCtorInfoVar,
        TypeCtorInfoGoal) :-
    % Create the construction unification to initialize the variable.
    TypeInfoRHS = rhs_functor(ConsId, is_not_exist_constr, []),
    Unification = construct(TypeCtorInfoVar, ConsId, [], [],
        construct_dynamically, cell_is_shared, no_construct_sub_info),
    Ground = ground(shared, none_or_default_func),
    UnifyMode = unify_modes_li_lf_ri_rf(free, Ground, Ground, Ground),
    % XXX The UnifyContext is wrong.
    UnifyContext = unify_context(umc_explicit, []),
    Unify = unify(TypeCtorInfoVar, TypeInfoRHS, UnifyMode,
        Unification, UnifyContext),

    % Create a goal_info for the unification.
    NonLocals = set_of_var.make_singleton(TypeCtorInfoVar),
    InstmapDelta = instmap_delta_bind_var(TypeCtorInfoVar),
    goal_info_init(NonLocals, InstmapDelta, detism_det, purity_pure, GoalInfo),
    TypeCtorInfoGoal = hlds_goal(Unify, GoalInfo).

%---------------------%

new_type_info_var(Type, Kind, Var, !Info) :-
    poly_info_get_var_table(!.Info, VarTable0),
    poly_info_get_rtti_varmaps(!.Info, RttiVarMaps0),
    new_type_info_var_vt(Type, Kind, Var, VarTable0, VarTable,
        RttiVarMaps0, RttiVarMaps),
    poly_info_set_var_table_rtti(VarTable, RttiVarMaps, !Info).

new_type_info_var_vt(Type, Kind, Var, !VarTable, !RttiVarMaps) :-
    (
        Kind = type_info,
        Prefix = "TypeInfo",
        add_prefix_number_var_entry(Prefix, type_info_type, is_not_dummy_type,
            Var, !VarTable),
        rtti_det_insert_type_info_type(Var, Type, !RttiVarMaps)
    ;
        Kind = type_ctor_info,
        Prefix = "TypeCtorInfo",
        add_prefix_number_var_entry(Prefix, type_info_type, is_not_dummy_type,
            Var, !VarTable)
        % XXX Perhaps we should record the variables holding
        % type_ctor_infos in the rtti_varmaps somewhere.
    ).

%---------------------%

poly_get_type_info_locn(TypeVar, TypeInfoLocn, !Info) :-
    % If we have already allocated a location for this type_info, then all
    % we need to do is to extract the type_info variable from its location.
    ( if
        poly_info_get_rtti_varmaps(!.Info, RttiVarMaps0),
        rtti_search_type_info_locn(RttiVarMaps0, TypeVar, TypeInfoLocnPrime)
    then
        TypeInfoLocn = TypeInfoLocnPrime
    else
        % Otherwise, we need to create a new type_info variable, and set the
        % location for this type variable to be that type_info variable.
        %
        % This is wrong if the type variable is one of the existentially
        % quantified variables of a called predicate and the variable occurs
        % in an existential typeclass constraint. In that case the type_info
        % will be stored in the typeclass_info variable produced by the
        % predicate, not in a type_info variable. maybe_extract_type_info
        % will fix this up when the typeclass_info is created.

        poly_info_get_tvar_kind_map(!.Info, TVarKindMap),
        get_tvar_kind(TVarKindMap, TypeVar, Kind),
        Type = type_variable(TypeVar, Kind),
        new_type_info_var(Type, type_info, Var, !Info),
        TypeInfoLocn = type_info(Var),
        % Since the call to new_type_info_var above may update the rtti
        % varmaps, we have to get them again here; we can't use RttiVarMaps0.
        poly_info_get_rtti_varmaps(!.Info, RttiVarMaps1),
        rtti_det_insert_type_info_locn(TypeVar, TypeInfoLocn,
            RttiVarMaps1, RttiVarMaps),
        poly_info_set_rtti_varmaps(RttiVarMaps, !Info)
    ).

poly_get_type_info_locn_raw(TVarKindMap, TypeVar, TypeInfoLocn,
        !VarTable, !RttiVarMaps) :-
    % If we have already allocated a location for this type_info, then all
    % we need to do is to extract the type_info variable from its location.
    ( if rtti_search_type_info_locn(!.RttiVarMaps, TypeVar, TypeInfoLocn0) then
        TypeInfoLocn = TypeInfoLocn0
    else
        poly_make_type_info_locn_raw(TVarKindMap, TypeVar, TypeInfoLocn,
            !VarTable, !RttiVarMaps)
    ).

    % Create a new type_info variable, and set the location for the given
    % type variable to be that type_info variable.
    %
:- pred poly_make_type_info_locn_raw(tvar_kind_map::in,
    tvar::in, type_info_locn::out, var_table::in, var_table::out,
    rtti_varmaps::in, rtti_varmaps::out) is det.

poly_make_type_info_locn_raw(TVarKindMap, TypeVar, TypeInfoLocn,
        !VarTable, !RttiVarMaps) :-
    % This is wrong if the type variable is one of the existentially
    % quantified variables of a called predicate and the variable occurs
    % in an existential typeclass constraint. In that case the type_info
    % will be stored in the typeclass_info variable produced by the
    % predicate, not in a type_info variable. maybe_extract_type_info
    % will fix this up when the typeclass_info is created.
    get_tvar_kind(TVarKindMap, TypeVar, Kind),
    Type = type_variable(TypeVar, Kind),
    new_type_info_var_vt(Type, type_info, Var, !VarTable, !RttiVarMaps),
    TypeInfoLocn = type_info(Var),
    rtti_det_insert_type_info_locn(TypeVar, TypeInfoLocn, !RttiVarMaps).

%---------------------------------------------------------------------------%

    % Generate code to get the value of a type variable.
    %
:- pred get_type_info_from_locn(tvar::in, type_info_locn::in, prog_context::in,
    prog_var::out, list(hlds_goal)::out, poly_info::in, poly_info::out) is det.

get_type_info_from_locn(TypeVar, TypeInfoLocn, Context, Var, ExtraGoals,
        !Info) :-
    (
        % If the typeinfo is available in a variable, just use it.
        TypeInfoLocn = type_info(TypeInfoVar),
        Var = TypeInfoVar,
        ExtraGoals = []
    ;
        % If the typeinfo is in a typeclass_info, then we need to extract it
        % before using it.
        TypeInfoLocn = typeclass_info(TypeClassInfoVar, Index),
        polymorphism_extract_type_info(TypeVar, TypeClassInfoVar, Index,
            Context, ExtraGoals, Var, !Info)
    ).

gen_extract_type_info(ModuleInfo, TypeVar, Kind, TypeClassInfoVar,
        IndexIntOrVar, Context, Goals, TypeInfoVar, !VarTable, !RttiVarMaps) :-
    (
        IndexIntOrVar = iov_int(Index),
        % We cannot call get_poly_const since we don't have a poly_info.
        make_int_const_construction_alloc(Index, "TypeInfoIndex",
            IndexGoal, IndexVar, !VarTable),
        IndexGoals = [IndexGoal]
    ;
        IndexIntOrVar = iov_var(IndexVar),
        IndexGoals = []
    ),
    Type = type_variable(TypeVar, Kind),
    new_type_info_var_vt(Type, type_info, TypeInfoVar,
        !VarTable, !RttiVarMaps),
    generate_plain_call(ModuleInfo, pf_predicate,
        mercury_private_builtin_module, "type_info_from_typeclass_info",
        [], [TypeClassInfoVar, IndexVar, TypeInfoVar],
        instmap_delta_bind_var(TypeInfoVar), only_mode,
        detism_det, purity_pure, [], Context, CallGoal),
    Goals = IndexGoals ++ [CallGoal].

polymorphism_extract_type_info(TypeVar, TypeClassInfoVar, Index, Context,
        Goals, TypeInfoVar, !Info) :-
    get_poly_const(Index, IndexVar, IndexGoals, !Info),
    poly_info_get_var_table(!.Info, VarTable0),
    poly_info_get_rtti_varmaps(!.Info, RttiVarMaps0),
    poly_info_get_module_info(!.Info, ModuleInfo),
    poly_info_get_tvar_kind_map(!.Info, TVarKindMap),
    get_tvar_kind(TVarKindMap, TypeVar, Kind),
    IndexIntOrVar = iov_var(IndexVar),
    gen_extract_type_info(ModuleInfo, TypeVar, Kind, TypeClassInfoVar,
        IndexIntOrVar, Context, ExtractGoals, TypeInfoVar,
        VarTable0, VarTable, RttiVarMaps0, RttiVarMaps),
    Goals = IndexGoals ++ ExtractGoals,
    poly_info_set_var_table_rtti(VarTable, RttiVarMaps, !Info).

%---------------------------------------------------------------------------%
:- end_module check_hlds.polymorphism_type_info.
%---------------------------------------------------------------------------%
