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
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
.ig >>
<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.33 Jun'06
</small><br><a href="../doc/scripthome.html">Scripts</a>
<td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>
.TH proc_print PL "02-JUN-2006 PL ploticus.sourceforge.net"
.LP
\fBproc print\fR may be used to print messages and debugging info.
It can print the contents of variables and/or
data fields to a file or to standard error.
It is mainly useful for displaying or exporting information
pertaining to outlier cases and for debugging a script.
Unless the \fCoutfile\fR attribute is specified, information is
printed to the file/stream controlled by the \fB-diagfile\fR
command line option.
.ig >>
<br><br><br>
.>>
.SH This proc is deprecated
This proc is now deprecated and may be removed from future releases.
The \fC#write / #endwrite\fR
.ig >>
<a href="scriptsyntax.html">
.>>
\0script directives
.ig >>
</a>
.>>
provide similar functionality.
.ig >>
<br><br><br>
.>>
.SH Attributes
.LP
\fBlabel\fR
.ig >>
.>>
text
.IP \0
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 \fCselect\fR and \fCprint\fR attributes.
.ig >>
<br><br>
.>>
.LP
\fBselect\fR
.ig >>
.>>
.ig >>
<a href="select.html">
.>>
\0select expression
.ig >>
</a>
.>>
.IP \0
Selects data records to print, using the \fCprint\fR template.
.ig >>
<br><br>
.>>
.LP
\fBprint\fR
.ig >>
.>>
text
.IP \0
A template which may include variable and data field references.
This template will be printed once for every data record
that passes the selection condition.
Data fields are referenced by preceding with two at-signs (@@).
See example below.
.ig >>
<br><br>
.>>
.LP
\fBoutfile\fR
.ig >>
.>>
\fIfilename\fR
.IP \0
If specified, the results of proc print will be written to this file.
If unspecified, results are written to the diagnostic stream (controllable
using -diagfile on command line).
.ig >>
<br><br>
.>>
.LP
\fBoutmode\fR
.ig >>
.>>
\fCw | a\fR
.IP \0
Controls the file write mode for \fCoutfile\fR. Default is \fCw\fR.
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).
.ig >>
<br><br><br>
.>>
.SH Variables that are set by proc print
\fBNSELECTED\fR is set to the number of records selected.
Thus proc print may be used to count number of records meeting a certain criteria.
.ig >>
<br><br><br>
.>>
.SH Example
.nf
\0#set TODAY = $todaysdate()
\0#proc print
\0label: Outliers (run on @TODAY)
\0select: @@3 > 300
\0print: @@1 @@2 had a score of @@3
.ig >>
<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>
.>>
|
