PropValuesWires Function

Returns the values for the requested property. This will search all selected wires within a schematic. There are optional filters for choosing wires with a particular property, or property and value combination, along with options to select a specific schematic.

Arguments

Number Type Compulsory Default Description
1 string Yes Property name to retrieve values for
2 string No Filter property name
3 string No Filter property value
4 real No Schematic handle
5 string array No options

Argument 1

The name of the property to return the values for.

Argument 2

If set, will only choose wires that have this property in them. Setting this argument to the function Null will have the same effect as omitting it. This allows arguments 3 and 4 to be specified

Argument 3

If set, will only choose wires that have the property stated by argument 2, with the value stated by this argument. Setting this argument to the function Null will have the same effect as omitting it. This allows argument 4 to be specified.

Argument 4

Handle to a particular schematic. If not set, uses the currently highlighted schematic.

Argument 5

Array of length up to four to set these options:

  • 'partial' : Include partially selected wires such as wires selected only at one end will be returned.
  • 'empty' : Return an empty vector if there are no matches. Otherwise an empty string
  • 'skipdisabled' : Ignores wires that are disabled
  • 'mustpossess' : No match if instance does not possess the target property

Returns

Return type: string array

Returns the property values for all applicable properties. Note that if the property in arg 1 is not present on the specified wire, an empty string will be returned.

See Also