Contents

clipwritedat()

Usage:

clipwritedat(x1,x2,... [,missing:M] [, putNames:F] \
  [,fieldwidth:w or format:fmt]), vectors x1, x2, ..., all with same
  length, CHARACTER scalars M, fmt, integer w > 0

Keywords: output

clipwritedat() is a macro designed to copy to the clipboard vectors of
arbitrary in columnar form.  By default, the columns are headed by the
variable names.

clipwritedat(x1,x2,...) transforms data vectors x1, x2, ... to character
form and then puts them side by side as columns in special variable
CLIPBOARD.  In windowed systems (Windows, Macintosh, Motif) this also
copies them to the system clipboard.  Effectively, it sets CLIPBOARD to
an "image" of the file that would be written by writedata(fileName, x1,
x2,...).

x1, x2, ... can be of any type.  If any vector is a factor and has row
labels consistent with the factor levels, the row labels are written
instead of the factor levels.

REAL data are formatted using the current default format as returned
by getoptions(format:T), except that integer values are written as
integers with no decimal point.

CHARACTER data is written right justified in a field whose width is
taken from the default format.

LOGICAL data are written as "T" or "F" and then written like CHARACTER
data.

MISSING values are written as "?".

If any data vector is specified by a keyword phrase (x1:X[,1], for
example), the keyword is used as the vector name.  For this usage, the
keyword may not be 'keep', 'new', 'fieldwidth' or 'missing'.

The keywords for clipwritedat() are the same as those for writedata(),
except that 'new' is ignored.  See writedata() for details.

See also clipreaddata(), fromclip(), toclip(), 'clipboard'.