Houdini 20.5 Nodes APEX nodes

graph::FindPorts

Finds the ports in an APEX graph based on a pattern.

On this page
Since 20.0

Finds an array of port 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 ports based on various criteria such as port paths in combination with wildcards, or other port data such as the value type of a port or its connection status.

APEX Path Pattern

Example pattern

Description

Separate node and port names using “:

my_node*:t

Matches all ports named t on all nodes at the top level of the graph where the node name starts with my_node.

Specify input/output ports with [in] or [out] after the portname

my_node*:t[in]

Matches all input ports named t on all nodes at the top level of the graph where the node name starts with my_node.

Combine patterns with “&” indicating that both pattern elements must be matched

my_node*:t[in] & %ispromoted(my_other_tag)

Matches all promoted input ports named t on all nodes at the top level of the graph where the node name starts with my_node.

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

Inputs

graph: ApexGraphHandle

The graph that contains the ports to find.

pattern: String

The pattern used to match the ports.

Outputs

ports: ApexPortIDArray

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

See also

APEX nodes