/usr/share/doc/pspp/pspp.html/GET.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.5,
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 6.0, http://www.gnu.org/software/texinfo/ -->
<head>
<title>PSPP: GET</title>

<meta name="description" content="PSPP: GET">
<meta name="keywords" content="PSPP: GET">
<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="System-and-Portable-File-IO.html#System-and-Portable-File-IO" rel="up" title="System and Portable File IO">
<link href="GET-DATA.html#GET-DATA" rel="next" title="GET DATA">
<link href="EXPORT.html#EXPORT" rel="prev" title="EXPORT">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
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">
<a name="GET"></a>
<div class="header">
<p>
Next: <a href="GET-DATA.html#GET-DATA" accesskey="n" rel="next">GET DATA</a>, Previous: <a href="EXPORT.html#EXPORT" accesskey="p" rel="prev">EXPORT</a>, Up: <a href="System-and-Portable-File-IO.html#System-and-Portable-File-IO" accesskey="u" rel="up">System and Portable File IO</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="GET-1"></a>
<h3 class="section">9.3 GET</h3>
<a name="index-GET-1"></a>

<div class="display">
<pre class="display">GET
        /FILE={&rsquo;<var>file_name</var>&rsquo;,<var>file_handle</var>}
        /DROP=<var>var_list</var>
        /KEEP=<var>var_list</var>
        /RENAME=(<var>src_names</var>=<var>target_names</var>)&hellip;
        /ENCODING=&rsquo;<var>encoding</var>&rsquo;
</pre></div>

<p><code>GET</code> clears the current dictionary and active dataset and
replaces them with the dictionary and data from a specified file.
</p>
<p>The <code>FILE</code> subcommand is the only required subcommand.  Specify
the SPSS system file, SPSS/PC+ system file, or SPSS portable file to
be read as a string file name or a file handle (see <a href="File-Handles.html#File-Handles">File Handles</a>).
</p>
<p>By default, all the variables in a file are read.  The DROP
subcommand can be used to specify a list of variables that are not to be
read.  By contrast, the <code>KEEP</code> subcommand can be used to specify
variable that are to be read, with all other variables not read.
</p>
<p>Normally variables in a file retain the names that they were
saved under.  Use the <code>RENAME</code> subcommand to change these names.
Specify,
within parentheses, a list of variable names followed by an equals sign
(&lsquo;<samp>=</samp>&rsquo;) and the names that they should be renamed to.  Multiple
parenthesized groups of variable names can be included on a single
<code>RENAME</code> subcommand.
Variables&rsquo; names may be swapped using a <code>RENAME</code>
subcommand of the form <code>/RENAME=(<var>A</var> <var>B</var>=<var>B</var> <var>A</var>)</code>.
</p>
<p>Alternate syntax for the <code>RENAME</code> subcommand allows the parentheses to be
eliminated.  When this is done, only a single variable may be renamed at
once.  For instance, <code>/RENAME=<var>A</var>=<var>B</var></code>.  This alternate syntax is
deprecated.
</p>
<p><code>DROP</code>, <code>KEEP</code>, and <code>RENAME</code> are executed in left-to-right order.  
Each may be present any number of times.  <code>GET</code> never modifies a
file on disk.  Only the active dataset read from the file
is affected by these subcommands.
</p>
<p><small>PSPP</small> automatically detects the encoding of string data in the file,
when possible.  The character encoding of old SPSS system files cannot
always be guessed correctly, and SPSS/PC+ system files do not include
any indication of their encoding.  Specify the <code>ENCODING</code>
subcommand with an <acronym>IANA</acronym> character set name as its string
argument to override the default.  Use <code>SYSFILE INFO</code> to analyze
the encodings that might be valid for a system file.  The
<code>ENCODING</code> subcommand is a <small>PSPP</small> extension.
</p>
<p><code>GET</code> does not cause the data to be read, only the dictionary.  The data
is read later, when a procedure is executed.
</p>
<p>Use of <code>GET</code> to read a portable file is a <small>PSPP</small> extension.
</p>
<hr>
<div class="header">
<p>
Next: <a href="GET-DATA.html#GET-DATA" accesskey="n" rel="next">GET DATA</a>, Previous: <a href="EXPORT.html#EXPORT" accesskey="p" rel="prev">EXPORT</a>, Up: <a href="System-and-Portable-File-IO.html#System-and-Portable-File-IO" accesskey="u" rel="up">System and Portable File IO</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>



</body>
</html>
pspp 0.8.5-5build1 / usr / share / doc / pspp / pspp.html / GET.html
