/usr/share/doc/pspp/pspp.html/LEAVE.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU PSPP version 0.8.4,
software for statistical analysis.

Copyright (C) 1997, 1998, 2004, 2005, 2009, 2012, 2013, 2014 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled "GNU
Free Documentation License". -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>PSPP: LEAVE</title>

<meta name="description" content="PSPP: LEAVE">
<meta name="keywords" content="PSPP: LEAVE">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Variable-Attributes.html#Variable-Attributes" rel="up" title="Variable Attributes">
<link href="MISSING-VALUES.html#MISSING-VALUES" rel="next" title="MISSING VALUES">
<link href="FORMATS.html#FORMATS" rel="prev" title="FORMATS">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="LEAVE"></a>
<div class="header">
<p>
Next: <a href="MISSING-VALUES.html#MISSING-VALUES" accesskey="n" rel="next">MISSING VALUES</a>, Previous: <a href="FORMATS.html#FORMATS" accesskey="p" rel="prev">FORMATS</a>, Up: <a href="Variable-Attributes.html#Variable-Attributes" accesskey="u" rel="up">Variable Attributes</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="LEAVE-1"></a>
<h3 class="section">11.5 LEAVE</h3>
<a name="index-LEAVE"></a>

<div class="display">
<pre class="display">LEAVE <var>var_list</var>.
</pre></div>

<p><code>LEAVE</code> prevents the specified variables from being
reinitialized whenever a new case is processed.
</p>
<p>Normally, when a data file is processed, every variable in the active
dataset is initialized to the system-missing value or spaces at the
beginning of processing for each case.  When a variable has been
specified on <code>LEAVE</code>, this is not the case.  Instead, that variable is
initialized to 0 (not system-missing) or spaces for the first case.
After that, it retains its value between cases.
</p>
<p>This becomes useful for counters.  For instance, in the example below
the variable <code>SUM</code> maintains a running total of the values in the <code>ITEM</code>
variable.
</p>
<div class="example">
<pre class="example">DATA LIST /ITEM 1-3.
COMPUTE SUM=SUM+ITEM.
PRINT /ITEM SUM.
LEAVE SUM
BEGIN DATA.
123
404
555
999
END DATA.
</pre></div>

<p>Partial output from this example:
</p>
<div class="example">
<pre class="example">123   123.00
404   527.00
555  1082.00
999  2081.00
</pre></div>

<p>It is best to use <code>LEAVE</code> command immediately before invoking a
procedure command, because the left status of variables is reset by
certain transformations&mdash;for instance, <code>COMPUTE</code> and <code>IF</code>.
Left status is also reset by all procedure invocations.
</p>



</body>
</html>
pspp 0.8.4-1 / usr / share / doc / pspp / pspp.html / LEAVE.html
