Houdini 21.0 Nodes APEX nodes

graph::FindUniqueNodeName

Returns a unique node name given a desired name.

On this page
Since 21.0

Searches for a desired node name, name, in a graph or (optional) subnet, and if found, returns a unique node name by adding or incrementing the number at the end of name. If name is not found, it is returned unchanged.

Inputs

graph: ApexGraphHandle

The graph to search.

name: String

The desired node name to search for.

subnetid: ApexNodeID

(Optional) A subnet to search for node names. If this input is not connected, searches the root level of graph. If connected, graph is not searched and only this subnet is searched.

Outputs

name: String

If input name is found in graph or subnetid, this is the unique name created by incrementing the number at the end of input name, or appending a “1” if there is no number at the end of input name. If input name is not found in graph or subnetid, it is returned unchanged.

See also

APEX nodes