eba97426d4
Summary:
This patch removes the "//----" frames and "///" leading lines from
docstring comments. We already have code doing transformations like this in
modify-python-lldb.py, but that's a script I'd like to remove. Instead
of running these transformations everytime we run swig, we can just
perform equivalent on its input once.
This patch can be reproduced (e.g. for downstream merges) with the
following "sweet" perl command:
perl -i -p -e 'BEGIN{ $/ = undef;} s:(" *\n) *//-----*\n:\1:gs; s:^( *)/// ?:\1:gsm; s:^ *//------*\n( *\n)?( *"):\2:gsm; s: *$::gsm; s:\n *"\):"):gsm' scripts/interface/*.i
This command produces nearly equivalent python files to those produced
by the relevant code in modify-python-lldb.py. The only difference I
noticed is that here I am slightly more agressive in removing trailing
newlines from docstring comments (the python script seems to leave
newlines in class-level docstrings).
Reviewers: amccarth, clayborg, jingham, aprantl
Subscribers: lldb-commits
Differential Revision: https://reviews.llvm.org/D60498
llvm-svn: 358683
109 lines
3.3 KiB
C++
109 lines
3.3 KiB
C++
//===-- SWIG Interface for SBInstruction ------------------------*- 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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#include <stdio.h>
|
|
|
|
// There's a lot to be fixed here, but need to wait for underlying insn implementation
|
|
// to be revised & settle down first.
|
|
|
|
namespace lldb {
|
|
|
|
class SBInstruction
|
|
{
|
|
public:
|
|
|
|
SBInstruction ();
|
|
|
|
SBInstruction (const SBInstruction &rhs);
|
|
|
|
~SBInstruction ();
|
|
|
|
bool
|
|
IsValid();
|
|
|
|
explicit operator bool() const;
|
|
|
|
lldb::SBAddress
|
|
GetAddress();
|
|
|
|
|
|
const char *
|
|
GetMnemonic (lldb::SBTarget target);
|
|
|
|
const char *
|
|
GetOperands (lldb::SBTarget target);
|
|
|
|
const char *
|
|
GetComment (lldb::SBTarget target);
|
|
|
|
lldb::SBData
|
|
GetData (lldb::SBTarget target);
|
|
|
|
size_t
|
|
GetByteSize ();
|
|
|
|
bool
|
|
DoesBranch ();
|
|
|
|
bool
|
|
HasDelaySlot ();
|
|
|
|
bool
|
|
CanSetBreakpoint ();
|
|
|
|
void
|
|
Print (FILE *out);
|
|
|
|
bool
|
|
GetDescription (lldb::SBStream &description);
|
|
|
|
bool
|
|
EmulateWithFrame (lldb::SBFrame &frame, uint32_t evaluate_options);
|
|
|
|
bool
|
|
DumpEmulation (const char * triple); // triple is to specify the architecture, e.g. 'armv6' or 'armv7-apple-ios'
|
|
|
|
bool
|
|
TestEmulation (lldb::SBStream &output_stream, const char *test_file);
|
|
|
|
%pythoncode %{
|
|
def __mnemonic_property__ (self):
|
|
return self.GetMnemonic (target)
|
|
def __operands_property__ (self):
|
|
return self.GetOperands (target)
|
|
def __comment_property__ (self):
|
|
return self.GetComment (target)
|
|
def __file_addr_property__ (self):
|
|
return self.GetAddress ().GetFileAddress()
|
|
def __load_adrr_property__ (self):
|
|
return self.GetComment (target)
|
|
|
|
__swig_getmethods__["mnemonic"] = __mnemonic_property__
|
|
if _newclass: mnemonic = property(__mnemonic_property__, None, doc='''A read only property that returns the mnemonic for this instruction as a string.''')
|
|
|
|
__swig_getmethods__["operands"] = __operands_property__
|
|
if _newclass: operands = property(__operands_property__, None, doc='''A read only property that returns the operands for this instruction as a string.''')
|
|
|
|
__swig_getmethods__["comment"] = __comment_property__
|
|
if _newclass: comment = property(__comment_property__, None, doc='''A read only property that returns the comment for this instruction as a string.''')
|
|
|
|
__swig_getmethods__["addr"] = GetAddress
|
|
if _newclass: addr = property(GetAddress, None, doc='''A read only property that returns an lldb object that represents the address (lldb.SBAddress) for this instruction.''')
|
|
|
|
__swig_getmethods__["size"] = GetByteSize
|
|
if _newclass: size = property(GetByteSize, None, doc='''A read only property that returns the size in bytes for this instruction as an integer.''')
|
|
|
|
__swig_getmethods__["is_branch"] = DoesBranch
|
|
if _newclass: is_branch = property(DoesBranch, None, doc='''A read only property that returns a boolean value that indicates if this instruction is a branch instruction.''')
|
|
%}
|
|
|
|
|
|
};
|
|
|
|
} // namespace lldb
|