PhysicalName::FullName

Returns the full repeated capability physical name which includes the identifiers for all parent repeated capability instances.

Syntax

const char* FullName() const;

Return value

The full repeated capability physical name.

Remarks

For a nested repeated capability, this represents the entire string of identifiers in the hierarchy of physical names.

For example, the full name of a nested repeated capability would be of the form:

a1:b2:c3

This FullName function would have the value a1:b2:c3.

Example

The following example demonstrates use of the FullName function.

ViStatus _VI_FUNC acme4321_ConfigureArmCount(ViSession Vi, ViConstString RepCapIdentifier, ViInt32 ArmCount)
{
    // The Trace repeated capability is a child repeated capability of some other repeated capability
    // that defines a "C1" physical name.  The "trace" variable below represents the "T1" Trace instance
    // within the C1 instance of the parent repeated capability.
    //
    PhysicalName<Trace> trace("C1:T1");

    cout << trace.FullName();  // prints "C1:T1"
}