Houdini 20.5 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 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. See graph::FindNodes for an example.

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.

Outputs

nodes: ApexNodeID

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

See also

APEX nodes