DADiSP Worksheet Functions > Function Categories > Datasets, Worksheets and Labbooks > COPYDATASET

 

COPYDATASET

 

Purpose:

Copies a Series from a Dataset.

Syntax:

COPYDATASET("srcdname", "desdname", verbose, overwrite)

"scrdname"

-

A string. The source Dataset to copy from. The name can also contain a path and Labbook specifier.

"desdname"

-

Optional, a string. The destination Dataset to copy to. Defaults to the same Dataset name in "srcdname".

verbose

-

Optional. An integer, the message display flag:

0:

do not display messages

1:

display error messages and warnings (default)

overwrite

-

Optional. An integer, the overwrite series flag.

0:

do not overwrite existing Dataset (default)

1:

overwrite existing Dataset if it already exists

Returns:

An integer, 1 if the source Dataset is successfully copied to the destination Dataset, else 0.

Example:

copydataset("Demo4 UN1.1")

 

copies the Dataset RUN1.1 from the Demo4 Labbook to the Dataset RUN1.1 in current Labbook.

Example:

copydataset("Dir1ook1 UN1.1","Dir2ook2Job.2", 0)

 

Copies the Dataset RUN1.1 in the Book1 Labbook located in the Dir1 sub-directory to the Dataset Job.2 in the Book2 Labbook located in the Dir2 sub-directory. The copy is performed silently.

Remarks:

The specified Dataset names are case-sensitive.

 

The Dataset name must also contain the Version number.

 

The name string can contain directory and Labbook specifiers separated by the path delimiter.

See Also:

COPYSERIES

DELETEDATASET

DELETEWORKSHEET

LOADDATASET

LOADSERIES

SAVESERIES