# FilterResults¶

Searches an input scene for all locations matched by a filter.

Caution

This can be an arbitrarily expensive operation depending on the size of the input scene and the filter used. In particular it should be noted that the usage of ... in a PathFilter will cause the entire input scene to be searched even if there are no matches to be found.

## user¶

Container for user-defined plugs. Nodes should never make their own plugs here, so users are free to do as they wish.

## scene¶

The scene to be searched for matching locations.

## filter¶

The filter to be used when searching for matching locations.

## root¶

Isolates the search to this location and its descendants.

## out¶

The results of the search, as an IECore::PathMatcher object. This is most useful for performing hierarchical queries and for iterating through the paths without an expensive conversion to strings.

## outStrings¶

The results of the search, converted to a list of strings. This is useful for connecting directly to other plugs, such as Wedge.strings or CollectScenes.rootNames.