Query_Lang-PCBFunctions_MembershipChecks_HasFootprintHasFootprint_AD

This document is no longer available beyond version 21. Information can now be found here: HasFootprint for version 24

Parent page: PCB Query Functions - Membership Checks

Summary

Returns all component objects whose Footprint property complies with the Query.

Syntax

HasFootprint(Footprint : String) : Boolean/Boolean_String

Example Usage

HasFootprint('SIP?0')
HasFootprint('SIP?0') = True
HasFootprint('SIP?0') = 'True'

Returns all component objects whose Footprint property starts with SIP and finishes with 0, and includes one other intermediate character. Example compliant footprints include SIP10, SIP20, and SIPQ0.

HasFootprint('DIP*')
HasFootprint('DIP*') = True
HasFootprint('DIP*') = 'True'

Returns all component objects whose Footprint property starts with DIP. Example compliant footprints include DIP8, DIP14, and DIP24N.

Not HasFootprint('IDC16')
HasFootprint('IDC16') = False
HasFootprint('IDC16') = 'False'

Returns all objects except component objects whose Footprint property is IDC16.

HasFootprint('*2*')
HasFootprint('*2*') = True
HasFootprint('*2*') = 'True'

Returns all component objects whose Footprint property includes the character 2. Example compliant footprints include 2012, 2N5001, IDC20, and HDR1X2.

Tips

  1. The single quote characters (') at the start and end of the Footprint string are mandatory.
  2. For each returned component object, its associated child objects are also returned.
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Note

The features available depend on your Altium product access level. Compare features included in the various levels of Altium Designer Software Subscription and functionality delivered through applications provided by the Altium 365 platform.

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.