/usr/share/doc/pspp/pspp.html/SAVE-TRANSLATE.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: SAVE TRANSLATE</title>

<meta name="description" content="PSPP: SAVE TRANSLATE">
<meta name="keywords" content="PSPP: SAVE TRANSLATE">
<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="SAVE-TRANSLATE-_002fTYPE_003dCSV-and-TYPE_003dTAB.html#SAVE-TRANSLATE-_002fTYPE_003dCSV-and-TYPE_003dTAB" rel="next" title="SAVE TRANSLATE /TYPE=CSV and TYPE=TAB">
<link href="SAVE.html#SAVE" rel="prev" title="SAVE">
<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="SAVE-TRANSLATE"></a>
<div class="header">
<p>
Next: <a href="SYSFILE-INFO.html#SYSFILE-INFO" accesskey="n" rel="next">SYSFILE INFO</a>, Previous: <a href="SAVE.html#SAVE" accesskey="p" rel="prev">SAVE</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="SAVE-TRANSLATE-1"></a>
<h3 class="section">9.7 SAVE TRANSLATE</h3>
<a name="index-SAVE-TRANSLATE"></a>

<div class="display">
<pre class="display">SAVE TRANSLATE
        /OUTFILE={&rsquo;<var>file_name</var>&rsquo;,<var>file_handle</var>}
        /TYPE={CSV,TAB}
        [/REPLACE]
        [/MISSING={IGNORE,RECODE}]

        [/DROP=<var>var_list</var>]
        [/KEEP=<var>var_list</var>]
        [/RENAME=(<var>src_names</var>=<var>target_names</var>)&hellip;]
        [/UNSELECTED={RETAIN,DELETE}]
        [/MAP]

        &hellip;additional subcommands depending on TYPE&hellip;
</pre></div>

<p>The <code>SAVE TRANSLATE</code> command is used to save data into various
formats understood by other applications.
</p>
<p>The <code>OUTFILE</code> and <code>TYPE</code> subcommands are mandatory.
<code>OUTFILE</code> specifies the file to be written, as a string file name or a file handle
(see <a href="File-Handles.html#File-Handles">File Handles</a>).  <code>TYPE</code> determines the type of the file or
source to read.  It must be one of the following:
</p>
<dl compact="compact">
<dt>CSV</dt>
<dd><p>Comma-separated value format,
</p>
</dd>
<dt>TAB</dt>
<dd><p>Tab-delimited format.
</p></dd>
</dl>

<p>By default, <code>SAVE TRANSLATE</code> will not overwrite an existing file.  Use
<code>REPLACE</code> to force an existing file to be overwritten.
</p>
<p>With MISSING=IGNORE, the default, <code>SAVE TRANSLATE</code> treats user-missing
values as if they were not missing.  Specify MISSING=RECODE to output
numeric user-missing values like system-missing values and string
user-missing values as all spaces.
</p>
<p>By default, all the variables in the active dataset dictionary are saved
to the system file, but <code>DROP</code> or <code>KEEP</code> can select a subset of variable
to save.  The <code>RENAME</code> subcommand can also be used to change the names
under which variables are saved.  <code>UNSELECTED</code> determines whether cases
filtered out by the <code>FILTER</code> command are written to the output file.
These subcommands have the same syntax and meaning as on the
<code>SAVE</code> command (see <a href="SAVE.html#SAVE">SAVE</a>).
</p>
<p>Each supported file type has additional subcommands, explained in
separate sections below.
</p>
<p><code>SAVE TRANSLATE</code> causes the data to be read.  It is a procedure.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="SAVE-TRANSLATE-_002fTYPE_003dCSV-and-TYPE_003dTAB.html#SAVE-TRANSLATE-_002fTYPE_003dCSV-and-TYPE_003dTAB" accesskey="1">SAVE TRANSLATE /TYPE=CSV and TYPE=TAB</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<div class="header">
<p>
Next: <a href="SYSFILE-INFO.html#SYSFILE-INFO" accesskey="n" rel="next">SYSFILE INFO</a>, Previous: <a href="SAVE.html#SAVE" accesskey="p" rel="prev">SAVE</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.4-1 / usr / share / doc / pspp / pspp.html / SAVE-TRANSLATE.html
