LanguageRuntime.h   [plain text]

//===-- LanguageRuntime.h ---------------------------------------------------*- C++ -*-===//
//
//                     The LLVM Compiler Infrastructure
//
// This file is distributed under the University of Illinois Open Source
// License. See LICENSE.TXT for details.
//
//===----------------------------------------------------------------------===//

#ifndef liblldb_LanguageRuntime_h_
#define liblldb_LanguageRuntime_h_

// C Includes
// C++ Includes
// Other libraries and framework includes
// Project includes
#include "lldb/lldb-public.h"
#include "lldb/Breakpoint/BreakpointResolver.h"
#include "lldb/Breakpoint/BreakpointResolverName.h"
#include "lldb/Core/PluginInterface.h"
#include "lldb/lldb-private.h"
#include "lldb/Core/ValueObject.h"
#include "lldb/Core/Value.h"
#include "lldb/Target/ExecutionContextScope.h"

namespace lldb_private {

class LanguageRuntime :
    public PluginInterface
{
public:
    virtual
    ~LanguageRuntime();
    
    static LanguageRuntime* 
    FindPlugin (Process *process, lldb::LanguageType language);
    
    virtual lldb::LanguageType
    GetLanguageType () const = 0;
    
    virtual bool
    GetObjectDescription (Stream &str, ValueObject &object) = 0;
    
    virtual bool
    GetObjectDescription (Stream &str, Value &value, ExecutionContextScope *exe_scope) = 0;
    
    virtual bool
    GetDynamicTypeAndAddress (ValueObject &in_value, 
                              lldb::DynamicValueType use_dynamic, 
                              TypeAndOrName &class_type_or_name, 
                              Address &address) = 0;
    
    // This should be a fast test to determine whether it is likely that this value would
    // have a dynamic type.
    virtual bool
    CouldHaveDynamicValue (ValueObject &in_value) = 0;

    virtual void
    SetExceptionBreakpoints ()
    {
    }
    
    virtual void
    ClearExceptionBreakpoints ()
    {
    }
    
    virtual bool
    ExceptionBreakpointsExplainStop (lldb::StopInfoSP stop_reason)
    {
        return false;
    }
    
    static lldb::BreakpointSP
    CreateExceptionBreakpoint (Target &target,
                               lldb::LanguageType language, 
                               bool catch_bp, 
                               bool throw_bp, 
                               bool is_internal = false);
                            
    static lldb::LanguageType
    GetLanguageTypeFromString (const char *string);
    
    static const char *
    GetNameForLanguageType (lldb::LanguageType language);
    
    Process *
    GetProcess()
    {
        return m_process;
    }
        
protected:
    //------------------------------------------------------------------
    // Classes that inherit from LanguageRuntime can see and modify these
    //------------------------------------------------------------------
    
    // The Target is the one that knows how to create breakpoints, so this function is meant to be used either
    // by the target or internally in Set/ClearExceptionBreakpoints.
    class ExceptionBreakpointResolver : public BreakpointResolver
    {
    public:
        ExceptionBreakpointResolver (Breakpoint *bkpt,
                                lldb::LanguageType language,
                                bool catch_bp,
                                bool throw_bp);

        virtual ~ExceptionBreakpointResolver() {}

        virtual Searcher::CallbackReturn
        SearchCallback (SearchFilter &filter,
                        SymbolContext &context,
                        Address *addr,
                        bool containing);

        virtual Searcher::Depth
        GetDepth ();

        virtual void
        GetDescription (Stream *s);
        
        virtual void
        Dump (Stream *s) const {}

        /// Methods for support type inquiry through isa, cast, and dyn_cast:
        static inline bool classof(const BreakpointResolverName *) { return true; }
        static inline bool classof(const BreakpointResolver *V) {
            return V->getResolverID() == BreakpointResolver::ExceptionResolver;
        }
    protected:
        bool SetActualResolver();
        
        lldb::BreakpointResolverSP m_actual_resolver_sp;
        lldb::ProcessWP m_process_wp;
        lldb::LanguageType m_language;
        bool m_catch_bp;
        bool m_throw_bp;
    };
    
    virtual lldb::BreakpointResolverSP
    CreateExceptionResolver (Breakpoint *bkpt, bool catch_bp, bool throw_bp) = 0;
    
    LanguageRuntime(Process *process);
    Process *m_process;
private:
    DISALLOW_COPY_AND_ASSIGN (LanguageRuntime);
};

} // namespace lldb_private

#endif  // liblldb_LanguageRuntime_h_