1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170
|
<html>
<head>
<!-- This file has been generated by unroff 1.0, 01/15/08 14:06:31. -->
<!-- Do not edit! -->
<STYLE TYPE="text/css">
<!--
A:link{text-decoration:none}
A:visited{text-decoration:none}
A:active{text-decoration:none}
OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }
H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>ploticus: proc print</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550><tr>
<td>
<table cellpadding=2 width=550><tr>
<td><br><h2>proc print</h2></td>
<td align=right>
<small>
<a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
Version 2.40 Jan'08
</small><br><a href="../doc/scripthome.html">Scripts</a>
<td></tr></table>
</td></tr>
<td>
<br>
<br>
<title>Manual page for proc_print(PL)</title>
</head>
<body>
<p>
<b>proc print</b> may be used to print messages and debugging info.<tt> </tt>
It can print the contents of variables and/or
data fields to a file or to standard error.<tt> </tt>
It is mainly useful for displaying or exporting information
pertaining to outlier cases and for debugging a script.<tt> </tt>
Unless the <tt>outfile</tt> attribute is specified, information is
printed to the file/stream controlled by the <b>-diagfile</b>
command line option.<tt> </tt>
<br><br><br>
<h2>This proc is deprecated</h2>
This proc is now deprecated and may be removed from future releases.<tt> </tt>
The <tt>#write / #endwrite</tt>
<a href="scriptsyntax.html">
script directives
</a>
provide similar functionality.<tt> </tt>
<br><br><br>
<h2>Attributes</h2>
<p>
<b>label</b>
text
<dl>
<dt> <dd>
Arbitrary text that will be printed once. May include
@variable references using one at-sign (@). Typically
used to examine contents of variables or to print a header
for the cases listed by the <tt>select</tt> and <tt>print</tt> attributes.<tt> </tt>
<br><br>
</dl>
<p>
<b>select</b>
<a href="select.html">
select expression
</a>
<dl>
<dt> <dd>
Selects data records to print, using the <tt>print</tt> template.<tt> </tt>
<br><br>
</dl>
<p>
<b>print</b>
text
<dl>
<dt> <dd>
A template which may include variable and data field references.<tt> </tt>
This template will be printed once for every data record
that passes the selection condition.<tt> </tt>
Data fields are referenced by preceding with two at-signs (@@).<tt> </tt>
See example below.<tt> </tt>
<br><br>
</dl>
<p>
<b>outfile</b>
<i>filename</i>
<dl>
<dt> <dd>
If specified, the results of proc print will be written to this file.<tt> </tt>
If unspecified, results are written to the diagnostic stream (controllable
using -diagfile on command line).
<br><br>
</dl>
<p>
<b>outmode</b>
<tt>w | a</tt>
<dl>
<dt> <dd>
Controls the file write mode for <tt>outfile</tt>. Default is <tt>w</tt>.<tt> </tt>
w = write (create new file / erase
any current contents); a = append (append to any existing contents; if none then
create new file). See also fopen(2).<tt> </tt>
<br><br><br>
</dl>
<h2>Variables that are set by proc print</h2>
<b>NSELECTED</b> is set to the number of records selected.<tt> </tt>
Thus proc print may be used to count number of records meeting a certain criteria.<tt> </tt>
<br><br><br>
<h2>Example</h2>
<pre>
#set TODAY = $todaysdate()
#proc print
label: Outliers (run on @TODAY)
select: @@3 > 300
print: @@1 @@2 had a score of @@3
<br>
<br>
</td></tr>
<td align=right>
<a href="../doc/welcome.html">
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
<br>
<center>
Ploticus is hosted at http://ploticus.sourceforge.net <br>
<img src="http://sourceforge.net/sflogo.php?group_id=38453" width="88" height="31" border="0" alt="SourceForge Logo">
</center>
</pre>
<p><hr>
Markup created by <em>unroff</em> 1.0, <tt> </tt> <tt> </tt>January 15, 2008.
</body>
</html>
|