Houdini 21.0 Nodes APEX nodes

graph::FindFirstNode

Returns the first matched node in an APEX graph based on a pattern.

On this page
Since 20.5

This is a convenience wrapper that returns the first matched result of graph::FindNodes. The pattern used to match the node must follow the rules of the APEX path pattern syntax, which allow you to find nodes based on various criteria such as node paths in combination with wildcards, and custom metadata like node tags and properties. See graph::FindNodes for some examples.

If no node is found, an invalid node ID is returned. The Convert<ApexNodeID, Bool> node can be used to determine whether or not a node ID is valid.

Inputs

graph: ApexGraphHandle

The graph that contains the node to find.

pattern: String

The pattern used to match the node. The pattern must follow the rules of the APEX path pattern syntax.

breadthfirst: Bool

If set to True, performs a breadth-first search on the nodes. If set to False, performs a depth-first search.

Outputs

nodeid: ApexNodeID

The unique node identifier, created at run time, that represents the node found in the graph.

See also

APEX nodes