Used to preprocess the specified input stream, item or file without initializing the preprocessor before processing and without cleaning up the preprocessor after processing.
Syntax
pp._preprocess( InputReader , OutputWriter )
pp._preprocess( InputReader , OutputWriter, ErrorWriter )
Parameters
InputReader
|
Reader object containing the item to preprocessed.
|
OutputWriter
|
Writer object that will contain the resultant preprocessed item.
|
ErrorWriter
|
Writer object containing the item to preprocessed.
|
Returns
Exceptions
Notes
pp
|
an instance of the pp class.
|
Statements and directives are delimited by \n.
Requires that stec.pp.pp be imported.
Requires that stec.pp._init() be called before first calling _preprocess().
Requires that stec.pp._wrapup() be called after last calling _preprocess().
if/ifdef/ifndef directives can span multiple calls to _preprocess() without endif.
Comments spanning multiple lines cannot span multiple calls to _preprocess().
Line continuations cannot span multiple calls to _preprocess().
Example
pp._preprocess(reader, writer)
Syntax
Parameters
String
|
contains the item to preprocess.
|
Returns
String
|
contains the preprocessed item.
|
Exceptions
Notes
pp
|
an instance of the pp class.
|
Statements and directives are delimited by \n.
Requires that stec.pp.pp be imported.
Requires that stec.pp._init() be called before first calling _preprocess().
Requires that stec.pp._wrapup() be called after last calling _preprocess().
if/ifdef/ifndef directives can span multiple calls to _preprocess() without endif.
Comments spanning multiple lines cannot span multiple calls to _preprocess().
Line continuations cannot span multiple calls to _preprocess().
Example
pp._preprocess(item)
Syntax
pp._preprocess( InputFileName, OutputFileName, ErrorFileName )
Parameters
InputFileName
|
String object containing the name of the file that will be preprocessed.
|
OutputFileName
|
String object containing the name of the file that the preprocessed item will be written to.
|
ErrorFileName
|
String object containing the name of the file that errors will be written to.
|
Returns
Exceptions
Notes
pp
|
an instance of the pp class.
|
Statements and directives are delimited by \n.
Requires that stec.pp.pp be imported.
Requires that stec.pp._init() be called before first calling _preprocess().
Requires that stec.pp._wrapup() be called after last calling _preprocess().
if/ifdef/ifndef directives can span multiple calls to _preprocess() without endif.
Comments spanning multiple lines cannot span multiple calls to _preprocess().
Line continuations cannot span multiple calls to _preprocess().
Example
pp._preprocess(inputFile, outputFile, errorFile)
|