2020-12-08 06:46:24 +08:00
|
|
|
//===-- runtime/derived.cpp -----------------------------------------------===//
|
|
|
|
//
|
|
|
|
// 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
|
|
|
|
//
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
|
|
|
|
#include "derived.h"
|
2021-07-20 02:53:20 +08:00
|
|
|
#include "stat.h"
|
|
|
|
#include "terminator.h"
|
2020-12-08 06:46:24 +08:00
|
|
|
#include "type-info.h"
|
2021-09-02 07:00:53 +08:00
|
|
|
#include "flang/Runtime/descriptor.h"
|
2020-12-08 06:46:24 +08:00
|
|
|
|
|
|
|
namespace Fortran::runtime {
|
|
|
|
|
2021-07-20 02:53:20 +08:00
|
|
|
int Initialize(const Descriptor &instance, const typeInfo::DerivedType &derived,
|
|
|
|
Terminator &terminator, bool hasStat, const Descriptor *errMsg) {
|
|
|
|
const Descriptor &componentDesc{derived.component()};
|
|
|
|
std::size_t elements{instance.Elements()};
|
|
|
|
std::size_t byteStride{instance.ElementBytes()};
|
|
|
|
int stat{StatOk};
|
|
|
|
// Initialize data components in each element; the per-element iteration
|
|
|
|
// constitutes the inner loops, not outer
|
|
|
|
std::size_t myComponents{componentDesc.Elements()};
|
|
|
|
for (std::size_t k{0}; k < myComponents; ++k) {
|
|
|
|
const auto &comp{
|
|
|
|
*componentDesc.ZeroBasedIndexedElement<typeInfo::Component>(k)};
|
|
|
|
if (comp.genre() == typeInfo::Component::Genre::Allocatable ||
|
|
|
|
comp.genre() == typeInfo::Component::Genre::Automatic) {
|
|
|
|
for (std::size_t j{0}; j < elements; ++j) {
|
|
|
|
Descriptor &allocDesc{*instance.OffsetElement<Descriptor>(
|
|
|
|
j * byteStride + comp.offset())};
|
|
|
|
comp.EstablishDescriptor(allocDesc, instance, terminator);
|
|
|
|
allocDesc.raw().attribute = CFI_attribute_allocatable;
|
|
|
|
if (comp.genre() == typeInfo::Component::Genre::Automatic) {
|
|
|
|
stat = ReturnError(terminator, allocDesc.Allocate(), errMsg, hasStat);
|
|
|
|
if (stat == StatOk) {
|
|
|
|
stat = Initialize(allocDesc, derived, terminator, hasStat, errMsg);
|
|
|
|
}
|
|
|
|
if (stat != StatOk) {
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
} else if (const void *init{comp.initialization()}) {
|
|
|
|
// Explicit initialization of data pointers and
|
|
|
|
// non-allocatable non-automatic components
|
|
|
|
std::size_t bytes{comp.SizeInBytes(instance)};
|
|
|
|
for (std::size_t j{0}; j < elements; ++j) {
|
|
|
|
char *ptr{instance.OffsetElement<char>(j * byteStride + comp.offset())};
|
|
|
|
std::memcpy(ptr, init, bytes);
|
|
|
|
}
|
|
|
|
} else if (comp.genre() == typeInfo::Component::Genre::Data &&
|
|
|
|
comp.derivedType() && !comp.derivedType()->noInitializationNeeded()) {
|
|
|
|
// Default initialization of non-pointer non-allocatable/automatic
|
|
|
|
// data component. Handles parent component's elements. Recursive.
|
|
|
|
SubscriptValue extent[maxRank];
|
|
|
|
const typeInfo::Value *bounds{comp.bounds()};
|
|
|
|
for (int dim{0}; dim < comp.rank(); ++dim) {
|
|
|
|
typeInfo::TypeParameterValue lb{
|
|
|
|
bounds[2 * dim].GetValue(&instance).value_or(0)};
|
|
|
|
typeInfo::TypeParameterValue ub{
|
|
|
|
bounds[2 * dim + 1].GetValue(&instance).value_or(0)};
|
|
|
|
extent[dim] = ub >= lb ? ub - lb + 1 : 0;
|
|
|
|
}
|
|
|
|
StaticDescriptor<maxRank, true, 0> staticDescriptor;
|
|
|
|
Descriptor &compDesc{staticDescriptor.descriptor()};
|
|
|
|
const typeInfo::DerivedType &compType{*comp.derivedType()};
|
|
|
|
for (std::size_t j{0}; j < elements; ++j) {
|
|
|
|
compDesc.Establish(compType,
|
|
|
|
instance.OffsetElement<char>(j * byteStride + comp.offset()),
|
|
|
|
comp.rank(), extent);
|
|
|
|
stat = Initialize(compDesc, compType, terminator, hasStat, errMsg);
|
|
|
|
if (stat != StatOk) {
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
// Initialize procedure pointer components in each element
|
|
|
|
const Descriptor &procPtrDesc{derived.procPtr()};
|
|
|
|
std::size_t myProcPtrs{procPtrDesc.Elements()};
|
|
|
|
for (std::size_t k{0}; k < myProcPtrs; ++k) {
|
|
|
|
const auto &comp{
|
|
|
|
*procPtrDesc.ZeroBasedIndexedElement<typeInfo::ProcPtrComponent>(k)};
|
|
|
|
for (std::size_t j{0}; j < elements; ++j) {
|
|
|
|
auto &pptr{*instance.OffsetElement<typeInfo::ProcedurePointer>(
|
|
|
|
j * byteStride + comp.offset)};
|
|
|
|
pptr = comp.procInitialization;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return stat;
|
|
|
|
}
|
|
|
|
|
2020-12-08 06:46:24 +08:00
|
|
|
static const typeInfo::SpecialBinding *FindFinal(
|
|
|
|
const typeInfo::DerivedType &derived, int rank) {
|
2021-07-30 03:02:45 +08:00
|
|
|
if (const auto *ranked{derived.FindSpecialBinding(
|
|
|
|
typeInfo::SpecialBinding::RankFinal(rank))}) {
|
|
|
|
return ranked;
|
|
|
|
} else if (const auto *assumed{derived.FindSpecialBinding(
|
|
|
|
typeInfo::SpecialBinding::Which::AssumedRankFinal)}) {
|
|
|
|
return assumed;
|
|
|
|
} else {
|
|
|
|
return derived.FindSpecialBinding(
|
|
|
|
typeInfo::SpecialBinding::Which::ElementalFinal);
|
2020-12-08 06:46:24 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
static void CallFinalSubroutine(
|
|
|
|
const Descriptor &descriptor, const typeInfo::DerivedType &derived) {
|
|
|
|
if (const auto *special{FindFinal(derived, descriptor.rank())}) {
|
2021-07-20 02:53:20 +08:00
|
|
|
// The following code relies on the fact that finalizable objects
|
|
|
|
// must be contiguous.
|
2021-06-26 01:40:08 +08:00
|
|
|
if (special->which() == typeInfo::SpecialBinding::Which::ElementalFinal) {
|
2020-12-08 06:46:24 +08:00
|
|
|
std::size_t byteStride{descriptor.ElementBytes()};
|
|
|
|
std::size_t elements{descriptor.Elements()};
|
2021-07-20 02:53:20 +08:00
|
|
|
if (special->IsArgDescriptor(0)) {
|
|
|
|
StaticDescriptor<maxRank, true, 8 /*?*/> statDesc;
|
|
|
|
Descriptor &elemDesc{statDesc.descriptor()};
|
|
|
|
elemDesc = descriptor;
|
|
|
|
elemDesc.raw().attribute = CFI_attribute_pointer;
|
|
|
|
elemDesc.raw().rank = 0;
|
|
|
|
auto *p{special->GetProc<void (*)(const Descriptor &)>()};
|
|
|
|
for (std::size_t j{0}; j < elements; ++j) {
|
|
|
|
elemDesc.set_base_addr(
|
|
|
|
descriptor.OffsetElement<char>(j * byteStride));
|
|
|
|
p(elemDesc);
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
auto *p{special->GetProc<void (*)(char *)>()};
|
|
|
|
for (std::size_t j{0}; j < elements; ++j) {
|
|
|
|
p(descriptor.OffsetElement<char>(j * byteStride));
|
|
|
|
}
|
2020-12-08 06:46:24 +08:00
|
|
|
}
|
2021-06-26 01:40:08 +08:00
|
|
|
} else if (special->IsArgDescriptor(0)) {
|
2021-07-20 02:53:20 +08:00
|
|
|
StaticDescriptor<maxRank, true, 8 /*?*/> statDesc;
|
|
|
|
Descriptor &tmpDesc{statDesc.descriptor()};
|
|
|
|
tmpDesc = descriptor;
|
|
|
|
tmpDesc.raw().attribute = CFI_attribute_pointer;
|
|
|
|
tmpDesc.Addendum()->set_derivedType(&derived);
|
2021-06-26 01:40:08 +08:00
|
|
|
auto *p{special->GetProc<void (*)(const Descriptor &)>()};
|
2021-07-20 02:53:20 +08:00
|
|
|
p(tmpDesc);
|
2020-12-08 06:46:24 +08:00
|
|
|
} else {
|
2021-06-26 01:40:08 +08:00
|
|
|
auto *p{special->GetProc<void (*)(char *)>()};
|
2020-12-08 06:46:24 +08:00
|
|
|
p(descriptor.OffsetElement<char>());
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-07-30 03:02:45 +08:00
|
|
|
// Fortran 2018 subclause 7.5.6.2
|
|
|
|
void Finalize(
|
|
|
|
const Descriptor &descriptor, const typeInfo::DerivedType &derived) {
|
|
|
|
if (derived.noFinalizationNeeded() || !descriptor.IsAllocated()) {
|
|
|
|
return;
|
2020-12-08 06:46:24 +08:00
|
|
|
}
|
2021-07-30 03:02:45 +08:00
|
|
|
CallFinalSubroutine(descriptor, derived);
|
|
|
|
const auto *parentType{derived.GetParentType()};
|
|
|
|
bool recurse{parentType && !parentType->noFinalizationNeeded()};
|
|
|
|
// If there's a finalizable parent component, handle it last, as required
|
|
|
|
// by the Fortran standard (7.5.6.2), and do so recursively with the same
|
|
|
|
// descriptor so that the rank is preserved.
|
2021-06-18 04:13:19 +08:00
|
|
|
const Descriptor &componentDesc{derived.component()};
|
2021-07-20 02:53:20 +08:00
|
|
|
std::size_t myComponents{componentDesc.Elements()};
|
2020-12-08 06:46:24 +08:00
|
|
|
std::size_t elements{descriptor.Elements()};
|
|
|
|
std::size_t byteStride{descriptor.ElementBytes()};
|
2021-07-20 02:53:20 +08:00
|
|
|
for (auto k{recurse
|
|
|
|
? std::size_t{1} /* skip first component, it's the parent */
|
|
|
|
: 0};
|
|
|
|
k < myComponents; ++k) {
|
2020-12-08 06:46:24 +08:00
|
|
|
const auto &comp{
|
|
|
|
*componentDesc.ZeroBasedIndexedElement<typeInfo::Component>(k)};
|
2021-06-18 04:13:19 +08:00
|
|
|
if (comp.genre() == typeInfo::Component::Genre::Allocatable ||
|
|
|
|
comp.genre() == typeInfo::Component::Genre::Automatic) {
|
2021-07-20 02:53:20 +08:00
|
|
|
if (const typeInfo::DerivedType * compType{comp.derivedType()}) {
|
2021-07-30 03:02:45 +08:00
|
|
|
if (!compType->noFinalizationNeeded()) {
|
2021-07-20 02:53:20 +08:00
|
|
|
for (std::size_t j{0}; j < elements; ++j) {
|
2021-07-30 03:02:45 +08:00
|
|
|
const Descriptor &compDesc{*descriptor.OffsetElement<Descriptor>(
|
|
|
|
j * byteStride + comp.offset())};
|
|
|
|
if (compDesc.IsAllocated()) {
|
|
|
|
Finalize(compDesc, *compType);
|
|
|
|
}
|
2021-07-20 02:53:20 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2021-06-18 04:13:19 +08:00
|
|
|
} else if (comp.genre() == typeInfo::Component::Genre::Data &&
|
2021-07-30 03:02:45 +08:00
|
|
|
comp.derivedType() && !comp.derivedType()->noFinalizationNeeded()) {
|
2020-12-08 06:46:24 +08:00
|
|
|
SubscriptValue extent[maxRank];
|
2021-06-18 04:13:19 +08:00
|
|
|
const typeInfo::Value *bounds{comp.bounds()};
|
|
|
|
for (int dim{0}; dim < comp.rank(); ++dim) {
|
|
|
|
extent[dim] = bounds[2 * dim].GetValue(&descriptor).value_or(0) -
|
|
|
|
bounds[2 * dim + 1].GetValue(&descriptor).value_or(0) + 1;
|
2020-12-08 06:46:24 +08:00
|
|
|
}
|
|
|
|
StaticDescriptor<maxRank, true, 0> staticDescriptor;
|
|
|
|
Descriptor &compDesc{staticDescriptor.descriptor()};
|
2021-06-18 04:13:19 +08:00
|
|
|
const typeInfo::DerivedType &compType{*comp.derivedType()};
|
2020-12-08 06:46:24 +08:00
|
|
|
for (std::size_t j{0}; j < elements; ++j) {
|
|
|
|
compDesc.Establish(compType,
|
2021-06-18 04:13:19 +08:00
|
|
|
descriptor.OffsetElement<char>(j * byteStride + comp.offset()),
|
|
|
|
comp.rank(), extent);
|
2021-07-30 03:02:45 +08:00
|
|
|
Finalize(compDesc, compType);
|
2020-12-08 06:46:24 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2021-07-20 02:53:20 +08:00
|
|
|
if (recurse) {
|
2021-07-30 03:02:45 +08:00
|
|
|
Finalize(descriptor, *parentType);
|
2020-12-08 06:46:24 +08:00
|
|
|
}
|
|
|
|
}
|
2021-07-20 02:53:20 +08:00
|
|
|
|
2021-07-30 03:02:45 +08:00
|
|
|
// The order of finalization follows Fortran 2018 7.5.6.2, with
|
2021-10-05 03:40:35 +08:00
|
|
|
// elementwise finalization of non-parent components taking place
|
|
|
|
// before parent component finalization, and with all finalization
|
|
|
|
// preceding any deallocation.
|
2021-07-30 03:02:45 +08:00
|
|
|
void Destroy(const Descriptor &descriptor, bool finalize,
|
|
|
|
const typeInfo::DerivedType &derived) {
|
|
|
|
if (derived.noDestructionNeeded() || !descriptor.IsAllocated()) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
if (finalize && !derived.noFinalizationNeeded()) {
|
|
|
|
Finalize(descriptor, derived);
|
|
|
|
}
|
|
|
|
const Descriptor &componentDesc{derived.component()};
|
|
|
|
std::size_t myComponents{componentDesc.Elements()};
|
|
|
|
std::size_t elements{descriptor.Elements()};
|
|
|
|
std::size_t byteStride{descriptor.ElementBytes()};
|
|
|
|
for (std::size_t k{0}; k < myComponents; ++k) {
|
|
|
|
const auto &comp{
|
|
|
|
*componentDesc.ZeroBasedIndexedElement<typeInfo::Component>(k)};
|
|
|
|
if (comp.genre() == typeInfo::Component::Genre::Allocatable ||
|
|
|
|
comp.genre() == typeInfo::Component::Genre::Automatic) {
|
|
|
|
for (std::size_t j{0}; j < elements; ++j) {
|
|
|
|
descriptor.OffsetElement<Descriptor>(j * byteStride + comp.offset())
|
|
|
|
->Deallocate();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2021-07-20 02:53:20 +08:00
|
|
|
|
2020-12-08 06:46:24 +08:00
|
|
|
} // namespace Fortran::runtime
|