source: src/SymTab/Validate.cc @ a7c31e0

ADTarm-ehast-experimentalenumforall-pointer-decayjacob/cs343-translationnew-ast-unique-exprpthread-emulationqualifiedEnum
Last change on this file since a7c31e0 was a7c31e0, checked in by Andrew Beach <ajbeach@…>, 4 years ago

This should solve trac#217 and by its fallout the cancellation problem.

  • Property mode set to 100644
File size: 69.9 KB
RevLine 
[0dd3a2f]1//
2// Cforall Version 1.0.0 Copyright (C) 2015 University of Waterloo
3//
4// The contents of this file are covered under the licence agreement in the
5// file "LICENCE" distributed with Cforall.
6//
[9cb8e88d]7// Validate.cc --
[0dd3a2f]8//
9// Author           : Richard C. Bilson
10// Created On       : Sun May 17 21:50:04 2015
[312029a]11// Last Modified By : Peter A. Buhr
[07de76b]12// Last Modified On : Fri Dec 13 23:43:34 2019
13// Update Count     : 363
[0dd3a2f]14//
15
16// The "validate" phase of translation is used to take a syntax tree and convert it into a standard form that aims to be
17// as regular in structure as possible.  Some assumptions can be made regarding the state of the tree after this pass is
18// complete, including:
19//
20// - No nested structure or union definitions; any in the input are "hoisted" to the level of the containing struct or
21//   union.
22//
23// - All enumeration constants have type EnumInstType.
24//
[3c13c03]25// - The type "void" never occurs in lists of function parameter or return types.  A function
26//   taking no arguments has no argument types.
[0dd3a2f]27//
28// - No context instances exist; they are all replaced by the set of declarations signified by the context, instantiated
29//   by the particular set of type arguments.
30//
31// - Every declaration is assigned a unique id.
32//
33// - No typedef declarations or instances exist; the actual type is substituted for each instance.
34//
35// - Each type, struct, and union definition is followed by an appropriate assignment operator.
36//
37// - Each use of a struct or union is connected to a complete definition of that struct or union, even if that
38//   definition occurs later in the input.
[51b7345]39
[0db6fc0]40#include "Validate.h"
41
[d180746]42#include <cassert>                     // for assertf, assert
[30f9072]43#include <cstddef>                     // for size_t
[d180746]44#include <list>                        // for list
45#include <string>                      // for string
[18e683b]46#include <unordered_map>               // for unordered_map
[d180746]47#include <utility>                     // for pair
[30f9072]48
[18e683b]49#include "AST/Chain.hpp"
[c1ed2ee]50#include "AST/Decl.hpp"
51#include "AST/Node.hpp"
52#include "AST/Pass.hpp"
53#include "AST/SymbolTable.hpp"
54#include "AST/Type.hpp"
[c1398e4]55#include "AST/TypeSubstitution.hpp"
[30f9072]56#include "CodeGen/CodeGenerator.h"     // for genName
[9236060]57#include "CodeGen/OperatorTable.h"     // for isCtorDtor, isCtorDtorAssign
[25fcb84]58#include "ControlStruct/Mutate.h"      // for ForExprMutator
[18e683b]59#include "Common/CodeLocation.h"       // for CodeLocation
[7abee38]60#include "Common/Stats.h"              // for Stats::Heap
[30f9072]61#include "Common/PassVisitor.h"        // for PassVisitor, WithDeclsToAdd
[d180746]62#include "Common/ScopedMap.h"          // for ScopedMap
[30f9072]63#include "Common/SemanticError.h"      // for SemanticError
64#include "Common/UniqueName.h"         // for UniqueName
65#include "Common/utility.h"            // for operator+, cloneAll, deleteAll
[be9288a]66#include "Concurrency/Keywords.h"      // for applyKeywords
[30f9072]67#include "FixFunction.h"               // for FixFunction
68#include "Indexer.h"                   // for Indexer
[8b11840]69#include "InitTweak/GenInit.h"         // for fixReturnStatements
[d180746]70#include "InitTweak/InitTweak.h"       // for isCtorDtorAssign
71#include "ResolvExpr/typeops.h"        // for typesCompatible
[4934ea3]72#include "ResolvExpr/Resolver.h"       // for findSingleExpression
[2b79a70]73#include "ResolvExpr/ResolveTypeof.h"  // for resolveTypeof
[be9288a]74#include "SymTab/Autogen.h"            // for SizeType
[07de76b]75#include "SynTree/LinkageSpec.h"       // for C
[be9288a]76#include "SynTree/Attribute.h"         // for noAttributes, Attribute
[30f9072]77#include "SynTree/Constant.h"          // for Constant
[d180746]78#include "SynTree/Declaration.h"       // for ObjectDecl, DeclarationWithType
79#include "SynTree/Expression.h"        // for CompoundLiteralExpr, Expressio...
80#include "SynTree/Initializer.h"       // for ListInit, Initializer
81#include "SynTree/Label.h"             // for operator==, Label
82#include "SynTree/Mutator.h"           // for Mutator
83#include "SynTree/Type.h"              // for Type, TypeInstType, EnumInstType
84#include "SynTree/TypeSubstitution.h"  // for TypeSubstitution
85#include "SynTree/Visitor.h"           // for Visitor
[fd2debf]86#include "Validate/HandleAttributes.h" // for handleAttributes
[2bfc6b2]87#include "Validate/FindSpecialDecls.h" // for FindSpecialDecls
[d180746]88
89class CompoundStmt;
90class ReturnStmt;
91class SwitchStmt;
[51b7345]92
[b16923d]93#define debugPrint( x ) if ( doDebug ) x
[51b7345]94
95namespace SymTab {
[15f5c5e]96        /// hoists declarations that are difficult to hoist while parsing
97        struct HoistTypeDecls final : public WithDeclsToAdd {
[29f9e20]98                void previsit( SizeofExpr * );
99                void previsit( AlignofExpr * );
100                void previsit( UntypedOffsetofExpr * );
[95d09bdb]101                void previsit( CompoundLiteralExpr * );
[29f9e20]102                void handleType( Type * );
103        };
104
[a12c81f3]105        struct FixQualifiedTypes final : public WithIndexer {
106                Type * postmutate( QualifiedType * );
107        };
108
[a09e45b]109        struct HoistStruct final : public WithDeclsToAdd, public WithGuards {
[82dd287]110                /// Flattens nested struct types
[0dd3a2f]111                static void hoistStruct( std::list< Declaration * > &translationUnit );
[9cb8e88d]112
[a09e45b]113                void previsit( StructDecl * aggregateDecl );
114                void previsit( UnionDecl * aggregateDecl );
[0f40912]115                void previsit( StaticAssertDecl * assertDecl );
[d419d8e]116                void previsit( StructInstType * type );
117                void previsit( UnionInstType * type );
118                void previsit( EnumInstType * type );
[9cb8e88d]119
[a08ba92]120          private:
[ef5b828]121                template< typename AggDecl > void handleAggregate( AggDecl * aggregateDecl );
[c8ffe20b]122
[bdad6eb7]123                AggregateDecl * parentAggr = nullptr;
[a08ba92]124        };
[c8ffe20b]125
[cce9429]126        /// Fix return types so that every function returns exactly one value
[d24d4e1]127        struct ReturnTypeFixer {
[cce9429]128                static void fix( std::list< Declaration * > &translationUnit );
129
[0db6fc0]130                void postvisit( FunctionDecl * functionDecl );
131                void postvisit( FunctionType * ftype );
[cce9429]132        };
133
[de91427b]134        /// Replaces enum types by int, and function or array types in function parameter and return lists by appropriate pointers.
[c1ed2ee]135        struct EnumAndPointerDecay_old {
[ef5b828]136                void previsit( EnumDecl * aggregateDecl );
137                void previsit( FunctionType * func );
[a08ba92]138        };
[82dd287]139
140        /// Associates forward declarations of aggregates with their definitions
[c1ed2ee]141        struct LinkReferenceToTypes_old final : public WithIndexer, public WithGuards, public WithVisitorRef<LinkReferenceToTypes_old>, public WithShortCircuiting {
[ef5b828]142                LinkReferenceToTypes_old( const Indexer * indexer );
143                void postvisit( TypeInstType * typeInst );
[be9036d]144
[ef5b828]145                void postvisit( EnumInstType * enumInst );
146                void postvisit( StructInstType * structInst );
147                void postvisit( UnionInstType * unionInst );
148                void postvisit( TraitInstType * traitInst );
[afcb0a3]149                void previsit( QualifiedType * qualType );
150                void postvisit( QualifiedType * qualType );
[be9036d]151
[ef5b828]152                void postvisit( EnumDecl * enumDecl );
153                void postvisit( StructDecl * structDecl );
154                void postvisit( UnionDecl * unionDecl );
[522363e]155                void postvisit( TraitDecl * traitDecl );
[be9036d]156
[ef5b828]157                void previsit( StructDecl * structDecl );
158                void previsit( UnionDecl * unionDecl );
[b95fe40]159
160                void renameGenericParams( std::list< TypeDecl * > & params );
161
[06edda0]162          private:
[ef5b828]163                const Indexer * local_indexer;
[9cb8e88d]164
[c0aa336]165                typedef std::map< std::string, std::list< EnumInstType * > > ForwardEnumsType;
[0dd3a2f]166                typedef std::map< std::string, std::list< StructInstType * > > ForwardStructsType;
167                typedef std::map< std::string, std::list< UnionInstType * > > ForwardUnionsType;
[c0aa336]168                ForwardEnumsType forwardEnums;
[0dd3a2f]169                ForwardStructsType forwardStructs;
170                ForwardUnionsType forwardUnions;
[b95fe40]171                /// true if currently in a generic type body, so that type parameter instances can be renamed appropriately
172                bool inGeneric = false;
[a08ba92]173        };
[c8ffe20b]174
[06edda0]175        /// Replaces array and function types in forall lists by appropriate pointer type and assigns each Object and Function declaration a unique ID.
[c1ed2ee]176        struct ForallPointerDecay_old final {
[8b11840]177                void previsit( ObjectDecl * object );
178                void previsit( FunctionDecl * func );
[bbf3fda]179                void previsit( FunctionType * ftype );
[bd7e609]180                void previsit( StructDecl * aggrDecl );
181                void previsit( UnionDecl * aggrDecl );
[a08ba92]182        };
[c8ffe20b]183
[d24d4e1]184        struct ReturnChecker : public WithGuards {
[de91427b]185                /// Checks that return statements return nothing if their return type is void
186                /// and return something if the return type is non-void.
187                static void checkFunctionReturns( std::list< Declaration * > & translationUnit );
188
[0db6fc0]189                void previsit( FunctionDecl * functionDecl );
190                void previsit( ReturnStmt * returnStmt );
[de91427b]191
[0db6fc0]192                typedef std::list< DeclarationWithType * > ReturnVals;
193                ReturnVals returnVals;
[de91427b]194        };
195
[48ed81c]196        struct ReplaceTypedef final : public WithVisitorRef<ReplaceTypedef>, public WithGuards, public WithShortCircuiting, public WithDeclsToAdd {
197                ReplaceTypedef() : scopeLevel( 0 ) {}
[de91427b]198                /// Replaces typedefs by forward declarations
[48ed81c]199                static void replaceTypedef( std::list< Declaration * > &translationUnit );
[85c4ef0]200
[48ed81c]201                void premutate( QualifiedType * );
202                Type * postmutate( QualifiedType * qualType );
[a506df4]203                Type * postmutate( TypeInstType * aggregateUseType );
204                Declaration * postmutate( TypedefDecl * typeDecl );
205                void premutate( TypeDecl * typeDecl );
206                void premutate( FunctionDecl * funcDecl );
207                void premutate( ObjectDecl * objDecl );
208                DeclarationWithType * postmutate( ObjectDecl * objDecl );
209
210                void premutate( CastExpr * castExpr );
211
212                void premutate( CompoundStmt * compoundStmt );
213
214                void premutate( StructDecl * structDecl );
215                void premutate( UnionDecl * unionDecl );
216                void premutate( EnumDecl * enumDecl );
[0bcc2b7]217                void premutate( TraitDecl * );
[a506df4]218
[1f370451]219                void premutate( FunctionType * ftype );
220
[a506df4]221          private:
[45161b4d]222                template<typename AggDecl>
223                void addImplicitTypedef( AggDecl * aggDecl );
[48ed81c]224                template< typename AggDecl >
225                void handleAggregate( AggDecl * aggr );
[70a06f6]226
[46f6134]227                typedef std::unique_ptr<TypedefDecl> TypedefDeclPtr;
[e491159]228                typedef ScopedMap< std::string, std::pair< TypedefDeclPtr, int > > TypedefMap;
[0bcc2b7]229                typedef ScopedMap< std::string, TypeDecl * > TypeDeclMap;
[cc79d97]230                TypedefMap typedefNames;
[679864e1]231                TypeDeclMap typedeclNames;
[cc79d97]232                int scopeLevel;
[1f370451]233                bool inFunctionType = false;
[a08ba92]234        };
[c8ffe20b]235
[69918cea]236        struct EliminateTypedef {
237                /// removes TypedefDecls from the AST
238                static void eliminateTypedef( std::list< Declaration * > &translationUnit );
239
240                template<typename AggDecl>
[ef5b828]241                void handleAggregate( AggDecl * aggregateDecl );
[69918cea]242
243                void previsit( StructDecl * aggregateDecl );
244                void previsit( UnionDecl * aggregateDecl );
245                void previsit( CompoundStmt * compoundStmt );
246        };
247
[d24d4e1]248        struct VerifyCtorDtorAssign {
[d1969a6]249                /// ensure that constructors, destructors, and assignment have at least one
250                /// parameter, the first of which must be a pointer, and that ctor/dtors have no
[9cb8e88d]251                /// return values.
252                static void verify( std::list< Declaration * > &translationUnit );
253
[ef5b828]254                void previsit( FunctionDecl * funcDecl );
[5f98ce5]255        };
[70a06f6]256
[11ab8ea8]257        /// ensure that generic types have the correct number of type arguments
[d24d4e1]258        struct ValidateGenericParameters {
[0db6fc0]259                void previsit( StructInstType * inst );
260                void previsit( UnionInstType * inst );
[5f98ce5]261        };
[70a06f6]262
[2b79a70]263        struct FixObjectType : public WithIndexer {
264                /// resolves typeof type in object, function, and type declarations
265                static void fix( std::list< Declaration * > & translationUnit );
266
267                void previsit( ObjectDecl * );
268                void previsit( FunctionDecl * );
269                void previsit( TypeDecl * );
270        };
271
[4934ea3]272        struct ArrayLength : public WithIndexer {
[fbd7ad6]273                /// for array types without an explicit length, compute the length and store it so that it
274                /// is known to the rest of the phases. For example,
275                ///   int x[] = { 1, 2, 3 };
276                ///   int y[][2] = { { 1, 2, 3 }, { 1, 2, 3 } };
277                /// here x and y are known at compile-time to have length 3, so change this into
278                ///   int x[3] = { 1, 2, 3 };
279                ///   int y[3][2] = { { 1, 2, 3 }, { 1, 2, 3 } };
280                static void computeLength( std::list< Declaration * > & translationUnit );
281
[0db6fc0]282                void previsit( ObjectDecl * objDecl );
[4934ea3]283                void previsit( ArrayType * arrayType );
[fbd7ad6]284        };
285
[d24d4e1]286        struct CompoundLiteral final : public WithDeclsToAdd, public WithVisitorRef<CompoundLiteral> {
[68fe077a]287                Type::StorageClasses storageClasses;
[630a82a]288
[ef5b828]289                void premutate( ObjectDecl * objectDecl );
290                Expression * postmutate( CompoundLiteralExpr * compLitExpr );
[9cb8e88d]291        };
292
[5809461]293        struct LabelAddressFixer final : public WithGuards {
294                std::set< Label > labels;
295
296                void premutate( FunctionDecl * funcDecl );
297                Expression * postmutate( AddressExpr * addrExpr );
298        };
[4fbdfae0]299
[522363e]300        void validate( std::list< Declaration * > &translationUnit, __attribute__((unused)) bool doDebug ) {
[c1ed2ee]301                PassVisitor<EnumAndPointerDecay_old> epc;
302                PassVisitor<LinkReferenceToTypes_old> lrt( nullptr );
303                PassVisitor<ForallPointerDecay_old> fpd;
[d24d4e1]304                PassVisitor<CompoundLiteral> compoundliteral;
[0db6fc0]305                PassVisitor<ValidateGenericParameters> genericParams;
[5809461]306                PassVisitor<LabelAddressFixer> labelAddrFixer;
[15f5c5e]307                PassVisitor<HoistTypeDecls> hoistDecls;
[a12c81f3]308                PassVisitor<FixQualifiedTypes> fixQual;
[630a82a]309
[3c0d4cd]310                {
311                        Stats::Heap::newPass("validate-A");
312                        Stats::Time::BlockGuard guard("validate-A");
[98538288]313                        VerifyCtorDtorAssign::verify( translationUnit );  // must happen before autogen, because autogen examines existing ctor/dtors
[3c0d4cd]314                        acceptAll( translationUnit, hoistDecls );
315                        ReplaceTypedef::replaceTypedef( translationUnit );
316                        ReturnTypeFixer::fix( translationUnit ); // must happen before autogen
[c1ed2ee]317                        acceptAll( translationUnit, epc ); // must happen before VerifyCtorDtorAssign, because void return objects should not exist; before LinkReferenceToTypes_old because it is an indexer and needs correct types for mangling
[3c0d4cd]318                }
319                {
320                        Stats::Heap::newPass("validate-B");
321                        Stats::Time::BlockGuard guard("validate-B");
[c884f2d]322                        Stats::Time::TimeBlock("Link Reference To Types", [&]() {
323                                acceptAll( translationUnit, lrt ); // must happen before autogen, because sized flag needs to propagate to generated functions
324                        });
325                        Stats::Time::TimeBlock("Fix Qualified Types", [&]() {
[c1ed2ee]326                                mutateAll( translationUnit, fixQual ); // must happen after LinkReferenceToTypes_old, because aggregate members are accessed
[c884f2d]327                        });
328                        Stats::Time::TimeBlock("Hoist Structs", [&]() {
329                                HoistStruct::hoistStruct( translationUnit ); // must happen after EliminateTypedef, so that aggregate typedefs occur in the correct order
330                        });
331                        Stats::Time::TimeBlock("Eliminate Typedefs", [&]() {
332                                EliminateTypedef::eliminateTypedef( translationUnit ); //
333                        });
[3c0d4cd]334                }
335                {
336                        Stats::Heap::newPass("validate-C");
337                        Stats::Time::BlockGuard guard("validate-C");
[c1ed2ee]338                        acceptAll( translationUnit, genericParams );  // check as early as possible - can't happen before LinkReferenceToTypes_old
[3c0d4cd]339                        ReturnChecker::checkFunctionReturns( translationUnit );
340                        InitTweak::fixReturnStatements( translationUnit ); // must happen before autogen
341                }
342                {
343                        Stats::Heap::newPass("validate-D");
344                        Stats::Time::BlockGuard guard("validate-D");
[c884f2d]345                        Stats::Time::TimeBlock("Apply Concurrent Keywords", [&]() {
346                                Concurrency::applyKeywords( translationUnit );
347                        });
348                        Stats::Time::TimeBlock("Forall Pointer Decay", [&]() {
349                                acceptAll( translationUnit, fpd ); // must happen before autogenerateRoutines, after Concurrency::applyKeywords because uniqueIds must be set on declaration before resolution
350                        });
351                        Stats::Time::TimeBlock("Hoist Control Declarations", [&]() {
352                                ControlStruct::hoistControlDecls( translationUnit );  // hoist initialization out of for statements; must happen before autogenerateRoutines
353                        });
354                        Stats::Time::TimeBlock("Generate Autogen routines", [&]() {
[c1ed2ee]355                                autogenerateRoutines( translationUnit ); // moved up, used to be below compoundLiteral - currently needs EnumAndPointerDecay_old
[c884f2d]356                        });
[3c0d4cd]357                }
358                {
359                        Stats::Heap::newPass("validate-E");
360                        Stats::Time::BlockGuard guard("validate-E");
[c884f2d]361                        Stats::Time::TimeBlock("Implement Mutex Func", [&]() {
362                                Concurrency::implementMutexFuncs( translationUnit );
363                        });
364                        Stats::Time::TimeBlock("Implement Thread Start", [&]() {
365                                Concurrency::implementThreadStarter( translationUnit );
366                        });
367                        Stats::Time::TimeBlock("Compound Literal", [&]() {
368                                mutateAll( translationUnit, compoundliteral );
369                        });
370                        Stats::Time::TimeBlock("Resolve With Expressions", [&]() {
371                                ResolvExpr::resolveWithExprs( translationUnit ); // must happen before FixObjectType because user-code is resolved and may contain with variables
372                        });
[3c0d4cd]373                }
374                {
375                        Stats::Heap::newPass("validate-F");
376                        Stats::Time::BlockGuard guard("validate-F");
[095b99a]377                        Stats::Time::TimeCall("Fix Object Type",
378                                FixObjectType::fix, translationUnit);
379                        Stats::Time::TimeCall("Array Length",
380                                ArrayLength::computeLength, translationUnit);
381                        Stats::Time::TimeCall("Find Special Declarations",
382                                Validate::findSpecialDecls, translationUnit);
383                        Stats::Time::TimeCall("Fix Label Address",
384                                mutateAll<LabelAddressFixer>, translationUnit, labelAddrFixer);
385                        Stats::Time::TimeCall("Handle Attributes",
386                                Validate::handleAttributes, translationUnit);
[3c0d4cd]387                }
[a08ba92]388        }
[9cb8e88d]389
[ef5b828]390        void validateType( Type * type, const Indexer * indexer ) {
[c1ed2ee]391                PassVisitor<EnumAndPointerDecay_old> epc;
392                PassVisitor<LinkReferenceToTypes_old> lrt( indexer );
393                PassVisitor<ForallPointerDecay_old> fpd;
[bda58ad]394                type->accept( epc );
[cce9429]395                type->accept( lrt );
[06edda0]396                type->accept( fpd );
[a08ba92]397        }
[c8ffe20b]398
[29f9e20]399
[15f5c5e]400        void HoistTypeDecls::handleType( Type * type ) {
[29f9e20]401                // some type declarations are buried in expressions and not easy to hoist during parsing; hoist them here
402                AggregateDecl * aggr = nullptr;
403                if ( StructInstType * inst = dynamic_cast< StructInstType * >( type ) ) {
404                        aggr = inst->baseStruct;
405                } else if ( UnionInstType * inst = dynamic_cast< UnionInstType * >( type ) ) {
406                        aggr = inst->baseUnion;
407                } else if ( EnumInstType * inst = dynamic_cast< EnumInstType * >( type ) ) {
408                        aggr = inst->baseEnum;
409                }
410                if ( aggr && aggr->body ) {
411                        declsToAddBefore.push_front( aggr );
412                }
413        }
414
[15f5c5e]415        void HoistTypeDecls::previsit( SizeofExpr * expr ) {
[29f9e20]416                handleType( expr->type );
417        }
418
[15f5c5e]419        void HoistTypeDecls::previsit( AlignofExpr * expr ) {
[29f9e20]420                handleType( expr->type );
421        }
422
[15f5c5e]423        void HoistTypeDecls::previsit( UntypedOffsetofExpr * expr ) {
[29f9e20]424                handleType( expr->type );
425        }
426
[95d09bdb]427        void HoistTypeDecls::previsit( CompoundLiteralExpr * expr ) {
428                handleType( expr->result );
429        }
430
[29f9e20]431
[a12c81f3]432        Type * FixQualifiedTypes::postmutate( QualifiedType * qualType ) {
433                Type * parent = qualType->parent;
434                Type * child = qualType->child;
435                if ( dynamic_cast< GlobalScopeType * >( qualType->parent ) ) {
436                        // .T => lookup T at global scope
[062e8df]437                        if ( TypeInstType * inst = dynamic_cast< TypeInstType * >( child ) ) {
[a12c81f3]438                                auto td = indexer.globalLookupType( inst->name );
[062e8df]439                                if ( ! td ) {
440                                        SemanticError( qualType->location, toString("Use of undefined global type ", inst->name) );
441                                }
[a12c81f3]442                                auto base = td->base;
[062e8df]443                                assert( base );
[8a3ecb9]444                                Type * ret = base->clone();
445                                ret->get_qualifiers() = qualType->get_qualifiers();
446                                return ret;
[a12c81f3]447                        } else {
[062e8df]448                                // .T => T is not a type name
449                                assertf( false, "unhandled global qualified child type: %s", toCString(child) );
[a12c81f3]450                        }
451                } else {
452                        // S.T => S must be an aggregate type, find the declaration for T in S.
453                        AggregateDecl * aggr = nullptr;
454                        if ( StructInstType * inst = dynamic_cast< StructInstType * >( parent ) ) {
455                                aggr = inst->baseStruct;
456                        } else if ( UnionInstType * inst = dynamic_cast< UnionInstType * > ( parent ) ) {
457                                aggr = inst->baseUnion;
458                        } else {
[062e8df]459                                SemanticError( qualType->location, toString("Qualified type requires an aggregate on the left, but has: ", parent) );
[a12c81f3]460                        }
461                        assert( aggr ); // TODO: need to handle forward declarations
462                        for ( Declaration * member : aggr->members ) {
[7e08acf]463                                if ( TypeInstType * inst = dynamic_cast< TypeInstType * >( child ) ) {
[8a3ecb9]464                                        // name on the right is a typedef
[a12c81f3]465                                        if ( NamedTypeDecl * aggr = dynamic_cast< NamedTypeDecl * > ( member ) ) {
466                                                if ( aggr->name == inst->name ) {
[062e8df]467                                                        assert( aggr->base );
[8a3ecb9]468                                                        Type * ret = aggr->base->clone();
469                                                        ret->get_qualifiers() = qualType->get_qualifiers();
[7e08acf]470                                                        TypeSubstitution sub = parent->genericSubstitution();
471                                                        sub.apply(ret);
[8a3ecb9]472                                                        return ret;
[a12c81f3]473                                                }
474                                        }
475                                } else {
476                                        // S.T - S is not an aggregate => error
477                                        assertf( false, "unhandled qualified child type: %s", toCString(qualType) );
478                                }
479                        }
480                        // failed to find a satisfying definition of type
[062e8df]481                        SemanticError( qualType->location, toString("Undefined type in qualified type: ", qualType) );
[a12c81f3]482                }
483
484                // ... may want to link canonical SUE definition to each forward decl so that it becomes easier to lookup?
485        }
486
487
[a08ba92]488        void HoistStruct::hoistStruct( std::list< Declaration * > &translationUnit ) {
[a09e45b]489                PassVisitor<HoistStruct> hoister;
490                acceptAll( translationUnit, hoister );
[a08ba92]491        }
[c8ffe20b]492
[ef5b828]493        bool shouldHoist( Declaration * decl ) {
[0f40912]494                return dynamic_cast< StructDecl * >( decl ) || dynamic_cast< UnionDecl * >( decl ) || dynamic_cast< StaticAssertDecl * >( decl );
[a08ba92]495        }
[c0aa336]496
[d419d8e]497        namespace {
498                void qualifiedName( AggregateDecl * aggr, std::ostringstream & ss ) {
499                        if ( aggr->parent ) qualifiedName( aggr->parent, ss );
500                        ss << "__" << aggr->name;
501                }
502
503                // mangle nested type names using entire parent chain
504                std::string qualifiedName( AggregateDecl * aggr ) {
505                        std::ostringstream ss;
506                        qualifiedName( aggr, ss );
507                        return ss.str();
508                }
509        }
510
[a08ba92]511        template< typename AggDecl >
[ef5b828]512        void HoistStruct::handleAggregate( AggDecl * aggregateDecl ) {
[bdad6eb7]513                if ( parentAggr ) {
[d419d8e]514                        aggregateDecl->parent = parentAggr;
515                        aggregateDecl->name = qualifiedName( aggregateDecl );
[0dd3a2f]516                        // Add elements in stack order corresponding to nesting structure.
[a09e45b]517                        declsToAddBefore.push_front( aggregateDecl );
[0dd3a2f]518                } else {
[bdad6eb7]519                        GuardValue( parentAggr );
520                        parentAggr = aggregateDecl;
[0dd3a2f]521                } // if
522                // Always remove the hoisted aggregate from the inner structure.
[0f40912]523                GuardAction( [aggregateDecl]() { filter( aggregateDecl->members, shouldHoist, false ); } );
[a08ba92]524        }
[c8ffe20b]525
[0f40912]526        void HoistStruct::previsit( StaticAssertDecl * assertDecl ) {
527                if ( parentAggr ) {
528                        declsToAddBefore.push_back( assertDecl );
529                }
530        }
531
[a09e45b]532        void HoistStruct::previsit( StructDecl * aggregateDecl ) {
[0dd3a2f]533                handleAggregate( aggregateDecl );
[a08ba92]534        }
[c8ffe20b]535
[a09e45b]536        void HoistStruct::previsit( UnionDecl * aggregateDecl ) {
[0dd3a2f]537                handleAggregate( aggregateDecl );
[a08ba92]538        }
[c8ffe20b]539
[d419d8e]540        void HoistStruct::previsit( StructInstType * type ) {
541                // need to reset type name after expanding to qualified name
542                assert( type->baseStruct );
543                type->name = type->baseStruct->name;
544        }
545
546        void HoistStruct::previsit( UnionInstType * type ) {
547                assert( type->baseUnion );
548                type->name = type->baseUnion->name;
549        }
550
551        void HoistStruct::previsit( EnumInstType * type ) {
552                assert( type->baseEnum );
553                type->name = type->baseEnum->name;
554        }
555
556
[ef5b828]557        bool isTypedef( Declaration * decl ) {
[69918cea]558                return dynamic_cast< TypedefDecl * >( decl );
559        }
560
561        void EliminateTypedef::eliminateTypedef( std::list< Declaration * > &translationUnit ) {
562                PassVisitor<EliminateTypedef> eliminator;
563                acceptAll( translationUnit, eliminator );
564                filter( translationUnit, isTypedef, true );
565        }
566
567        template< typename AggDecl >
[ef5b828]568        void EliminateTypedef::handleAggregate( AggDecl * aggregateDecl ) {
[69918cea]569                filter( aggregateDecl->members, isTypedef, true );
570        }
571
572        void EliminateTypedef::previsit( StructDecl * aggregateDecl ) {
573                handleAggregate( aggregateDecl );
574        }
575
576        void EliminateTypedef::previsit( UnionDecl * aggregateDecl ) {
577                handleAggregate( aggregateDecl );
578        }
579
580        void EliminateTypedef::previsit( CompoundStmt * compoundStmt ) {
581                // remove and delete decl stmts
582                filter( compoundStmt->kids, [](Statement * stmt) {
[ef5b828]583                        if ( DeclStmt * declStmt = dynamic_cast< DeclStmt * >( stmt ) ) {
[69918cea]584                                if ( dynamic_cast< TypedefDecl * >( declStmt->decl ) ) {
585                                        return true;
586                                } // if
587                        } // if
588                        return false;
589                }, true);
590        }
591
[ef5b828]592        void EnumAndPointerDecay_old::previsit( EnumDecl * enumDecl ) {
[0dd3a2f]593                // Set the type of each member of the enumeration to be EnumConstant
[0b3b2ae]594                for ( std::list< Declaration * >::iterator i = enumDecl->members.begin(); i != enumDecl->members.end(); ++i ) {
[ef5b828]595                        ObjectDecl * obj = dynamic_cast< ObjectDecl * >( * i );
[0dd3a2f]596                        assert( obj );
[0b3b2ae]597                        obj->set_type( new EnumInstType( Type::Qualifiers( Type::Const ), enumDecl->name ) );
[0dd3a2f]598                } // for
[a08ba92]599        }
[51b7345]600
[a08ba92]601        namespace {
[83de11e]602                template< typename DWTList >
[4bda2cf]603                void fixFunctionList( DWTList & dwts, bool isVarArgs, FunctionType * func ) {
604                        auto nvals = dwts.size();
605                        bool containsVoid = false;
606                        for ( auto & dwt : dwts ) {
607                                // fix each DWT and record whether a void was found
608                                containsVoid |= fixFunction( dwt );
609                        }
610
611                        // the only case in which "void" is valid is where it is the only one in the list
612                        if ( containsVoid && ( nvals > 1 || isVarArgs ) ) {
[a16764a6]613                                SemanticError( func, "invalid type void in function type " );
[4bda2cf]614                        }
615
616                        // one void is the only thing in the list; remove it.
617                        if ( containsVoid ) {
618                                delete dwts.front();
619                                dwts.clear();
620                        }
[0dd3a2f]621                }
[a08ba92]622        }
[c8ffe20b]623
[ef5b828]624        void EnumAndPointerDecay_old::previsit( FunctionType * func ) {
[0dd3a2f]625                // Fix up parameters and return types
[4bda2cf]626                fixFunctionList( func->parameters, func->isVarArgs, func );
627                fixFunctionList( func->returnVals, false, func );
[a08ba92]628        }
[c8ffe20b]629
[ef5b828]630        LinkReferenceToTypes_old::LinkReferenceToTypes_old( const Indexer * other_indexer ) {
[0dd3a2f]631                if ( other_indexer ) {
[522363e]632                        local_indexer = other_indexer;
[0dd3a2f]633                } else {
[522363e]634                        local_indexer = &indexer;
[0dd3a2f]635                } // if
[a08ba92]636        }
[c8ffe20b]637
[ef5b828]638        void LinkReferenceToTypes_old::postvisit( EnumInstType * enumInst ) {
[8fd52e9]639                const EnumDecl * st = local_indexer->lookupEnum( enumInst->name );
[c0aa336]640                // it's not a semantic error if the enum is not found, just an implicit forward declaration
641                if ( st ) {
[8fd52e9]642                        enumInst->baseEnum = const_cast<EnumDecl *>(st); // Just linking in the node
[c0aa336]643                } // if
[29f9e20]644                if ( ! st || ! st->body ) {
[c0aa336]645                        // use of forward declaration
[eaa6430]646                        forwardEnums[ enumInst->name ].push_back( enumInst );
[c0aa336]647                } // if
648        }
649
[48fa824]650        void checkGenericParameters( ReferenceToType * inst ) {
651                for ( Expression * param : inst->parameters ) {
652                        if ( ! dynamic_cast< TypeExpr * >( param ) ) {
[a16764a6]653                                SemanticError( inst, "Expression parameters for generic types are currently unsupported: " );
[48fa824]654                        }
655                }
656        }
657
[ef5b828]658        void LinkReferenceToTypes_old::postvisit( StructInstType * structInst ) {
[8fd52e9]659                const StructDecl * st = local_indexer->lookupStruct( structInst->name );
[0dd3a2f]660                // it's not a semantic error if the struct is not found, just an implicit forward declaration
661                if ( st ) {
[8fd52e9]662                        structInst->baseStruct = const_cast<StructDecl *>(st); // Just linking in the node
[0dd3a2f]663                } // if
[29f9e20]664                if ( ! st || ! st->body ) {
[0dd3a2f]665                        // use of forward declaration
[eaa6430]666                        forwardStructs[ structInst->name ].push_back( structInst );
[0dd3a2f]667                } // if
[48fa824]668                checkGenericParameters( structInst );
[a08ba92]669        }
[c8ffe20b]670
[ef5b828]671        void LinkReferenceToTypes_old::postvisit( UnionInstType * unionInst ) {
[8fd52e9]672                const UnionDecl * un = local_indexer->lookupUnion( unionInst->name );
[0dd3a2f]673                // it's not a semantic error if the union is not found, just an implicit forward declaration
674                if ( un ) {
[8fd52e9]675                        unionInst->baseUnion = const_cast<UnionDecl *>(un); // Just linking in the node
[0dd3a2f]676                } // if
[29f9e20]677                if ( ! un || ! un->body ) {
[0dd3a2f]678                        // use of forward declaration
[eaa6430]679                        forwardUnions[ unionInst->name ].push_back( unionInst );
[0dd3a2f]680                } // if
[48fa824]681                checkGenericParameters( unionInst );
[a08ba92]682        }
[c8ffe20b]683
[c1ed2ee]684        void LinkReferenceToTypes_old::previsit( QualifiedType * ) {
[afcb0a3]685                visit_children = false;
686        }
687
[c1ed2ee]688        void LinkReferenceToTypes_old::postvisit( QualifiedType * qualType ) {
[afcb0a3]689                // linking only makes sense for the 'oldest ancestor' of the qualified type
[ef5b828]690                qualType->parent->accept( * visitor );
[afcb0a3]691        }
692
[be9036d]693        template< typename Decl >
694        void normalizeAssertions( std::list< Decl * > & assertions ) {
695                // ensure no duplicate trait members after the clone
696                auto pred = [](Decl * d1, Decl * d2) {
697                        // only care if they're equal
698                        DeclarationWithType * dwt1 = dynamic_cast<DeclarationWithType *>( d1 );
699                        DeclarationWithType * dwt2 = dynamic_cast<DeclarationWithType *>( d2 );
700                        if ( dwt1 && dwt2 ) {
[eaa6430]701                                if ( dwt1->name == dwt2->name && ResolvExpr::typesCompatible( dwt1->get_type(), dwt2->get_type(), SymTab::Indexer() ) ) {
[be9036d]702                                        // std::cerr << "=========== equal:" << std::endl;
703                                        // std::cerr << "d1: " << d1 << std::endl;
704                                        // std::cerr << "d2: " << d2 << std::endl;
705                                        return false;
706                                }
[2c57025]707                        }
[be9036d]708                        return d1 < d2;
709                };
710                std::set<Decl *, decltype(pred)> unique_members( assertions.begin(), assertions.end(), pred );
711                // if ( unique_members.size() != assertions.size() ) {
712                //      std::cerr << "============different" << std::endl;
713                //      std::cerr << unique_members.size() << " " << assertions.size() << std::endl;
714                // }
715
716                std::list< Decl * > order;
717                order.splice( order.end(), assertions );
718                std::copy_if( order.begin(), order.end(), back_inserter( assertions ), [&]( Decl * decl ) {
719                        return unique_members.count( decl );
720                });
721        }
722
723        // expand assertions from trait instance, performing the appropriate type variable substitutions
724        template< typename Iterator >
725        void expandAssertions( TraitInstType * inst, Iterator out ) {
[eaa6430]726                assertf( inst->baseTrait, "Trait instance not linked to base trait: %s", toCString( inst ) );
[be9036d]727                std::list< DeclarationWithType * > asserts;
728                for ( Declaration * decl : inst->baseTrait->members ) {
[e3e16bc]729                        asserts.push_back( strict_dynamic_cast<DeclarationWithType *>( decl->clone() ) );
[2c57025]730                }
[be9036d]731                // substitute trait decl parameters for instance parameters
732                applySubstitution( inst->baseTrait->parameters.begin(), inst->baseTrait->parameters.end(), inst->parameters.begin(), asserts.begin(), asserts.end(), out );
733        }
734
[c1ed2ee]735        void LinkReferenceToTypes_old::postvisit( TraitDecl * traitDecl ) {
[be9036d]736                if ( traitDecl->name == "sized" ) {
737                        // "sized" is a special trait - flick the sized status on for the type variable
738                        assertf( traitDecl->parameters.size() == 1, "Built-in trait 'sized' has incorrect number of parameters: %zd", traitDecl->parameters.size() );
739                        TypeDecl * td = traitDecl->parameters.front();
740                        td->set_sized( true );
741                }
742
743                // move assertions from type parameters into the body of the trait
744                for ( TypeDecl * td : traitDecl->parameters ) {
745                        for ( DeclarationWithType * assert : td->assertions ) {
746                                if ( TraitInstType * inst = dynamic_cast< TraitInstType * >( assert->get_type() ) ) {
747                                        expandAssertions( inst, back_inserter( traitDecl->members ) );
748                                } else {
749                                        traitDecl->members.push_back( assert->clone() );
750                                }
751                        }
752                        deleteAll( td->assertions );
753                        td->assertions.clear();
754                } // for
755        }
[2ae171d8]756
[c1ed2ee]757        void LinkReferenceToTypes_old::postvisit( TraitInstType * traitInst ) {
[2ae171d8]758                // handle other traits
[8fd52e9]759                const TraitDecl * traitDecl = local_indexer->lookupTrait( traitInst->name );
[4a9ccc3]760                if ( ! traitDecl ) {
[a16764a6]761                        SemanticError( traitInst->location, "use of undeclared trait " + traitInst->name );
[17cd4eb]762                } // if
[0b3b2ae]763                if ( traitDecl->parameters.size() != traitInst->parameters.size() ) {
[a16764a6]764                        SemanticError( traitInst, "incorrect number of trait parameters: " );
[4a9ccc3]765                } // if
[8fd52e9]766                traitInst->baseTrait = const_cast<TraitDecl *>(traitDecl); // Just linking in the node
[79970ed]767
[4a9ccc3]768                // need to carry over the 'sized' status of each decl in the instance
[eaa6430]769                for ( auto p : group_iterate( traitDecl->parameters, traitInst->parameters ) ) {
[5c4d27f]770                        TypeExpr * expr = dynamic_cast< TypeExpr * >( std::get<1>(p) );
771                        if ( ! expr ) {
[a16764a6]772                                SemanticError( std::get<1>(p), "Expression parameters for trait instances are currently unsupported: " );
[5c4d27f]773                        }
[4a9ccc3]774                        if ( TypeInstType * inst = dynamic_cast< TypeInstType * >( expr->get_type() ) ) {
775                                TypeDecl * formalDecl = std::get<0>(p);
[eaa6430]776                                TypeDecl * instDecl = inst->baseType;
[4a9ccc3]777                                if ( formalDecl->get_sized() ) instDecl->set_sized( true );
778                        }
779                }
[be9036d]780                // normalizeAssertions( traitInst->members );
[a08ba92]781        }
[c8ffe20b]782
[ef5b828]783        void LinkReferenceToTypes_old::postvisit( EnumDecl * enumDecl ) {
[c0aa336]784                // visit enum members first so that the types of self-referencing members are updated properly
[b16923d]785                if ( enumDecl->body ) {
[eaa6430]786                        ForwardEnumsType::iterator fwds = forwardEnums.find( enumDecl->name );
[c0aa336]787                        if ( fwds != forwardEnums.end() ) {
788                                for ( std::list< EnumInstType * >::iterator inst = fwds->second.begin(); inst != fwds->second.end(); ++inst ) {
[ef5b828]789                                        (* inst)->baseEnum = enumDecl;
[c0aa336]790                                } // for
791                                forwardEnums.erase( fwds );
792                        } // if
[ac3362c]793
794                        for ( Declaration * member : enumDecl->members ) {
795                                ObjectDecl * field = strict_dynamic_cast<ObjectDecl *>( member );
796                                if ( field->init ) {
797                                        // need to resolve enumerator initializers early so that other passes that determine if an expression is constexpr have the appropriate information.
798                                        SingleInit * init = strict_dynamic_cast<SingleInit *>( field->init );
799                                        ResolvExpr::findSingleExpression( init->value, new BasicType( Type::Qualifiers(), BasicType::SignedInt ), indexer );
800                                }
801                        }
[c0aa336]802                } // if
803        }
804
[c1ed2ee]805        void LinkReferenceToTypes_old::renameGenericParams( std::list< TypeDecl * > & params ) {
[b95fe40]806                // rename generic type parameters uniquely so that they do not conflict with user-defined function forall parameters, e.g.
807                //   forall(otype T)
808                //   struct Box {
809                //     T x;
810                //   };
811                //   forall(otype T)
812                //   void f(Box(T) b) {
813                //     ...
814                //   }
815                // The T in Box and the T in f are different, so internally the naming must reflect that.
816                GuardValue( inGeneric );
817                inGeneric = ! params.empty();
818                for ( TypeDecl * td : params ) {
819                        td->name = "__" + td->name + "_generic_";
820                }
821        }
822
[c1ed2ee]823        void LinkReferenceToTypes_old::previsit( StructDecl * structDecl ) {
[b95fe40]824                renameGenericParams( structDecl->parameters );
825        }
826
[c1ed2ee]827        void LinkReferenceToTypes_old::previsit( UnionDecl * unionDecl ) {
[b95fe40]828                renameGenericParams( unionDecl->parameters );
829        }
830
[ef5b828]831        void LinkReferenceToTypes_old::postvisit( StructDecl * structDecl ) {
[677c1be]832                // visit struct members first so that the types of self-referencing members are updated properly
[522363e]833                // xxx - need to ensure that type parameters match up between forward declarations and definition (most importantly, number of type parameters and their defaults)
[b16923d]834                if ( structDecl->body ) {
[eaa6430]835                        ForwardStructsType::iterator fwds = forwardStructs.find( structDecl->name );
[0dd3a2f]836                        if ( fwds != forwardStructs.end() ) {
837                                for ( std::list< StructInstType * >::iterator inst = fwds->second.begin(); inst != fwds->second.end(); ++inst ) {
[ef5b828]838                                        (* inst)->baseStruct = structDecl;
[0dd3a2f]839                                } // for
840                                forwardStructs.erase( fwds );
841                        } // if
842                } // if
[a08ba92]843        }
[c8ffe20b]844
[ef5b828]845        void LinkReferenceToTypes_old::postvisit( UnionDecl * unionDecl ) {
[b16923d]846                if ( unionDecl->body ) {
[eaa6430]847                        ForwardUnionsType::iterator fwds = forwardUnions.find( unionDecl->name );
[0dd3a2f]848                        if ( fwds != forwardUnions.end() ) {
849                                for ( std::list< UnionInstType * >::iterator inst = fwds->second.begin(); inst != fwds->second.end(); ++inst ) {
[ef5b828]850                                        (* inst)->baseUnion = unionDecl;
[0dd3a2f]851                                } // for
852                                forwardUnions.erase( fwds );
853                        } // if
854                } // if
[a08ba92]855        }
[c8ffe20b]856
[ef5b828]857        void LinkReferenceToTypes_old::postvisit( TypeInstType * typeInst ) {
[b95fe40]858                // ensure generic parameter instances are renamed like the base type
859                if ( inGeneric && typeInst->baseType ) typeInst->name = typeInst->baseType->name;
[ef5b828]860                if ( const NamedTypeDecl * namedTypeDecl = local_indexer->lookupType( typeInst->name ) ) {
861                        if ( const TypeDecl * typeDecl = dynamic_cast< const TypeDecl * >( namedTypeDecl ) ) {
862                                typeInst->set_isFtype( typeDecl->kind == TypeDecl::Ftype );
[0dd3a2f]863                        } // if
864                } // if
[a08ba92]865        }
[c8ffe20b]866
[4a9ccc3]867        /// Fix up assertions - flattens assertion lists, removing all trait instances
[8b11840]868        void forallFixer( std::list< TypeDecl * > & forall, BaseSyntaxNode * node ) {
869                for ( TypeDecl * type : forall ) {
[be9036d]870                        std::list< DeclarationWithType * > asserts;
871                        asserts.splice( asserts.end(), type->assertions );
872                        // expand trait instances into their members
873                        for ( DeclarationWithType * assertion : asserts ) {
[ef5b828]874                                if ( TraitInstType * traitInst = dynamic_cast< TraitInstType * >( assertion->get_type() ) ) {
[be9036d]875                                        // expand trait instance into all of its members
876                                        expandAssertions( traitInst, back_inserter( type->assertions ) );
877                                        delete traitInst;
878                                } else {
879                                        // pass other assertions through
880                                        type->assertions.push_back( assertion );
881                                } // if
882                        } // for
883                        // apply FixFunction to every assertion to check for invalid void type
884                        for ( DeclarationWithType *& assertion : type->assertions ) {
[4bda2cf]885                                bool isVoid = fixFunction( assertion );
886                                if ( isVoid ) {
[a16764a6]887                                        SemanticError( node, "invalid type void in assertion of function " );
[be9036d]888                                } // if
889                        } // for
890                        // normalizeAssertions( type->assertions );
[0dd3a2f]891                } // for
[a08ba92]892        }
[c8ffe20b]893
[ef5b828]894        void ForallPointerDecay_old::previsit( ObjectDecl * object ) {
[3d2b7bc]895                // ensure that operator names only apply to functions or function pointers
896                if ( CodeGen::isOperator( object->name ) && ! dynamic_cast< FunctionType * >( object->type->stripDeclarator() ) ) {
897                        SemanticError( object->location, toCString( "operator ", object->name.c_str(), " is not a function or function pointer." )  );
898                }
[0dd3a2f]899                object->fixUniqueId();
[a08ba92]900        }
[c8ffe20b]901
[ef5b828]902        void ForallPointerDecay_old::previsit( FunctionDecl * func ) {
[0dd3a2f]903                func->fixUniqueId();
[a08ba92]904        }
[c8ffe20b]905
[c1ed2ee]906        void ForallPointerDecay_old::previsit( FunctionType * ftype ) {
[bbf3fda]907                forallFixer( ftype->forall, ftype );
908        }
909
[c1ed2ee]910        void ForallPointerDecay_old::previsit( StructDecl * aggrDecl ) {
[bd7e609]911                forallFixer( aggrDecl->parameters, aggrDecl );
912        }
913
[c1ed2ee]914        void ForallPointerDecay_old::previsit( UnionDecl * aggrDecl ) {
[bd7e609]915                forallFixer( aggrDecl->parameters, aggrDecl );
916        }
917
[de91427b]918        void ReturnChecker::checkFunctionReturns( std::list< Declaration * > & translationUnit ) {
[0db6fc0]919                PassVisitor<ReturnChecker> checker;
[de91427b]920                acceptAll( translationUnit, checker );
921        }
922
[0db6fc0]923        void ReturnChecker::previsit( FunctionDecl * functionDecl ) {
[0508ab3]924                GuardValue( returnVals );
[de91427b]925                returnVals = functionDecl->get_functionType()->get_returnVals();
926        }
927
[0db6fc0]928        void ReturnChecker::previsit( ReturnStmt * returnStmt ) {
[74d1804]929                // Previously this also checked for the existence of an expr paired with no return values on
930                // the  function return type. This is incorrect, since you can have an expression attached to
931                // a return statement in a void-returning function in C. The expression is treated as if it
932                // were cast to void.
[30f9072]933                if ( ! returnStmt->get_expr() && returnVals.size() != 0 ) {
[a16764a6]934                        SemanticError( returnStmt, "Non-void function returns no values: " );
[de91427b]935                }
936        }
937
938
[48ed81c]939        void ReplaceTypedef::replaceTypedef( std::list< Declaration * > &translationUnit ) {
940                PassVisitor<ReplaceTypedef> eliminator;
[0dd3a2f]941                mutateAll( translationUnit, eliminator );
[a506df4]942                if ( eliminator.pass.typedefNames.count( "size_t" ) ) {
[5f98ce5]943                        // grab and remember declaration of size_t
[2bfc6b2]944                        Validate::SizeType = eliminator.pass.typedefNames["size_t"].first->base->clone();
[5f98ce5]945                } else {
[40e636a]946                        // xxx - missing global typedef for size_t - default to long unsigned int, even though that may be wrong
947                        // eventually should have a warning for this case.
[2bfc6b2]948                        Validate::SizeType = new BasicType( Type::Qualifiers(), BasicType::LongUnsignedInt );
[5f98ce5]949                }
[a08ba92]950        }
[c8ffe20b]951
[48ed81c]952        void ReplaceTypedef::premutate( QualifiedType * ) {
953                visit_children = false;
954        }
955
956        Type * ReplaceTypedef::postmutate( QualifiedType * qualType ) {
957                // replacing typedefs only makes sense for the 'oldest ancestor' of the qualified type
[ef5b828]958                qualType->parent = qualType->parent->acceptMutator( * visitor );
[48ed81c]959                return qualType;
960        }
961
[a7c31e0]962        static bool isNonParameterAttribute( Attribute * attr ) {
963                static const std::vector<std::string> bad_names = {
964                        "aligned", "__aligned__",
965                };
966                for ( auto name : bad_names ) {
967                        if ( name == attr->name ) {
968                                return true;
969                        }
970                }
971                return false;
972        }
973
[48ed81c]974        Type * ReplaceTypedef::postmutate( TypeInstType * typeInst ) {
[9cb8e88d]975                // instances of typedef types will come here. If it is an instance
[cc79d97]976                // of a typdef type, link the instance to its actual type.
[0b3b2ae]977                TypedefMap::const_iterator def = typedefNames.find( typeInst->name );
[0dd3a2f]978                if ( def != typedefNames.end() ) {
[ef5b828]979                        Type * ret = def->second.first->base->clone();
[e82ef13]980                        ret->location = typeInst->location;
[6f95000]981                        ret->get_qualifiers() |= typeInst->get_qualifiers();
[a7c31e0]982                        // GCC ignores certain attributes if they arrive by typedef, this mimics that.
983                        if ( inFunctionType ) {
984                                ret->attributes.remove_if( isNonParameterAttribute );
[1f370451]985                        }
[a7c31e0]986                        ret->attributes.splice( ret->attributes.end(), typeInst->attributes );
[0215a76f]987                        // place instance parameters on the typedef'd type
[f53836b]988                        if ( ! typeInst->parameters.empty() ) {
[ef5b828]989                                ReferenceToType * rtt = dynamic_cast<ReferenceToType *>(ret);
[0215a76f]990                                if ( ! rtt ) {
[a16764a6]991                                        SemanticError( typeInst->location, "Cannot apply type parameters to base type of " + typeInst->name );
[0215a76f]992                                }
[0b3b2ae]993                                rtt->parameters.clear();
[f53836b]994                                cloneAll( typeInst->parameters, rtt->parameters );
[ef5b828]995                                mutateAll( rtt->parameters, * visitor );  // recursively fix typedefs on parameters
[1db21619]996                        } // if
[0dd3a2f]997                        delete typeInst;
998                        return ret;
[679864e1]999                } else {
[0b3b2ae]1000                        TypeDeclMap::const_iterator base = typedeclNames.find( typeInst->name );
[062e8df]1001                        if ( base == typedeclNames.end() ) {
1002                                SemanticError( typeInst->location, toString("Use of undefined type ", typeInst->name) );
1003                        }
[1e8b02f5]1004                        typeInst->set_baseType( base->second );
[062e8df]1005                        return typeInst;
[0dd3a2f]1006                } // if
[062e8df]1007                assert( false );
[a08ba92]1008        }
[c8ffe20b]1009
[f53836b]1010        struct VarLenChecker : WithShortCircuiting {
1011                void previsit( FunctionType * ) { visit_children = false; }
1012                void previsit( ArrayType * at ) {
1013                        isVarLen |= at->isVarLen;
1014                }
1015                bool isVarLen = false;
1016        };
1017
1018        bool isVariableLength( Type * t ) {
1019                PassVisitor<VarLenChecker> varLenChecker;
1020                maybeAccept( t, varLenChecker );
1021                return varLenChecker.pass.isVarLen;
1022        }
1023
[48ed81c]1024        Declaration * ReplaceTypedef::postmutate( TypedefDecl * tyDecl ) {
[0b3b2ae]1025                if ( typedefNames.count( tyDecl->name ) == 1 && typedefNames[ tyDecl->name ].second == scopeLevel ) {
[9cb8e88d]1026                        // typedef to the same name from the same scope
[cc79d97]1027                        // must be from the same type
1028
[0b3b2ae]1029                        Type * t1 = tyDecl->base;
1030                        Type * t2 = typedefNames[ tyDecl->name ].first->base;
[1cbca6e]1031                        if ( ! ResolvExpr::typesCompatible( t1, t2, Indexer() ) ) {
[a16764a6]1032                                SemanticError( tyDecl->location, "Cannot redefine typedef: " + tyDecl->name );
[f53836b]1033                        }
[4b97770]1034                        // Cannot redefine VLA typedefs. Note: this is slightly incorrect, because our notion of VLAs
1035                        // at this point in the translator is imprecise. In particular, this will disallow redefining typedefs
1036                        // with arrays whose dimension is an enumerator or a cast of a constant/enumerator. The effort required
1037                        // to fix this corner case likely outweighs the utility of allowing it.
[f53836b]1038                        if ( isVariableLength( t1 ) || isVariableLength( t2 ) ) {
[a16764a6]1039                                SemanticError( tyDecl->location, "Cannot redefine typedef: " + tyDecl->name );
[85c4ef0]1040                        }
[cc79d97]1041                } else {
[0b3b2ae]1042                        typedefNames[ tyDecl->name ] = std::make_pair( TypedefDeclPtr( tyDecl ), scopeLevel );
[cc79d97]1043                } // if
1044
[0dd3a2f]1045                // When a typedef is a forward declaration:
1046                //    typedef struct screen SCREEN;
1047                // the declaration portion must be retained:
1048                //    struct screen;
1049                // because the expansion of the typedef is:
[ef5b828]1050                //    void rtn( SCREEN * p ) => void rtn( struct screen * p )
[0dd3a2f]1051                // hence the type-name "screen" must be defined.
1052                // Note, qualifiers on the typedef are superfluous for the forward declaration.
[6f95000]1053
[ef5b828]1054                Type * designatorType = tyDecl->base->stripDeclarator();
1055                if ( StructInstType * aggDecl = dynamic_cast< StructInstType * >( designatorType ) ) {
[312029a]1056                        declsToAddBefore.push_back( new StructDecl( aggDecl->name, AggregateDecl::Struct, noAttributes, tyDecl->linkage ) );
[ef5b828]1057                } else if ( UnionInstType * aggDecl = dynamic_cast< UnionInstType * >( designatorType ) ) {
[48ed81c]1058                        declsToAddBefore.push_back( new UnionDecl( aggDecl->name, noAttributes, tyDecl->linkage ) );
[ef5b828]1059                } else if ( EnumInstType * enumDecl = dynamic_cast< EnumInstType * >( designatorType ) ) {
[48ed81c]1060                        declsToAddBefore.push_back( new EnumDecl( enumDecl->name, noAttributes, tyDecl->linkage ) );
[0dd3a2f]1061                } // if
[48ed81c]1062                return tyDecl->clone();
[a08ba92]1063        }
[c8ffe20b]1064
[48ed81c]1065        void ReplaceTypedef::premutate( TypeDecl * typeDecl ) {
[0b3b2ae]1066                TypedefMap::iterator i = typedefNames.find( typeDecl->name );
[0dd3a2f]1067                if ( i != typedefNames.end() ) {
1068                        typedefNames.erase( i ) ;
1069                } // if
[679864e1]1070
[0bcc2b7]1071                typedeclNames.insert( typeDecl->name, typeDecl );
[a08ba92]1072        }
[c8ffe20b]1073
[48ed81c]1074        void ReplaceTypedef::premutate( FunctionDecl * ) {
[a506df4]1075                GuardScope( typedefNames );
[0bcc2b7]1076                GuardScope( typedeclNames );
[a08ba92]1077        }
[c8ffe20b]1078
[48ed81c]1079        void ReplaceTypedef::premutate( ObjectDecl * ) {
[a506df4]1080                GuardScope( typedefNames );
[0bcc2b7]1081                GuardScope( typedeclNames );
[a506df4]1082        }
[dd020c0]1083
[48ed81c]1084        DeclarationWithType * ReplaceTypedef::postmutate( ObjectDecl * objDecl ) {
[ef5b828]1085                if ( FunctionType * funtype = dynamic_cast<FunctionType *>( objDecl->type ) ) { // function type?
[02e5ab6]1086                        // replace the current object declaration with a function declaration
[0b3b2ae]1087                        FunctionDecl * newDecl = new FunctionDecl( objDecl->name, objDecl->get_storageClasses(), objDecl->linkage, funtype, 0, objDecl->attributes, objDecl->get_funcSpec() );
1088                        objDecl->attributes.clear();
[dbe8f244]1089                        objDecl->set_type( nullptr );
[0a86a30]1090                        delete objDecl;
1091                        return newDecl;
[1db21619]1092                } // if
[a506df4]1093                return objDecl;
[a08ba92]1094        }
[c8ffe20b]1095
[48ed81c]1096        void ReplaceTypedef::premutate( CastExpr * ) {
[a506df4]1097                GuardScope( typedefNames );
[0bcc2b7]1098                GuardScope( typedeclNames );
[a08ba92]1099        }
[c8ffe20b]1100
[48ed81c]1101        void ReplaceTypedef::premutate( CompoundStmt * ) {
[a506df4]1102                GuardScope( typedefNames );
[0bcc2b7]1103                GuardScope( typedeclNames );
[cc79d97]1104                scopeLevel += 1;
[a506df4]1105                GuardAction( [this](){ scopeLevel -= 1; } );
1106        }
1107
[45161b4d]1108        template<typename AggDecl>
[48ed81c]1109        void ReplaceTypedef::addImplicitTypedef( AggDecl * aggDecl ) {
[45161b4d]1110                if ( typedefNames.count( aggDecl->get_name() ) == 0 ) {
[ef5b828]1111                        Type * type = nullptr;
[45161b4d]1112                        if ( StructDecl * newDeclStructDecl = dynamic_cast< StructDecl * >( aggDecl ) ) {
1113                                type = new StructInstType( Type::Qualifiers(), newDeclStructDecl->get_name() );
1114                        } else if ( UnionDecl * newDeclUnionDecl = dynamic_cast< UnionDecl * >( aggDecl ) ) {
1115                                type = new UnionInstType( Type::Qualifiers(), newDeclUnionDecl->get_name() );
1116                        } else if ( EnumDecl * newDeclEnumDecl = dynamic_cast< EnumDecl * >( aggDecl )  ) {
1117                                type = new EnumInstType( Type::Qualifiers(), newDeclEnumDecl->get_name() );
1118                        } // if
[0b0f1dd]1119                        TypedefDeclPtr tyDecl( new TypedefDecl( aggDecl->get_name(), aggDecl->location, Type::StorageClasses(), type, aggDecl->get_linkage() ) );
[46f6134]1120                        typedefNames[ aggDecl->get_name() ] = std::make_pair( std::move( tyDecl ), scopeLevel );
[48ed81c]1121                        // add the implicit typedef to the AST
1122                        declsToAddBefore.push_back( new TypedefDecl( aggDecl->get_name(), aggDecl->location, Type::StorageClasses(), type->clone(), aggDecl->get_linkage() ) );
[45161b4d]1123                } // if
1124        }
[4e06c1e]1125
[48ed81c]1126        template< typename AggDecl >
1127        void ReplaceTypedef::handleAggregate( AggDecl * aggr ) {
1128                SemanticErrorException errors;
[a506df4]1129
[48ed81c]1130                ValueGuard< std::list<Declaration * > > oldBeforeDecls( declsToAddBefore );
1131                ValueGuard< std::list<Declaration * > > oldAfterDecls ( declsToAddAfter  );
1132                declsToAddBefore.clear();
1133                declsToAddAfter.clear();
[a506df4]1134
[48ed81c]1135                GuardScope( typedefNames );
[0bcc2b7]1136                GuardScope( typedeclNames );
[ef5b828]1137                mutateAll( aggr->parameters, * visitor );
[85c4ef0]1138
[48ed81c]1139                // unroll mutateAll for aggr->members so that implicit typedefs for nested types are added to the aggregate body.
1140                for ( std::list< Declaration * >::iterator i = aggr->members.begin(); i != aggr->members.end(); ++i ) {
1141                        if ( !declsToAddAfter.empty() ) { aggr->members.splice( i, declsToAddAfter ); }
[a506df4]1142
[48ed81c]1143                        try {
[ef5b828]1144                                * i = maybeMutate( * i, * visitor );
[48ed81c]1145                        } catch ( SemanticErrorException &e ) {
1146                                errors.append( e );
1147                        }
1148
1149                        if ( !declsToAddBefore.empty() ) { aggr->members.splice( i, declsToAddBefore ); }
1150                }
1151
1152                if ( !declsToAddAfter.empty() ) { aggr->members.splice( aggr->members.end(), declsToAddAfter ); }
1153                if ( !errors.isEmpty() ) { throw errors; }
[85c4ef0]1154        }
1155
[48ed81c]1156        void ReplaceTypedef::premutate( StructDecl * structDecl ) {
1157                visit_children = false;
1158                addImplicitTypedef( structDecl );
1159                handleAggregate( structDecl );
[a506df4]1160        }
1161
[48ed81c]1162        void ReplaceTypedef::premutate( UnionDecl * unionDecl ) {
1163                visit_children = false;
1164                addImplicitTypedef( unionDecl );
1165                handleAggregate( unionDecl );
[85c4ef0]1166        }
1167
[48ed81c]1168        void ReplaceTypedef::premutate( EnumDecl * enumDecl ) {
1169                addImplicitTypedef( enumDecl );
[85c4ef0]1170        }
1171
[48ed81c]1172        void ReplaceTypedef::premutate( FunctionType * ) {
[1f370451]1173                GuardValue( inFunctionType );
1174                inFunctionType = true;
1175        }
1176
[0bcc2b7]1177        void ReplaceTypedef::premutate( TraitDecl * ) {
1178                GuardScope( typedefNames );
1179                GuardScope( typedeclNames);
1180        }
1181
[d1969a6]1182        void VerifyCtorDtorAssign::verify( std::list< Declaration * > & translationUnit ) {
[0db6fc0]1183                PassVisitor<VerifyCtorDtorAssign> verifier;
[9cb8e88d]1184                acceptAll( translationUnit, verifier );
1185        }
1186
[0db6fc0]1187        void VerifyCtorDtorAssign::previsit( FunctionDecl * funcDecl ) {
[9cb8e88d]1188                FunctionType * funcType = funcDecl->get_functionType();
1189                std::list< DeclarationWithType * > &returnVals = funcType->get_returnVals();
1190                std::list< DeclarationWithType * > &params = funcType->get_parameters();
1191
[bff227f]1192                if ( CodeGen::isCtorDtorAssign( funcDecl->get_name() ) ) { // TODO: also check /=, etc.
[9cb8e88d]1193                        if ( params.size() == 0 ) {
[98538288]1194                                SemanticError( funcDecl->location, "Constructors, destructors, and assignment functions require at least one parameter." );
[9cb8e88d]1195                        }
[ce8c12f]1196                        ReferenceType * refType = dynamic_cast< ReferenceType * >( params.front()->get_type() );
[084fecc]1197                        if ( ! refType ) {
[98538288]1198                                SemanticError( funcDecl->location, "First parameter of a constructor, destructor, or assignment function must be a reference." );
[9cb8e88d]1199                        }
[bff227f]1200                        if ( CodeGen::isCtorDtor( funcDecl->get_name() ) && returnVals.size() != 0 ) {
[98538288]1201                                if(!returnVals.front()->get_type()->isVoid()) {
1202                                        SemanticError( funcDecl->location, "Constructors and destructors cannot have explicit return values." );
1203                                }
[9cb8e88d]1204                        }
1205                }
1206        }
[70a06f6]1207
[11ab8ea8]1208        template< typename Aggr >
1209        void validateGeneric( Aggr * inst ) {
1210                std::list< TypeDecl * > * params = inst->get_baseParameters();
[30f9072]1211                if ( params ) {
[11ab8ea8]1212                        std::list< Expression * > & args = inst->get_parameters();
[67cf18c]1213
1214                        // insert defaults arguments when a type argument is missing (currently only supports missing arguments at the end of the list).
1215                        // A substitution is used to ensure that defaults are replaced correctly, e.g.,
1216                        //   forall(otype T, otype alloc = heap_allocator(T)) struct vector;
1217                        //   vector(int) v;
1218                        // after insertion of default values becomes
1219                        //   vector(int, heap_allocator(T))
1220                        // and the substitution is built with T=int so that after substitution, the result is
1221                        //   vector(int, heap_allocator(int))
1222                        TypeSubstitution sub;
1223                        auto paramIter = params->begin();
1224                        for ( size_t i = 0; paramIter != params->end(); ++paramIter, ++i ) {
1225                                if ( i < args.size() ) {
[ef5b828]1226                                        TypeExpr * expr = strict_dynamic_cast< TypeExpr * >( * std::next( args.begin(), i ) );
1227                                        sub.add( (* paramIter)->get_name(), expr->get_type()->clone() );
[67cf18c]1228                                } else if ( i == args.size() ) {
[ef5b828]1229                                        Type * defaultType = (* paramIter)->get_init();
[67cf18c]1230                                        if ( defaultType ) {
1231                                                args.push_back( new TypeExpr( defaultType->clone() ) );
[ef5b828]1232                                                sub.add( (* paramIter)->get_name(), defaultType->clone() );
[67cf18c]1233                                        }
1234                                }
1235                        }
1236
1237                        sub.apply( inst );
[a16764a6]1238                        if ( args.size() < params->size() ) SemanticError( inst, "Too few type arguments in generic type " );
1239                        if ( args.size() > params->size() ) SemanticError( inst, "Too many type arguments in generic type " );
[11ab8ea8]1240                }
1241        }
1242
[0db6fc0]1243        void ValidateGenericParameters::previsit( StructInstType * inst ) {
[11ab8ea8]1244                validateGeneric( inst );
1245        }
[9cb8e88d]1246
[0db6fc0]1247        void ValidateGenericParameters::previsit( UnionInstType * inst ) {
[11ab8ea8]1248                validateGeneric( inst );
[9cb8e88d]1249        }
[70a06f6]1250
[ef5b828]1251        void CompoundLiteral::premutate( ObjectDecl * objectDecl ) {
[a7c90d4]1252                storageClasses = objectDecl->get_storageClasses();
[630a82a]1253        }
1254
[ef5b828]1255        Expression * CompoundLiteral::postmutate( CompoundLiteralExpr * compLitExpr ) {
[630a82a]1256                // transform [storage_class] ... (struct S){ 3, ... };
1257                // into [storage_class] struct S temp =  { 3, ... };
1258                static UniqueName indexName( "_compLit" );
1259
[ef5b828]1260                ObjectDecl * tempvar = new ObjectDecl( indexName.newName(), storageClasses, LinkageSpec::C, nullptr, compLitExpr->get_result(), compLitExpr->get_initializer() );
[d24d4e1]1261                compLitExpr->set_result( nullptr );
1262                compLitExpr->set_initializer( nullptr );
[630a82a]1263                delete compLitExpr;
[d24d4e1]1264                declsToAddBefore.push_back( tempvar );                                  // add modified temporary to current block
1265                return new VariableExpr( tempvar );
[630a82a]1266        }
[cce9429]1267
1268        void ReturnTypeFixer::fix( std::list< Declaration * > &translationUnit ) {
[0db6fc0]1269                PassVisitor<ReturnTypeFixer> fixer;
[cce9429]1270                acceptAll( translationUnit, fixer );
1271        }
1272
[0db6fc0]1273        void ReturnTypeFixer::postvisit( FunctionDecl * functionDecl ) {
[9facf3b]1274                FunctionType * ftype = functionDecl->get_functionType();
1275                std::list< DeclarationWithType * > & retVals = ftype->get_returnVals();
[56e49b0]1276                assertf( retVals.size() == 0 || retVals.size() == 1, "Function %s has too many return values: %zu", functionDecl->get_name().c_str(), retVals.size() );
[9facf3b]1277                if ( retVals.size() == 1 ) {
[861799c]1278                        // ensure all function return values have a name - use the name of the function to disambiguate (this also provides a nice bit of help for debugging).
1279                        // ensure other return values have a name.
[9facf3b]1280                        DeclarationWithType * ret = retVals.front();
1281                        if ( ret->get_name() == "" ) {
1282                                ret->set_name( toString( "_retval_", CodeGen::genName( functionDecl ) ) );
1283                        }
[c6d2e93]1284                        ret->get_attributes().push_back( new Attribute( "unused" ) );
[9facf3b]1285                }
1286        }
[cce9429]1287
[0db6fc0]1288        void ReturnTypeFixer::postvisit( FunctionType * ftype ) {
[cce9429]1289                // xxx - need to handle named return values - this information needs to be saved somehow
1290                // so that resolution has access to the names.
1291                // Note that this pass needs to happen early so that other passes which look for tuple types
1292                // find them in all of the right places, including function return types.
1293                std::list< DeclarationWithType * > & retVals = ftype->get_returnVals();
1294                if ( retVals.size() > 1 ) {
1295                        // generate a single return parameter which is the tuple of all of the return values
[e3e16bc]1296                        TupleType * tupleType = strict_dynamic_cast< TupleType * >( ResolvExpr::extractResultType( ftype ) );
[cce9429]1297                        // ensure return value is not destructed by explicitly creating an empty ListInit node wherein maybeConstruct is false.
[ef5b828]1298                        ObjectDecl * newRet = new ObjectDecl( "", Type::StorageClasses(), LinkageSpec::Cforall, 0, tupleType, new ListInit( std::list<Initializer *>(), noDesignators, false ) );
[cce9429]1299                        deleteAll( retVals );
1300                        retVals.clear();
1301                        retVals.push_back( newRet );
1302                }
1303        }
[fbd7ad6]1304
[2b79a70]1305        void FixObjectType::fix( std::list< Declaration * > & translationUnit ) {
1306                PassVisitor<FixObjectType> fixer;
1307                acceptAll( translationUnit, fixer );
1308        }
1309
1310        void FixObjectType::previsit( ObjectDecl * objDecl ) {
[ef5b828]1311                Type * new_type = ResolvExpr::resolveTypeof( objDecl->get_type(), indexer );
[2b79a70]1312                objDecl->set_type( new_type );
1313        }
1314
1315        void FixObjectType::previsit( FunctionDecl * funcDecl ) {
[ef5b828]1316                Type * new_type = ResolvExpr::resolveTypeof( funcDecl->type, indexer );
[2b79a70]1317                funcDecl->set_type( new_type );
1318        }
1319
[ef5b828]1320        void FixObjectType::previsit( TypeDecl * typeDecl ) {
[2b79a70]1321                if ( typeDecl->get_base() ) {
[ef5b828]1322                        Type * new_type = ResolvExpr::resolveTypeof( typeDecl->get_base(), indexer );
[2b79a70]1323                        typeDecl->set_base( new_type );
1324                } // if
1325        }
1326
[fbd7ad6]1327        void ArrayLength::computeLength( std::list< Declaration * > & translationUnit ) {
[0db6fc0]1328                PassVisitor<ArrayLength> len;
[fbd7ad6]1329                acceptAll( translationUnit, len );
1330        }
1331
[0db6fc0]1332        void ArrayLength::previsit( ObjectDecl * objDecl ) {
[0b3b2ae]1333                if ( ArrayType * at = dynamic_cast< ArrayType * >( objDecl->type ) ) {
[f072892]1334                        if ( at->dimension ) return;
[0b3b2ae]1335                        if ( ListInit * init = dynamic_cast< ListInit * >( objDecl->init ) ) {
[f072892]1336                                at->dimension = new ConstantExpr( Constant::from_ulong( init->initializers.size() ) );
[fbd7ad6]1337                        }
1338                }
1339        }
[4fbdfae0]1340
[4934ea3]1341        void ArrayLength::previsit( ArrayType * type ) {
1342                if ( type->dimension ) {
1343                        // need to resolve array dimensions early so that constructor code can correctly determine
1344                        // if a type is a VLA (and hence whether its elements need to be constructed)
[2bfc6b2]1345                        ResolvExpr::findSingleExpression( type->dimension, Validate::SizeType->clone(), indexer );
[4934ea3]1346
1347                        // must re-evaluate whether a type is a VLA, now that more information is available
1348                        // (e.g. the dimension may have been an enumerator, which was unknown prior to this step)
1349                        type->isVarLen = ! InitTweak::isConstExpr( type->dimension );
1350                }
1351        }
1352
[5809461]1353        struct LabelFinder {
1354                std::set< Label > & labels;
1355                LabelFinder( std::set< Label > & labels ) : labels( labels ) {}
1356                void previsit( Statement * stmt ) {
1357                        for ( Label & l : stmt->labels ) {
1358                                labels.insert( l );
1359                        }
1360                }
1361        };
1362
1363        void LabelAddressFixer::premutate( FunctionDecl * funcDecl ) {
1364                GuardValue( labels );
1365                PassVisitor<LabelFinder> finder( labels );
1366                funcDecl->accept( finder );
1367        }
1368
1369        Expression * LabelAddressFixer::postmutate( AddressExpr * addrExpr ) {
1370                // convert &&label into label address
1371                if ( AddressExpr * inner = dynamic_cast< AddressExpr * >( addrExpr->arg ) ) {
1372                        if ( NameExpr * nameExpr = dynamic_cast< NameExpr * >( inner->arg ) ) {
1373                                if ( labels.count( nameExpr->name ) ) {
1374                                        Label name = nameExpr->name;
1375                                        delete addrExpr;
1376                                        return new LabelAddressExpr( name );
1377                                }
1378                        }
1379                }
1380                return addrExpr;
1381        }
[c8e4d2f8]1382
[c1ed2ee]1383namespace {
[ef5b828]1384        /// Replaces enum types by int, and function/array types in function parameter and return
[c1ed2ee]1385        /// lists by appropriate pointers
1386        struct EnumAndPointerDecay_new {
1387                const ast::EnumDecl * previsit( const ast::EnumDecl * enumDecl ) {
1388                        // set the type of each member of the enumeration to be EnumConstant
1389                        for ( unsigned i = 0; i < enumDecl->members.size(); ++i ) {
1390                                // build new version of object with EnumConstant
[ef5b828]1391                                ast::ptr< ast::ObjectDecl > obj =
[c1ed2ee]1392                                        enumDecl->members[i].strict_as< ast::ObjectDecl >();
[ef5b828]1393                                obj.get_and_mutate()->type =
[c1ed2ee]1394                                        new ast::EnumInstType{ enumDecl->name, ast::CV::Const };
[ef5b828]1395
[c1ed2ee]1396                                // set into decl
1397                                ast::EnumDecl * mut = mutate( enumDecl );
1398                                mut->members[i] = obj.get();
1399                                enumDecl = mut;
1400                        }
1401                        return enumDecl;
1402                }
1403
1404                static const ast::FunctionType * fixFunctionList(
[ef5b828]1405                        const ast::FunctionType * func,
[c1ed2ee]1406                        std::vector< ast::ptr< ast::DeclWithType > > ast::FunctionType::* field,
1407                        ast::ArgumentFlag isVarArgs = ast::FixedArgs
1408                ) {
[ef5b828]1409                        const auto & dwts = func->* field;
[c1ed2ee]1410                        unsigned nvals = dwts.size();
1411                        bool hasVoid = false;
1412                        for ( unsigned i = 0; i < nvals; ++i ) {
1413                                func = ast::mutate_field_index( func, field, i, fixFunction( dwts[i], hasVoid ) );
1414                        }
[ef5b828]1415
[c1ed2ee]1416                        // the only case in which "void" is valid is where it is the only one in the list
1417                        if ( hasVoid && ( nvals > 1 || isVarArgs ) ) {
[ef5b828]1418                                SemanticError(
[c1ed2ee]1419                                        dwts.front()->location, func, "invalid type void in function type" );
1420                        }
1421
1422                        // one void is the only thing in the list, remove it
1423                        if ( hasVoid ) {
[ef5b828]1424                                func = ast::mutate_field(
[c1ed2ee]1425                                        func, field, std::vector< ast::ptr< ast::DeclWithType > >{} );
1426                        }
1427
1428                        return func;
1429                }
1430
1431                const ast::FunctionType * previsit( const ast::FunctionType * func ) {
1432                        func = fixFunctionList( func, &ast::FunctionType::params, func->isVarArgs );
1433                        return fixFunctionList( func, &ast::FunctionType::returns );
1434                }
1435        };
1436
[c1398e4]1437        /// expand assertions from a trait instance, performing appropriate type variable substitutions
[ef5b828]1438        void expandAssertions(
1439                const ast::TraitInstType * inst, std::vector< ast::ptr< ast::DeclWithType > > & out
[c1398e4]1440        ) {
1441                assertf( inst->base, "Trait instance not linked to base trait: %s", toCString( inst ) );
1442
1443                // build list of trait members, substituting trait decl parameters for instance parameters
[ef5b828]1444                ast::TypeSubstitution sub{
[c1398e4]1445                        inst->base->params.begin(), inst->base->params.end(), inst->params.begin() };
1446                // deliberately take ast::ptr by-value to ensure this does not mutate inst->base
1447                for ( ast::ptr< ast::Decl > decl : inst->base->members ) {
1448                        auto member = decl.strict_as< ast::DeclWithType >();
1449                        sub.apply( member );
1450                        out.emplace_back( member );
1451                }
1452        }
1453
[c1ed2ee]1454        /// Associates forward declarations of aggregates with their definitions
[ef5b828]1455        class LinkReferenceToTypes_new final
1456        : public ast::WithSymbolTable, public ast::WithGuards, public
[c1ed2ee]1457          ast::WithVisitorRef<LinkReferenceToTypes_new>, public ast::WithShortCircuiting {
[ef5b828]1458
1459                // these maps of uses of forward declarations of types need to have the actual type
1460                // declaration switched in * after * they have been traversed. To enable this in the
1461                // ast::Pass framework, any node that needs to be so mutated has mutate() called on it
1462                // before it is placed in the map, properly updating its parents in the usual traversal,
[18e683b]1463                // then can have the actual mutation applied later
1464                using ForwardEnumsType = std::unordered_multimap< std::string, ast::EnumInstType * >;
1465                using ForwardStructsType = std::unordered_multimap< std::string, ast::StructInstType * >;
1466                using ForwardUnionsType = std::unordered_multimap< std::string, ast::UnionInstType * >;
[ef5b828]1467
[18e683b]1468                const CodeLocation & location;
1469                const ast::SymbolTable * localSymtab;
[ef5b828]1470
[18e683b]1471                ForwardEnumsType forwardEnums;
1472                ForwardStructsType forwardStructs;
1473                ForwardUnionsType forwardUnions;
[c1ed2ee]1474
[ef5b828]1475                /// true if currently in a generic type body, so that type parameter instances can be
[18e683b]1476                /// renamed appropriately
1477                bool inGeneric = false;
[c1ed2ee]1478
[18e683b]1479        public:
1480                /// contstruct using running symbol table
[ef5b828]1481                LinkReferenceToTypes_new( const CodeLocation & loc )
[18e683b]1482                : location( loc ), localSymtab( &symtab ) {}
[ef5b828]1483
[18e683b]1484                /// construct using provided symbol table
[ef5b828]1485                LinkReferenceToTypes_new( const CodeLocation & loc, const ast::SymbolTable & syms )
[18e683b]1486                : location( loc ), localSymtab( &syms ) {}
1487
1488                const ast::Type * postvisit( const ast::TypeInstType * typeInst ) {
1489                        // ensure generic parameter instances are renamed like the base type
1490                        if ( inGeneric && typeInst->base ) {
[ef5b828]1491                                typeInst = ast::mutate_field(
[18e683b]1492                                        typeInst, &ast::TypeInstType::name, typeInst->base->name );
1493                        }
1494
[ef5b828]1495                        if (
1496                                auto typeDecl = dynamic_cast< const ast::TypeDecl * >(
1497                                        localSymtab->lookupType( typeInst->name ) )
[18e683b]1498                        ) {
1499                                typeInst = ast::mutate_field( typeInst, &ast::TypeInstType::kind, typeDecl->kind );
1500                        }
1501
1502                        return typeInst;
1503                }
1504
1505                const ast::Type * postvisit( const ast::EnumInstType * inst ) {
1506                        const ast::EnumDecl * decl = localSymtab->lookupEnum( inst->name );
1507                        // not a semantic error if the enum is not found, just an implicit forward declaration
1508                        if ( decl ) {
1509                                inst = ast::mutate_field( inst, &ast::EnumInstType::base, decl );
1510                        }
1511                        if ( ! decl || ! decl->body ) {
1512                                // forward declaration
1513                                auto mut = mutate( inst );
1514                                forwardEnums.emplace( inst->name, mut );
1515                                inst = mut;
1516                        }
1517                        return inst;
1518                }
1519
[98e8b3b]1520                void checkGenericParameters( const ast::BaseInstType * inst ) {
[18e683b]1521                        for ( const ast::Expr * param : inst->params ) {
1522                                if ( ! dynamic_cast< const ast::TypeExpr * >( param ) ) {
[ef5b828]1523                                        SemanticError(
[18e683b]1524                                                location, inst, "Expression parameters for generic types are currently "
1525                                                "unsupported: " );
1526                                }
1527                        }
1528                }
1529
1530                const ast::StructInstType * postvisit( const ast::StructInstType * inst ) {
1531                        const ast::StructDecl * decl = localSymtab->lookupStruct( inst->name );
1532                        // not a semantic error if the struct is not found, just an implicit forward declaration
1533                        if ( decl ) {
1534                                inst = ast::mutate_field( inst, &ast::StructInstType::base, decl );
1535                        }
1536                        if ( ! decl || ! decl->body ) {
1537                                // forward declaration
1538                                auto mut = mutate( inst );
1539                                forwardStructs.emplace( inst->name, mut );
1540                                inst = mut;
1541                        }
1542                        checkGenericParameters( inst );
1543                        return inst;
1544                }
1545
1546                const ast::UnionInstType * postvisit( const ast::UnionInstType * inst ) {
1547                        const ast::UnionDecl * decl = localSymtab->lookupUnion( inst->name );
1548                        // not a semantic error if the struct is not found, just an implicit forward declaration
1549                        if ( decl ) {
1550                                inst = ast::mutate_field( inst, &ast::UnionInstType::base, decl );
1551                        }
1552                        if ( ! decl || ! decl->body ) {
1553                                // forward declaration
1554                                auto mut = mutate( inst );
1555                                forwardUnions.emplace( inst->name, mut );
1556                                inst = mut;
1557                        }
1558                        checkGenericParameters( inst );
1559                        return inst;
1560                }
1561
1562                const ast::Type * postvisit( const ast::TraitInstType * traitInst ) {
1563                        // handle other traits
1564                        const ast::TraitDecl * traitDecl = localSymtab->lookupTrait( traitInst->name );
1565                        if ( ! traitDecl )       {
1566                                SemanticError( location, "use of undeclared trait " + traitInst->name );
1567                        }
1568                        if ( traitDecl->params.size() != traitInst->params.size() ) {
1569                                SemanticError( location, traitInst, "incorrect number of trait parameters: " );
1570                        }
1571                        traitInst = ast::mutate_field( traitInst, &ast::TraitInstType::base, traitDecl );
1572
1573                        // need to carry over the "sized" status of each decl in the instance
1574                        for ( unsigned i = 0; i < traitDecl->params.size(); ++i ) {
1575                                auto expr = traitInst->params[i].as< ast::TypeExpr >();
1576                                if ( ! expr ) {
[ef5b828]1577                                        SemanticError(
[18e683b]1578                                                traitInst->params[i].get(), "Expression parameters for trait instances "
1579                                                "are currently unsupported: " );
1580                                }
1581
1582                                if ( auto inst = expr->type.as< ast::TypeInstType >() ) {
1583                                        if ( traitDecl->params[i]->sized && ! inst->base->sized ) {
1584                                                // traitInst = ast::mutate_field_index(
1585                                                //      traitInst, &ast::TraitInstType::params, i,
1586                                                //      ...
1587                                                // );
1588                                                ast::TraitInstType * mut = ast::mutate( traitInst );
1589                                                ast::chain_mutate( mut->params[i] )
1590                                                        ( &ast::TypeExpr::type )
1591                                                                ( &ast::TypeInstType::base )->sized = true;
1592                                                traitInst = mut;
1593                                        }
1594                                }
1595                        }
1596
1597                        return traitInst;
1598                }
[ef5b828]1599
[18e683b]1600                void previsit( const ast::QualifiedType * ) { visit_children = false; }
[ef5b828]1601
[18e683b]1602                const ast::Type * postvisit( const ast::QualifiedType * qualType ) {
1603                        // linking only makes sense for the "oldest ancestor" of the qualified type
[ef5b828]1604                        return ast::mutate_field(
1605                                qualType, &ast::QualifiedType::parent, qualType->parent->accept( * visitor ) );
[18e683b]1606                }
1607
1608                const ast::Decl * postvisit( const ast::EnumDecl * enumDecl ) {
[ef5b828]1609                        // visit enum members first so that the types of self-referencing members are updated
[18e683b]1610                        // properly
1611                        if ( ! enumDecl->body ) return enumDecl;
1612
1613                        // update forward declarations to point here
1614                        auto fwds = forwardEnums.equal_range( enumDecl->name );
1615                        if ( fwds.first != fwds.second ) {
1616                                auto inst = fwds.first;
1617                                do {
[ef5b828]1618                                        // forward decl is stored * mutably * in map, can thus be updated
[18e683b]1619                                        inst->second->base = enumDecl;
1620                                } while ( ++inst != fwds.second );
1621                                forwardEnums.erase( fwds.first, fwds.second );
1622                        }
[ef5b828]1623
[18e683b]1624                        // ensure that enumerator initializers are properly set
1625                        for ( unsigned i = 0; i < enumDecl->members.size(); ++i ) {
1626                                auto field = enumDecl->members[i].strict_as< ast::ObjectDecl >();
1627                                if ( field->init ) {
[ef5b828]1628                                        // need to resolve enumerator initializers early so that other passes that
[18e683b]1629                                        // determine if an expression is constexpr have appropriate information
1630                                        auto init = field->init.strict_as< ast::SingleInit >();
[ef5b828]1631
1632                                        enumDecl = ast::mutate_field_index(
1633                                                enumDecl, &ast::EnumDecl::members, i,
1634                                                ast::mutate_field( field, &ast::ObjectDecl::init,
[18e683b]1635                                                        ast::mutate_field( init, &ast::SingleInit::value,
[ef5b828]1636                                                                ResolvExpr::findSingleExpression(
[18e683b]1637                                                                        init->value, new ast::BasicType{ ast::BasicType::SignedInt },
1638                                                                        symtab ) ) ) );
1639                                }
1640                        }
1641
1642                        return enumDecl;
1643                }
1644
[ef5b828]1645                /// rename generic type parameters uniquely so that they do not conflict with user defined
[18e683b]1646                /// function forall parameters, e.g. the T in Box and the T in f, below
1647                ///   forall(otype T)
1648                ///   struct Box {
1649                ///     T x;
1650                ///   };
1651                ///   forall(otype T)
1652                ///   void f(Box(T) b) {
1653                ///     ...
1654                ///   }
1655                template< typename AggrDecl >
1656                const AggrDecl * renameGenericParams( const AggrDecl * aggr ) {
1657                        GuardValue( inGeneric );
1658                        inGeneric = ! aggr->params.empty();
1659
1660                        for ( unsigned i = 0; i < aggr->params.size(); ++i ) {
1661                                const ast::TypeDecl * td = aggr->params[i];
1662
[ef5b828]1663                                aggr = ast::mutate_field_index(
1664                                        aggr, &AggrDecl::params, i,
[18e683b]1665                                        ast::mutate_field( td, &ast::TypeDecl::name, "__" + td->name + "_generic_" ) );
1666                        }
1667                        return aggr;
1668                }
1669
1670                const ast::StructDecl * previsit( const ast::StructDecl * structDecl ) {
1671                        return renameGenericParams( structDecl );
1672                }
1673
1674                void postvisit( const ast::StructDecl * structDecl ) {
[ef5b828]1675                        // visit struct members first so that the types of self-referencing members are
[18e683b]1676                        // updated properly
1677                        if ( ! structDecl->body ) return;
1678
1679                        // update forward declarations to point here
1680                        auto fwds = forwardStructs.equal_range( structDecl->name );
1681                        if ( fwds.first != fwds.second ) {
1682                                auto inst = fwds.first;
1683                                do {
[ef5b828]1684                                        // forward decl is stored * mutably * in map, can thus be updated
[18e683b]1685                                        inst->second->base = structDecl;
1686                                } while ( ++inst != fwds.second );
1687                                forwardStructs.erase( fwds.first, fwds.second );
1688                        }
1689                }
1690
1691                const ast::UnionDecl * previsit( const ast::UnionDecl * unionDecl ) {
1692                        return renameGenericParams( unionDecl );
1693                }
1694
1695                void postvisit( const ast::UnionDecl * unionDecl ) {
[ef5b828]1696                        // visit union members first so that the types of self-referencing members are updated
[18e683b]1697                        // properly
1698                        if ( ! unionDecl->body ) return;
1699
1700                        // update forward declarations to point here
1701                        auto fwds = forwardUnions.equal_range( unionDecl->name );
1702                        if ( fwds.first != fwds.second ) {
1703                                auto inst = fwds.first;
1704                                do {
[ef5b828]1705                                        // forward decl is stored * mutably * in map, can thus be updated
[18e683b]1706                                        inst->second->base = unionDecl;
1707                                } while ( ++inst != fwds.second );
1708                                forwardUnions.erase( fwds.first, fwds.second );
1709                        }
1710                }
1711
1712                const ast::Decl * postvisit( const ast::TraitDecl * traitDecl ) {
1713                        // set the "sized" status for the special "sized" trait
[c1398e4]1714                        if ( traitDecl->name == "sized" ) {
1715                                assertf( traitDecl->params.size() == 1, "Built-in trait 'sized' has incorrect "
1716                                        "number of parameters: %zd", traitDecl->params.size() );
1717
[ef5b828]1718                                traitDecl = ast::mutate_field_index(
1719                                        traitDecl, &ast::TraitDecl::params, 0,
1720                                        ast::mutate_field(
[c1398e4]1721                                                traitDecl->params.front().get(), &ast::TypeDecl::sized, true ) );
1722                        }
[18e683b]1723
[c1398e4]1724                        // move assertions from type parameters into the body of the trait
1725                        std::vector< ast::ptr< ast::DeclWithType > > added;
1726                        for ( const ast::TypeDecl * td : traitDecl->params ) {
1727                                for ( const ast::DeclWithType * assn : td->assertions ) {
1728                                        auto inst = dynamic_cast< const ast::TraitInstType * >( assn->get_type() );
1729                                        if ( inst ) {
1730                                                expandAssertions( inst, added );
1731                                        } else {
1732                                                added.emplace_back( assn );
1733                                        }
1734                                }
1735                        }
1736                        if ( ! added.empty() ) {
1737                                auto mut = mutate( traitDecl );
1738                                for ( const ast::DeclWithType * decl : added ) {
1739                                        mut->members.emplace_back( decl );
1740                                }
1741                                traitDecl = mut;
1742                        }
[ef5b828]1743
[c1398e4]1744                        return traitDecl;
[18e683b]1745                }
[c1ed2ee]1746        };
1747
[ef5b828]1748        /// Replaces array and function types in forall lists by appropriate pointer type and assigns
[c1ed2ee]1749        /// each object and function declaration a unique ID
[c1398e4]1750        class ForallPointerDecay_new {
1751                const CodeLocation & location;
1752        public:
1753                ForallPointerDecay_new( const CodeLocation & loc ) : location( loc ) {}
1754
1755                const ast::ObjectDecl * previsit( const ast::ObjectDecl * obj ) {
1756                        // ensure that operator names only apply to functions or function pointers
[ef5b828]1757                        if (
1758                                CodeGen::isOperator( obj->name )
[c1398e4]1759                                && ! dynamic_cast< const ast::FunctionType * >( obj->type->stripDeclarator() )
1760                        ) {
1761                                SemanticError( obj->location, toCString( "operator ", obj->name.c_str(), " is not "
1762                                        "a function or function pointer." )  );
1763                        }
1764
1765                        // ensure object has unique ID
1766                        if ( obj->uniqueId ) return obj;
1767                        auto mut = mutate( obj );
1768                        mut->fixUniqueId();
1769                        return mut;
1770                }
1771
1772                const ast::FunctionDecl * previsit( const ast::FunctionDecl * func ) {
1773                        // ensure function has unique ID
1774                        if ( func->uniqueId ) return func;
1775                        auto mut = mutate( func );
1776                        mut->fixUniqueId();
1777                        return mut;
1778                }
1779
1780                /// Fix up assertions -- flattens assertion lists, removing all trait instances
1781                template< typename node_t, typename parent_t >
[ef5b828]1782                static const node_t * forallFixer(
1783                        const CodeLocation & loc, const node_t * node,
[c1398e4]1784                        ast::ParameterizedType::ForallList parent_t::* forallField
1785                ) {
[ef5b828]1786                        for ( unsigned i = 0; i < (node->* forallField).size(); ++i ) {
1787                                const ast::TypeDecl * type = (node->* forallField)[i];
[c1398e4]1788                                if ( type->assertions.empty() ) continue;
1789
1790                                std::vector< ast::ptr< ast::DeclWithType > > asserts;
1791                                asserts.reserve( type->assertions.size() );
1792
1793                                // expand trait instances into their members
1794                                for ( const ast::DeclWithType * assn : type->assertions ) {
[ef5b828]1795                                        auto traitInst =
1796                                                dynamic_cast< const ast::TraitInstType * >( assn->get_type() );
[c1398e4]1797                                        if ( traitInst ) {
1798                                                // expand trait instance to all its members
1799                                                expandAssertions( traitInst, asserts );
1800                                        } else {
1801                                                // pass other assertions through
1802                                                asserts.emplace_back( assn );
1803                                        }
1804                                }
1805
1806                                // apply FixFunction to every assertion to check for invalid void type
1807                                for ( ast::ptr< ast::DeclWithType > & assn : asserts ) {
1808                                        bool isVoid = false;
1809                                        assn = fixFunction( assn, isVoid );
1810                                        if ( isVoid ) {
1811                                                SemanticError( loc, node, "invalid type void in assertion of function " );
1812                                        }
1813                                }
1814
1815                                // place mutated assertion list in node
1816                                auto mut = mutate( type );
1817                                mut->assertions = move( asserts );
1818                                node = ast::mutate_field_index( node, forallField, i, mut );
1819                        }
1820                        return node;
1821                }
1822
1823                const ast::FunctionType * previsit( const ast::FunctionType * ftype ) {
1824                        return forallFixer( location, ftype, &ast::FunctionType::forall );
1825                }
1826
1827                const ast::StructDecl * previsit( const ast::StructDecl * aggrDecl ) {
1828                        return forallFixer( aggrDecl->location, aggrDecl, &ast::StructDecl::params );
1829                }
1830
1831                const ast::UnionDecl * previsit( const ast::UnionDecl * aggrDecl ) {
1832                        return forallFixer( aggrDecl->location, aggrDecl, &ast::UnionDecl::params );
1833                }
[c1ed2ee]1834        };
1835} // anonymous namespace
1836
[ef5b828]1837const ast::Type * validateType(
[18e683b]1838                const CodeLocation & loc, const ast::Type * type, const ast::SymbolTable & symtab ) {
[c1ed2ee]1839        ast::Pass< EnumAndPointerDecay_new > epc;
[18e683b]1840        ast::Pass< LinkReferenceToTypes_new > lrt{ loc, symtab };
[c1398e4]1841        ast::Pass< ForallPointerDecay_new > fpd{ loc };
[c1ed2ee]1842
1843        return type->accept( epc )->accept( lrt )->accept( fpd );
1844}
1845
[51b7345]1846} // namespace SymTab
[0dd3a2f]1847
1848// Local Variables: //
1849// tab-width: 4 //
1850// mode: c++ //
1851// compile-command: "make install" //
1852// End: //
Note: See TracBrowser for help on using the repository browser.