Procedure DatasetFind(data\_category, dataset\_path, dataset)

DatasetFind

The procedure DatasetFind searches the Data Management tree for a dataset with a specific name and belonging to a specific data category.

DatasetFind(
        data_category,     ! (input) element in AllDataCategories
        dataset_path,      ! (input) scalar string expression
        dataset            ! (output) element parameter into AllDataSets
        )

Arguments

data_category

An element in AllDataCategories, specifying the data category for which the datasets must be searched.

dataset_path

A string expression holding the path and name of a dataset. The path is specified relative to the corresponding data category root node in the Data Management tree.

dataset

An element parameter into AllDataSets. On successful return this parameter will refer to the dataset found.

Return Value

The procedure returns 1 if the dataset is found, and 0 otherwise.

Note

  • This function is only applicable if the project option Data_Management_style is set to Single_Data_Manager_file.

See also

The procedures DatasetCreate, DatasetDelete.