Houdini 20.5 Nodes APEX nodes

graph::FindNodes

Finds an array of node IDs in an APEX graph based on a pattern.

On this page
Since 20.0

Finds an array of node IDs in an APEX graph based on a pattern. The pattern must follow the rules of the APEX path pattern syntax, which allows you to find nodes based on various criteria such as node paths in combination with wildcards, and custom metadata such as node tags and properties.

Below is an example of a pattern with wildcards. The pattern performs a traversal through all the nested subnets in the my_subnet subnet node, and matches any descendants of my_subnet that have a node name that begins with my_node:

my_subnet/**/my_node*

Below is an example of a pattern with tags. The pattern matches any node in any subnet in the graph that has my_tag and my_other_tag in the tags metadata.

%tag(my_tag) & %tag(my_other_tag)

If no nodes are found, an empty array is returned.

Inputs

graph: ApexGraphHandle

The graph that contains the nodes to find.

pattern: String

The pattern used to match the nodes.

Outputs

nodes: ApexNodeIDArray

An array of unique node identifiers, created at run time, that represents the nodes found in the graph.

See also

APEX nodes