ecl-logo Documentation

NamedObject

NamedObject[obj]namedObj

returns `obj` with the ID replaced with the Name of `obj`, if it has a name. Otherwise just returns `obj`.

NamedObject[expr]namedExpr

returns `expr` with all ObjectReferences, Links, and Packets replaced with the ObjectReferences by Name where applicable (to infinite depth).

Details

    Input
    Output
    General Options

Examples

Basic Examples  (4)

Convert a Link to show the Object's Name instead of an ID:

Convert an ObjectReference to show the Object's Name instead of an ID:

Convert a packet to the named version of the object:

Convert multiple ObjectReferences to show the Object's Name instead of an ID:

Additional Examples  (3)

Convert a shorthand Object reference:

Find all Objects at arbitrary depth in an arbitrary expresison and convert to named form where possible:

If a Null or $Failed is in the input list, just return Null or $Failed:

Options  (3)

ConvertToObjectReference  (2)

Leaves links in place (with IDs converted to names) if ConvertToObjectReference is set to False:

Replaces links with object references if ConvertToObjectReference is set to True:

MaxNumberOfObjects  (1)

If the expression includes more than MaxNumberOfObjects objects than leaves the input expression untouched.

Last modified on Mon 10 Jul 2023 16:59:43