blob: 5a792a24cf6e96a436ed7568e8e02b10bb580190 [file] [log] [blame]
//===-- SBAddress.h ---------------------------------------------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
#ifndef LLDB_API_SBADDRESS_H
#define LLDB_API_SBADDRESS_H
#include "lldb/API/SBDefines.h"
#include "lldb/API/SBModule.h"
namespace lldb {
class LLDB_API SBAddress {
public:
SBAddress();
SBAddress(const lldb::SBAddress &rhs);
SBAddress(lldb::SBSection section, lldb::addr_t offset);
// Create an address by resolving a load address using the supplied target
SBAddress(lldb::addr_t load_addr, lldb::SBTarget &target);
~SBAddress();
const lldb::SBAddress &operator=(const lldb::SBAddress &rhs);
explicit operator bool() const;
// operator== is a free function
bool operator!=(const SBAddress &rhs) const;
bool IsValid() const;
void Clear();
addr_t GetFileAddress() const;
addr_t GetLoadAddress(const lldb::SBTarget &target) const;
void SetAddress(lldb::SBSection section, lldb::addr_t offset);
void SetLoadAddress(lldb::addr_t load_addr, lldb::SBTarget &target);
bool OffsetAddress(addr_t offset);
bool GetDescription(lldb::SBStream &description);
// The following queries can lookup symbol information for a given address.
// An address might refer to code or data from an existing module, or it
// might refer to something on the stack or heap. The following functions
// will only return valid values if the address has been resolved to a code
// or data address using "void SBAddress::SetLoadAddress(...)" or
// "lldb::SBAddress SBTarget::ResolveLoadAddress (...)".
lldb::SBSymbolContext GetSymbolContext(uint32_t resolve_scope);
// The following functions grab individual objects for a given address and
// are less efficient if you want more than one symbol related objects. Use
// one of the following when you want multiple debug symbol related objects
// for an address:
// lldb::SBSymbolContext SBAddress::GetSymbolContext (uint32_t
// resolve_scope);
// lldb::SBSymbolContext SBTarget::ResolveSymbolContextForAddress (const
// SBAddress &addr, uint32_t resolve_scope);
// One or more bits from the SymbolContextItem enumerations can be logically
// OR'ed together to more efficiently retrieve multiple symbol objects.
lldb::SBSection GetSection();
lldb::addr_t GetOffset();
lldb::SBModule GetModule();
lldb::SBCompileUnit GetCompileUnit();
lldb::SBFunction GetFunction();
lldb::SBBlock GetBlock();
lldb::SBSymbol GetSymbol();
lldb::SBLineEntry GetLineEntry();
protected:
friend class SBBlock;
friend class SBBreakpoint;
friend class SBBreakpointLocation;
friend class SBFrame;
friend class SBFunction;
friend class SBLineEntry;
friend class SBInstruction;
friend class SBModule;
friend class SBSection;
friend class SBSymbol;
friend class SBSymbolContext;
friend class SBTarget;
friend class SBThread;
friend class SBThreadPlan;
friend class SBValue;
friend class SBQueueItem;
lldb_private::Address *operator->();
const lldb_private::Address *operator->() const;
friend bool LLDB_API operator==(const SBAddress &lhs, const SBAddress &rhs);
lldb_private::Address *get();
lldb_private::Address &ref();
const lldb_private::Address &ref() const;
SBAddress(const lldb_private::Address &address);
void SetAddress(const lldb_private::Address &address);
private:
std::unique_ptr<lldb_private::Address> m_opaque_up;
};
bool LLDB_API operator==(const SBAddress &lhs, const SBAddress &rhs);
} // namespace lldb
#endif // LLDB_API_SBADDRESS_H