Houdini 21.0 Nodes APEX nodes

dict::GetNested<T>

Gets a value from a dictionary of dictionaries.

On this page
Since 21.0

Traverses nested dictionaries using the keys array to retrieve a value. If successful, the value output is set to the value retrieved. Otherwise, value is set to the default value.

For example, if we have the following dictionary of dictionaries:

"nested_dict": {
    "a_nested_value": 15
},
"another_nested_dict": ...

To retrieve value 15, set the keys array to ["nested_dict", "a_nested_value"].

Inputs

dict: Dict

The dictionary from which to get the value.

keys: StringArray

The sequence of keys to traverse to get value.

default: AnimChannel, AnimChannelCollection, AnimStack ApexGraphHandle, ApexNodeID, ApexPortID, Bool, ColorRamp, Dict, DynamicPath, FBIKSkeleton, FBIKSolver, FBIKTarget, Float, FloatRamp, Geometry, Int, Matrix3, Matrix4, SimRootDataId, String, Vector2, Vector3, Vector4

The value to return if no entry corresponding to the sequence of keys exists.

Outputs

value: AnimChannel, AnimChannelCollection, AnimStack ApexGraphHandle, ApexNodeID, ApexPortID, Bool, ColorRamp, Dict, DynamicPath, FBIKSkeleton, FBIKSolver, FBIKTarget, Float, FloatRamp, Geometry, Int, Matrix3, Matrix4, SimRootDataId, String, Vector2, Vector3, Vector4

The value corresponding to the sequence of keys in dict. If the sequence of keys don’t exist, value is set to the default value.

success: Bool

Returns True if value is returned successfully.

See also

APEX nodes