Summary
Returns a list of datasets in the current workspace. Search conditions can be specified for the dataset name and dataset type to limit the list that is returned.
Discussion
The workspace environment must be set before using several of the list functions, including ListDatasets, ListFeatureClasses, ListFiles, ListRasters, ListTables, and ListWorkspaces.
Syntax
ListDatasets ({wild_card}, {feature_type})
Parameter | Explanation | Data Type | ||||||
wild_card | Limits the results returned. If a value is not specified, all values are returned. The wildcard is not case sensitive.
| String | ||||||
feature_type | The type of dataset that will be returned.
(The default value is All) | String |
Data Type | Explanation |
String | A list containing dataset names returned from the function, limited by the wildcard and feature type arguments. |
Code sample
List feature dataset names that start with C.
import arcpy
arcpy.env.workspace = "c:/data"
# Print to the Interactive window all the feature datasets in the
# workspace that start with the letter C.
datasets = arcpy.ListDatasets("C*", "Feature")
for dataset in datasets:
print(dataset)
List feature dataset names that start with c or f, start with letters except c, or contain both c and f.
import arcpy
arcpy.env.workspace = 'c:/data'
# Print to the interactive window all the feature datasets in the
# workspaces that start with the letter c or f.
datasets1 = list(set(arcpy.ListDatasets("c*", "Feature")) |
set(arcpy.ListDatasets("f*", "Feature")))
print(datasets1)
# workspaces that start with the letters except c
datasets2 = list(set(arcpy.ListDatasets("*", "Feature")) -
set(arcpy.ListDatasets("c*", "Feature")))
print(datasets2)
# workspaces that contain both the letter c and f
datasets3 = list(set(arcpy.ListDatasets("*c*", "Feature")) &
set(arcpy.ListDatasets("*f*", "Feature")))
print(datasets3)
List trace network datasets using the feature_type keyword argument.
import arcpy
arcpy.env.workspace = 'c:/data/myGDB.gdb/TN_dataset'
# Print to the interactive window all the trace networks in the
# workspace using the feature type keyword.
datasets = arcpy.ListDatasets(feature_type="tracenetwork")
for dataset in datasets:
print(dataset)