Files
swift-mirror/include/swift/Subsystems.h
Chris Lattner 8c85a49d2a with the groundwork out of the way, we can now namebind types referenced
by the SIL parser.  Add a test that covers both local types, and types
that require looking through an import decl (Int, from the stdlib).


Swift SVN r5249
2013-05-21 05:34:24 +00:00

116 lines
4.6 KiB
C++

//===--- Subsystems.h - Swift Compiler Subsystem Entrypoints ----*- C++ -*-===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2014 - 2015 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See http://swift.org/LICENSE.txt for license information
// See http://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
//
//===----------------------------------------------------------------------===//
//
// This file declares the main entrypoints to the various subsystems.
//
//===----------------------------------------------------------------------===//
#ifndef SWIFT_SUBSYSTEMS_H
#define SWIFT_SUBSYSTEMS_H
#include "swift/Basic/LLVM.h"
#include "llvm/ADT/ArrayRef.h"
namespace llvm {
class MemoryBuffer;
class Module;
class FunctionPass;
}
namespace swift {
class TranslationUnit;
class ASTContext;
class Component;
class Expr;
class SILModule;
struct TypeLoc;
namespace irgen {
class Options;
}
/// verify - Check that the translation unit is well formed (i.e. following
/// the invariants of the AST, not that the code written by the user makes
/// sense), aborting and spewing errors if not.
void verify(TranslationUnit *TUnit);
/// parseIntoTranslationUnit - Parse a single buffer into the given
/// taranslation unit. If the translation unit is the main module, stop
/// parsing after the next stmt-brace-item with side-effects. If "SIL" is
/// present, then we're parsing a .sil file instead of a .swift file.
///
bool parseIntoTranslationUnit(TranslationUnit *TU, unsigned BufferID,
unsigned *BufferOffset = 0,
unsigned BufferEndOffset = 0,
SILModule *SIL = 0);
/// Attempt to parse a StringRef as a code completion context expression.
/// Returns the parsed expression if successful, or null if an expression
/// could not be parsed.
Expr *parseCompletionContextExpr(TranslationUnit *TU, StringRef expr);
/// performNameBinding - Once parsing is complete, this walks the AST to
/// resolve names and do other top-level validation. StartElem indicates
/// where to start for incremental name binding in the main module.
void performNameBinding(TranslationUnit *TU, unsigned StartElem = 0);
/// performTypeChecking - Once parsing and namebinding are complete, this
/// walks the AST to resolve types and diagnose problems therein. StartElem
/// indicates where to start for incremental type checking in the
/// main module.
void performTypeChecking(TranslationUnit *TU, unsigned StartElem = 0);
/// performTypeLocChecking - recursively validate the specified type. This is
/// used when dealing with partial translation units (e.g. SIL parsing).
bool performTypeLocChecking(TranslationUnit *TU, TypeLoc &T);
/// typeCheckCompletionContextExpr - Typecheck an expression parsed as a
/// completion context.
bool typeCheckCompletionContextExpr(TranslationUnit *TU,
Expr *&parsedExpr);
/// performCaptureAnalysis - Analyse the AST and mark local declarations
/// and expressions which can capture them so they can be emitted more
/// efficiently. StartElem indicates where to start for incremental capture
/// analysis in the main module.
void performCaptureAnalysis(TranslationUnit *TU, unsigned StartElem = 0);
/// Turn the given translation unit into SIL IR. The returned SILModule must
/// be deleted by the caller.
SILModule *performSILGeneration(TranslationUnit *TU, unsigned StartElem = 0);
/// Serializes a translation unit to the given output file.
///
/// This interface is still prone to change!
void serialize(const TranslationUnit *TU, const char *outputPath,
ArrayRef<unsigned> inputFileBufferIDs = {});
/// Turn the given translation unit into either LLVM IR or native code.
///
/// \param SILMod A SIL module to translate to LLVM IR. If null, IRGen works
/// directly from the AST.
/// \param StartElem Indicates where to start for incremental IRGen in the
/// main module.
void performIRGeneration(irgen::Options &Opts, llvm::Module *Module,
TranslationUnit *TU, SILModule *SILMod,
unsigned StartElem = 0);
// Optimization passes.
llvm::FunctionPass *createSwiftARCOptPass();
llvm::FunctionPass *createSwiftARCExpandPass();
/// The extension for serialized modules.
static const char * const SERIALIZED_MODULE_EXTENSION = "swiftmodule";
} // end namespace swift
#endif