txlyre
/
avram


			
				
					
						
						
							12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
							<html lang="en">
<head>
<title>Filter Mode Options - avram - a virtual machine code interpreter</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="avram - a virtual machine code interpreter">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="User-Manual.html#User-Manual" title="User Manual">
<link rel="prev" href="Modes-of-Operation.html#Modes-of-Operation" title="Modes of Operation">
<link rel="next" href="Parameter-Mode-Options.html#Parameter-Mode-Options" title="Parameter Mode Options">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
  pre.display { font-family:inherit }
  pre.format  { font-family:inherit }
  pre.smalldisplay { font-family:inherit; font-size:smaller }
  pre.smallformat  { font-family:inherit; font-size:smaller }
  pre.smallexample { font-size:smaller }
  pre.smalllisp    { font-size:smaller }
  span.sc    { font-variant:small-caps }
  span.roman { font-family:serif; font-weight:normal; } 
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
--></style>
</head>
<body>
<div class="node">
<a name="Filter-Mode-Options"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Parameter-Mode-Options.html#Parameter-Mode-Options">Parameter Mode Options</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Modes-of-Operation.html#Modes-of-Operation">Modes of Operation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="User-Manual.html#User-Manual">User Manual</a>
<hr>
</div>

<h3 class="section">1.3 Filter Mode Options</h3>

<p>The options available in filter mode are listed below. Except as
otherwise noted, all options are mutually exclusive. Ordinarily a
given application will require certain fixed settings of these options
and will not work properly if they are set inappropriately.

     <dl>
<dt><code>-r, --raw-output</code><dd><a name="index-raw_002doutput-command-line-option-25"></a>Normally the result obtained by evaluating the function in the virtual
code file must be a list of character strings, which is written as
such to standard output. However, if this option is selected, the form
of the result is unconstrained, and it will be written in a data file
format that is not human readable but can be used by other
applications. This option is incompatible with any other options
except <samp><span class="option">-u</span></samp>. 
<br><dt><code>-c, --choice-of-output</code><dd><a name="index-g_t_0040code_007bchoice_002dof_002doutput_007d-command-line-option-26"></a>When this option is used, the evaluation of the function given by the
virtual machine code will be expected to yield a data structure from
which <code>avram</code> will ascertain whether standard output should be
written in text or raw data format.  This option should be used only
if application is aware of it. It is incompatible with any other options
except <samp><span class="option">-u</span></samp>. 
<br><dt><code>-l, --line-map</code><dd><a name="index-g_t_0040code_007bline_002dmap_007d-command-line-option-27"></a>Normally the entire contents of standard input up to <code>EOF</code> are
loaded into memory and used as the argument to the function in the
virtual code file. However, this option causes standard input to be read
a line at a time, with the function applied individually to each line,
and its result in each case written immediately to standard output.  A
given application either requires this option or does not, and will not
work properly in the alternative. This option implies
<samp><span class="option">--force-text-input</span></samp> and is incompatible with any other option except
<samp><span class="option">-u</span></samp>. 
<br><dt><code>-b, --byte-transducer</code><dd><a name="index-g_t_0040code_007bbyte_002dtransducer_007d-command-line-option-28"></a>This option causes standard input to be read one character at a time,
evaluating the function given by the virtual code file each time. The
function is used as a state transition function that takes a state and
input to a next state and output. The output is written concurrently
with the input operations. A given application will not work properly
with an inappropriate setting of this option.  This option implies
<samp><span class="option">--force-text-input</span></samp> and is incompatible with any other option
except <samp><span class="option">-u</span></samp>. 
<br><dt><code>-u, --unparameterized</code><dd><a name="index-g_t_0040code_007bunparameterized_007d-command-line-option-29"></a>Normally <code>avram</code> guesses whether to use filter mode or parameter
mode depending on whether there are any parameters. Selecting this
option forces it to operate in filter mode regardless. Any parameters
that may appear on the command line after the virtual code file name
are ignored. This option may be used in conjunction with any other
filter mode option. 
</dl>

   </body></html>