Ghidra Decompiler Analysis Engine
Public Member Functions | List of all members
EmitNoXml Class Reference

A trivial emitter that outputs syntax straight to the stream. More...

#include <prettyprint.hh>

Inheritance diagram for EmitNoXml:
Inheritance graph
[legend]
Collaboration diagram for EmitNoXml:
Collaboration graph
[legend]

Public Member Functions

virtual int4 beginDocument (void)
 Begin a whole document of output. More...
 
virtual void endDocument (int4 id)
 End a whole document of output. More...
 
virtual int4 beginFunction (const Funcdata *fd)
 Begin a whole declaration and body of a function. More...
 
virtual void endFunction (int4 id)
 End a whole declaration and body of a function. More...
 
virtual int4 beginBlock (const FlowBlock *bl)
 Begin a control-flow element. More...
 
virtual void endBlock (int4 id)
 End a control-flow element. More...
 
virtual void tagLine (int4 indent)
 Force a line break and indent level. More...
 
virtual int4 beginReturnType (const Varnode *vn)
 Begin a return type declaration. More...
 
virtual void endReturnType (int4 id)
 End a return type declaration. More...
 
virtual int4 beginVarDecl (const Symbol *sym)
 Begin a variable declaration. More...
 
virtual void endVarDecl (int4 id)
 End a variable declaration. More...
 
virtual int4 beginStatement (const PcodeOp *op)
 Begin a source code statement. More...
 
virtual void endStatement (int4 id)
 End a source code statement. More...
 
virtual int4 beginFuncProto (void)
 Begin a function prototype declaration. More...
 
virtual void endFuncProto (int4 id)
 End a function prototype declaration. More...
 
virtual void tagVariable (const char *ptr, syntax_highlight hl, const Varnode *vn, const PcodeOp *op)
 Emit a variable token. More...
 
virtual void tagOp (const char *ptr, syntax_highlight hl, const PcodeOp *op)
 Emit an operation token. More...
 
virtual void tagFuncName (const char *ptr, syntax_highlight hl, const Funcdata *fd, const PcodeOp *op)
 Emit a function identifier. More...
 
virtual void tagType (const char *ptr, syntax_highlight hl, const Datatype *ct)
 Emit a data-type identifier. More...
 
virtual void tagField (const char *ptr, syntax_highlight hl, const Datatype *ct, int4 off)
 Emit an identifier for a field within a structured data-type. More...
 
virtual void tagComment (const char *ptr, syntax_highlight hl, const AddrSpace *spc, uintb off)
 Emit a comment string as part of the generated source code. More...
 
virtual void tagLabel (const char *ptr, syntax_highlight hl, const AddrSpace *spc, uintb off)
 Emit a code label identifier. More...
 
virtual void print (const char *str, syntax_highlight hl=no_color)
 Emit other (more unusual) syntax as part of source code generation. More...
 
virtual int4 openParen (char o, int4 id=0)
 Emit an open parenthesis. More...
 
virtual void closeParen (char c, int4 id)
 Emit a close parenthesis. More...
 
virtual bool emitsXml (void) const
 Determine if this is an XML markup emitter. More...
 
- Public Member Functions inherited from EmitXml
virtual void tagLine (void)
 Force a line break. More...
 
virtual int4 openGroup (void)
 Start a group of things that are printed together. More...
 
virtual void closeGroup (int4 id)
 End a group of things that are printed together. More...
 
virtual void spaces (int4 num, int4 bump=0)
 Emit a sequence of space characters as part of source code. More...
 
virtual int4 startIndent (void)
 Start a new indent level. More...
 
virtual void stopIndent (int4 id)
 End an indent level. More...
 
virtual int4 startComment (void)
 Start a comment block within the emitted source code. More...
 
virtual void stopComment (int4 id)
 End a comment block. More...
 
virtual void flush (void)
 Flush any remaining character data. More...
 
virtual void setMaxLineSize (int4 mls)
 Provide a maximum line size to the pretty printer. More...
 
virtual int4 getMaxLineSize (void) const
 Get the current maximum line size. More...
 
virtual void setCommentFill (const string &fill)
 Set the comment fill characters for when line breaks are forced. More...
 
virtual void resetDefaults (void)
 (Re)set the default emitting options
 
int4 getParenLevel (void) const
 Get the current parentheses depth. More...
 
int4 getIndentIncrement (void) const
 Get the number of characters indented per level of nesting. More...
 
void setIndentIncrement (int4 val)
 Set the number of characters indented per level of nesting. More...
 

Additional Inherited Members

- Public Types inherited from EmitXml
enum  syntax_highlight {
  keyword_color = 0, comment_color = 1, type_color = 2, funcname_color = 3,
  var_color = 4, const_color = 5, param_color = 6, global_color = 7,
  no_color = 8
}
 Possible types of syntax highlighting. More...
 
- Protected Attributes inherited from EmitXml
ostream * s
 Stream being emitted to.
 
int4 indentlevel
 Current indent level (in fixed width characters)
 
int4 parenlevel
 Current depth of parentheses.
 
int4 indentincrement
 Change in indentlevel per level of nesting.
 

Detailed Description

A trivial emitter that outputs syntax straight to the stream.

This emitter does neither pretty printing nor XML markup. It dumps any tokens straight to the final output stream. It can be used as the low-level back-end for EmitPrettyPrint.

Member Function Documentation

◆ beginBlock()

virtual int4 EmitNoXml::beginBlock ( const FlowBlock bl)
inlinevirtual

Begin a control-flow element.

Inform the emitter that a new control-flow section is starting. This is a source code unit usually surrounded with curly braces '{' and '}'.

Parameters
blis the block structure object associated with the section
Returns
an id associated with the section

Reimplemented from EmitXml.

◆ beginDocument()

virtual int4 EmitNoXml::beginDocument ( void  )
inlinevirtual

Begin a whole document of output.

Inform the emitter that generation of the source code document has begun

Returns
an id associated with the document

Reimplemented from EmitXml.

◆ beginFuncProto()

virtual int4 EmitNoXml::beginFuncProto ( void  )
inlinevirtual

Begin a function prototype declaration.

Inform the emitter that a function prototype is starting.

Returns
an id associated with the prototype

Reimplemented from EmitXml.

◆ beginFunction()

virtual int4 EmitNoXml::beginFunction ( const Funcdata fd)
inlinevirtual

Begin a whole declaration and body of a function.

Inform the emitter that generation of a function body has begun

Returns
an id associated with the function body

Reimplemented from EmitXml.

◆ beginReturnType()

virtual int4 EmitNoXml::beginReturnType ( const Varnode vn)
inlinevirtual

Begin a return type declaration.

Inform the emitter that generation of a function's return type is starting.

Parameters
vn(if non-null) is the storage location for the return value
Returns
an id associated with the return type

Reimplemented from EmitXml.

◆ beginStatement()

virtual int4 EmitNoXml::beginStatement ( const PcodeOp op)
inlinevirtual

Begin a source code statement.

Inform the emitter that a source code statement is beginning.

Parameters
opis the root p-code operation of the statement
Returns
an id associated with the statement

Reimplemented from EmitXml.

◆ beginVarDecl()

virtual int4 EmitNoXml::beginVarDecl ( const Symbol sym)
inlinevirtual

Begin a variable declaration.

Inform the emitter that a variable declaration has started.

Parameters
symis the symbol being declared
Returns
an id associated with the declaration

Reimplemented from EmitXml.

◆ closeParen()

virtual void EmitNoXml::closeParen ( char  c,
int4  id 
)
inlinevirtual

Emit a close parenthesis.

This method emits the parenthesis character itself and ends the printing unit that was started by the matching open parenthesis.

Parameters
cis the close parenthesis character to emit
idis the id associated with the matching open parenthesis (as returned by openParen)

Reimplemented from EmitXml.

◆ emitsXml()

virtual bool EmitNoXml::emitsXml ( void  ) const
inlinevirtual

Determine if this is an XML markup emitter.

Returns
true if this produces an XML markup of its emitted source code

Reimplemented from EmitXml.

◆ endBlock()

virtual void EmitNoXml::endBlock ( int4  id)
inlinevirtual

End a control-flow element.

Inform the emitter that a control-flow section is ending.

Parameters
idis the id associated with the section (as returned by beginBlock)

Reimplemented from EmitXml.

◆ endDocument()

virtual void EmitNoXml::endDocument ( int4  id)
inlinevirtual

End a whole document of output.

Inform the emitter that generation of the source code document is finished

Parameters
idis the id associated with the document (as returned by beginDocument)

Reimplemented from EmitXml.

◆ endFuncProto()

virtual void EmitNoXml::endFuncProto ( int4  id)
inlinevirtual

End a function prototype declaration.

Inform the emitter that a function prototype is ending.

Parameters
idis the id associated with the prototype (as returned by beginFuncProto)

Reimplemented from EmitXml.

◆ endFunction()

virtual void EmitNoXml::endFunction ( int4  id)
inlinevirtual

End a whole declaration and body of a function.

Inform the emitter that generation of a function body has ended

Parameters
idis the id associated with the function body (as returned by beginFunction)

Reimplemented from EmitXml.

◆ endReturnType()

virtual void EmitNoXml::endReturnType ( int4  id)
inlinevirtual

End a return type declaration.

Inform the emitter that generation of a function's return type is ending.

Parameters
idis the id associated with the return type (as returned by beginReturnType)

Reimplemented from EmitXml.

◆ endStatement()

virtual void EmitNoXml::endStatement ( int4  id)
inlinevirtual

End a source code statement.

Inform the emitter that a source code statement is ending.

Parameters
idis the id associated with the statement (as returned by beginStatement)

Reimplemented from EmitXml.

◆ endVarDecl()

virtual void EmitNoXml::endVarDecl ( int4  id)
inlinevirtual

End a variable declaration.

Inform the emitter that a variable declaration has ended.

Parameters
idis the id associated with the declaration (as returned by beginVarDecl)

Reimplemented from EmitXml.

◆ openParen()

virtual int4 EmitNoXml::openParen ( char  o,
int4  id = 0 
)
inlinevirtual

Emit an open parenthesis.

This method emits the parenthesis character itself and also starts a printing unit of the source code being surrounded by the parentheses.

Parameters
ois the open parenthesis character to emit
idis an id to associate with the parenthesis
Returns
an id associated with the parenthesis

Reimplemented from EmitXml.

◆ print()

virtual void EmitNoXml::print ( const char *  str,
syntax_highlight  hl = no_color 
)
inlinevirtual

Emit other (more unusual) syntax as part of source code generation.

This method is used to emit syntax not covered by the other methods, such as spaces, semi-colons, braces, and other punctuation.

Parameters
stris the character data of the syntax being emitted
hlindicates how the syntax should be highlighted

Reimplemented from EmitXml.

◆ tagComment()

virtual void EmitNoXml::tagComment ( const char *  ptr,
syntax_highlight  hl,
const AddrSpace spc,
uintb  off 
)
inlinevirtual

Emit a comment string as part of the generated source code.

Individual comments can be broken up and emitted using multiple calls to this method, but ultimately the comment delimiters and the body of the comment are both emitted with this method, which may provide addition markup.

Parameters
ptris the character data for the comment
hlindicates how the comment should be highlighted
spcis the address space of the address where the comment is attached
offis the offset of the address where the comment is attached

Reimplemented from EmitXml.

◆ tagField()

virtual void EmitNoXml::tagField ( const char *  ptr,
syntax_highlight  hl,
const Datatype ct,
int4  o 
)
inlinevirtual

Emit an identifier for a field within a structured data-type.

A string representing an individual component of a structured data-type is emitted, possibly with additional markup.

Parameters
ptris the character data for the identifier
hlindicates how the identifier should be highlighted
ctis the data-type associated with the field
ois the (byte) offset of the field within its structured data-type

Reimplemented from EmitXml.

◆ tagFuncName()

virtual void EmitNoXml::tagFuncName ( const char *  ptr,
syntax_highlight  hl,
const Funcdata fd,
const PcodeOp op 
)
inlinevirtual

Emit a function identifier.

An identifier string representing the symbol name of the function is emitted, possible with additional markup.

Parameters
ptris the character data for the identifier
hlindicates how the identifier should be highlighted
fdis the function
opis the CALL operation associated within the syntax tree or null for a declaration

Reimplemented from EmitXml.

◆ tagLabel()

virtual void EmitNoXml::tagLabel ( const char *  ptr,
syntax_highlight  hl,
const AddrSpace spc,
uintb  off 
)
inlinevirtual

Emit a code label identifier.

A string describing a control-flow destination, as appropriate for the source language is output, possibly with additional markup.

Parameters
ptris the character data of the label
hlindicates how the label should be highlighted
spcis the address space of the code address being labeled
offis the offset of the code address being labeled

Reimplemented from EmitXml.

◆ tagLine()

virtual void EmitNoXml::tagLine ( int4  indent)
inlinevirtual

Force a line break and indent level.

Tell the emitter that a new line is desired at a specific indent level. The indent level is overridden only for the line, then it returns to its previous value.

Parameters
indentis the desired indent level for the new line

Reimplemented from EmitXml.

◆ tagOp()

virtual void EmitNoXml::tagOp ( const char *  ptr,
syntax_highlight  hl,
const PcodeOp op 
)
inlinevirtual

Emit an operation token.

The string representing the operation as appropriate for the source language is emitted, possibly with additional markup.

Parameters
ptris the character data for the emitted representation
hlindicates how the token should be highlighted
opis the PcodeOp object associated with the operation with the syntax tree

Reimplemented from EmitXml.

◆ tagType()

virtual void EmitNoXml::tagType ( const char *  ptr,
syntax_highlight  hl,
const Datatype ct 
)
inlinevirtual

Emit a data-type identifier.

A string representing the name of a data-type, as appropriate for the source language is emitted, possibly with additional markup.

Parameters
ptris the character data for the identifier
hlindicates how the identifier should be highlighted
ctis the data-type description object

Reimplemented from EmitXml.

◆ tagVariable()

virtual void EmitNoXml::tagVariable ( const char *  ptr,
syntax_highlight  hl,
const Varnode vn,
const PcodeOp op 
)
inlinevirtual

Emit a variable token.

An identifier string representing the variable is output, possibly with additional markup.

Parameters
ptris the character data for the identifier
hlindicates how the identifier should be highlighted
vnis the Varnode representing the variable within the syntax tree
opis a p-code operation related to the use of the variable (may be null)

Reimplemented from EmitXml.


The documentation for this class was generated from the following file: