ISDSSERIES

Purpose:

Returns 1 if the input series or string is a dataset series.

Syntax:

ISDSSERIES(series, "dsname")

series

-

Optional, a series. The series to test.

"dsname"

-

Optional, a string. The full dataset.ver.series name to test.

Returns:

1 if the series or series name exists in a saved dataset within the current Labbook, else 0.

Example:

W1: gnorm(1000, 1/1000);

saveseries(w1, "mydataset.1.myseries", 1);

W2: loadseries("mydataset.1.myseries");

W3: cumsum(w2);

W4: W2;

 

ds1 = isdsseries(w1);

ds2 = isdsseries(w2);

ds3 = isdsseries(w3);

ds4 = isdsseries(w4);

ds5 = isdsseries("mydataset.1.myseries");

ds6 = isdsseries("xxx");

 

The resulting assignments are:

 

ds1 == 0

ds2 == 1

ds3 == 0

ds4 == 1

ds5 == 1

ds6 == 0

 

The series in W1 is not a saved series, though a copy of the data was used to create mydataset.1.myseries.

 

The series in W2 is a saved series directly loaded by LOADSERIES.

 

The series in W3 is not a save series, though it was derived from a saved series.

 

The series in W4 is a saved series; it is a direct reference to the saved series in W2.

 

The string "mydataset.1.myseries" represents a saved series name.

 

The string "xxx" does not represent a saved series name.

Remarks:

ISDSSERIES returns 1 if the input series or input series name is a series saved in a dataset contained in the current Labbook.

 

ISDSSERIES with no input tests the current window.

 

If a dataset series is loaded into a window or variable, any new window or variable that makes a direct reference to that window or variable will contain a reference and not a copy of the loaded saved series.

 

See ISWINDS to check if a window contains a directly loaded saved series.

 

See ISDSNAME to check if a string is in valid dataset.ver.series format.

See Also:

ISDSNAME

ISSTRING

ISWINDS

LOADDATASET

LOADSERIES

SAVESERIES