65f5290432
Define an API for, and implement, runtime support for arbitrary assignment of one descriptor's data to another, with full support for (re)allocation of allocatables with finalization when necessary, user-defined derived type assignment TBP calls, and intrinsic (default) componentwise assignment of derived type instances with allocation of automatic components. Also clean up API and implementation of finalization/destruction using knowledge gained while studying edge cases for assignment in the 2018 standard. The look-up procedure for special procedure bindings in derived types has been optimized from O(N) to O(1) since it will probably matter more. This required some analysis in runtime derived type description table construction in semantics and some changes to the table schemata. Executable Fortran tests have been developed; they'll be added to the test base once they can be lowered and run by f18. Differential Revision: https://reviews.llvm.org/D107678
46 lines
2.0 KiB
C++
46 lines
2.0 KiB
C++
//===-- runtime/assign.h --------------------------------------------------===//
|
|
//
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
// External and internal APIs for data assignment (both intrinsic assignment
|
|
// and TBP defined generic ASSIGNMENT(=)). Should be called by lowering
|
|
// for any assignments possibly needing special handling. Intrinsic assignment
|
|
// to non-allocatable variables whose types are intrinsic need not come through
|
|
// here (though they may do so). Assignments to allocatables, and assignments
|
|
// whose types may be polymorphic or are monomorphic and of derived types with
|
|
// finalization, allocatable components, or components with type-bound defined
|
|
// assignments, in the original type or the types of its non-pointer components
|
|
// (recursively) must arrive here.
|
|
//
|
|
// Non-type-bound generic INTERFACE ASSIGNMENT(=) is resolved in semantics and
|
|
// need not be handled here in the runtime; ditto for type conversions on
|
|
// intrinsic assignments.
|
|
|
|
#ifndef FLANG_RUNTIME_ASSIGN_H_
|
|
#define FLANG_RUNTIME_ASSIGN_H_
|
|
|
|
#include "entry-names.h"
|
|
|
|
namespace Fortran::runtime {
|
|
class Descriptor;
|
|
class Terminator;
|
|
|
|
// Assigns one object to another via intrinsic assignment (F'2018 10.2.1.3) or
|
|
// type-bound (only!) defined assignment (10.2.1.4), as appropriate. Performs
|
|
// finalization, scalar expansion, & allocatable (re)allocation as needed.
|
|
// Does not perform intrinsic assignment implicit type conversion. Both
|
|
// descriptors must be initialized. Recurses as needed to handle components.
|
|
void Assign(Descriptor &, const Descriptor &, Terminator &);
|
|
|
|
extern "C" {
|
|
// API for lowering assignment
|
|
void RTNAME(Assign)(Descriptor &to, const Descriptor &from,
|
|
const char *sourceFile = nullptr, int sourceLine = 0);
|
|
} // extern "C"
|
|
} // namespace Fortran::runtime
|
|
#endif // FLANG_RUNTIME_ASSIGN_H_
|