Returns 1 if the input series or string is a dataset series.
ISDSSERIES(series, "dsname")
series |
- |
Optional, a series. The series to test. |
"dsname" |
- |
Optional, a string. The full dataset.ver.series name to test. |
1 if the series or series name exists in a saved dataset within the current Labbook, else 0.
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.
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.