KiCad PCB EDA Suite
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages Concepts
NETINFO_LIST Class Reference

Container for NETINFO_ITEM elements, which are the nets. More...

#include <netinfo.h>

Classes

class  iterator
 Wrapper class, so you can iterate through NETINFO_ITEM*s, not std::pair<int/wxString, NETINFO_ITEM*> More...
 

Public Member Functions

 NETINFO_LIST (BOARD *aParent)
 
 ~NETINFO_LIST ()
 
NETINFO_ITEMGetNetItem (int aNetCode) const
 
NETINFO_ITEMGetNetItem (const wxString &aNetName) const
 
unsigned GetNetCount () const
 
const NETNAMES_MAP & NetsByName () const
 Return the name map, at least for python.
 
const NETCODES_MAP & NetsByNetcode () const
 Return the netcode map, at least for python.
 
void RebuildDisplayNetnames () const
 
iterator begin () const
 
iterator end () const
 
BOARDGetParent () const
 

Static Public Member Functions

static NETINFO_ITEMOrphanedItem ()
 NETINFO_ITEM meaning that there was no net assigned for an item, as there was no board storing net list available.
 

Public Attributes

bool m_DisplayNetnamesDirty
 

Static Public Attributes

static const int UNCONNECTED = 0
 Constant that holds the "unconnected net" number (typically 0) all items "connected" to this net are actually not connected items.
 
static const int ORPHANED = -1
 Constant that forces initialization of a netinfo item to the NETINFO_ITEM ORPHANED (typically -1) when calling SetNetCode on board connected items.
 

Protected Member Functions

void AppendNet (NETINFO_ITEM *aNewElement)
 Add aNewElement to the end of the net list.
 
void RemoveNet (NETINFO_ITEM *aNet)
 Remove a net from the net list.
 
void RemoveUnusedNets (BOARD_COMMIT *aCommit)
 

Private Member Functions

void clear ()
 Delete the list of nets (and free memory).
 
void buildListOfNets ()
 Rebuild the list of NETINFO_ITEMs.
 
int getFreeNetCode ()
 Return the first available net code that is not used by any other net.
 

Private Attributes

BOARDm_parent
 
NETNAMES_MAP m_netNames
 map of <wxString, NETINFO_ITEM*>, is NETINFO_ITEM owner
 
NETCODES_MAP m_netCodes
 map of <int, NETINFO_ITEM*> is NOT owner
 
int m_newNetCode
 possible value for new net code assignment
 

Friends

class BOARD
 

Detailed Description

Container for NETINFO_ITEM elements, which are the nets.

Definition at line 345 of file netinfo.h.

Constructor & Destructor Documentation

◆ NETINFO_LIST()

NETINFO_LIST::NETINFO_LIST ( BOARD aParent)

Definition at line 37 of file netinfo_list.cpp.

References AppendNet().

◆ ~NETINFO_LIST()

NETINFO_LIST::~NETINFO_LIST ( )

Definition at line 46 of file netinfo_list.cpp.

References clear().

Member Function Documentation

◆ AppendNet()

void NETINFO_LIST::AppendNet ( NETINFO_ITEM aNewElement)
protected

Add aNewElement to the end of the net list.

Negative net code means it is going to be auto-assigned.

Definition at line 146 of file netinfo_list.cpp.

References getFreeNetCode(), NETINFO_ITEM::GetNetCode(), GetNetItem(), NETINFO_ITEM::GetNetname(), m_DisplayNetnamesDirty, NETINFO_ITEM::m_netCode, m_netCodes, and m_netNames.

Referenced by BOARD::Add(), and NETINFO_LIST().

◆ begin()

iterator NETINFO_LIST::begin ( ) const
inline

Definition at line 452 of file netinfo.h.

References m_netNames.

Referenced by BOARD::BeginNets(), and DSN::SPECCTRA_DB::FromBOARD().

◆ buildListOfNets()

void NETINFO_LIST::buildListOfNets ( )
private

Rebuild the list of NETINFO_ITEMs.

The list is sorted by names.

Definition at line 176 of file netinfo_list.cpp.

References NETINFO_ITEM::Clear(), m_parent, BOARD::SetAreasNetCodesFromNetNames(), and BOARD::SynchronizeNetsAndNetClasses().

Referenced by BOARD::BuildListOfNets().

◆ clear()

void NETINFO_LIST::clear ( )
private

Delete the list of nets (and free memory).

Definition at line 52 of file netinfo_list.cpp.

References m_netCodes, m_netNames, and m_newNetCode.

Referenced by BOARD::RemoveAll(), and ~NETINFO_LIST().

◆ end()

iterator NETINFO_LIST::end ( ) const
inline

Definition at line 457 of file netinfo.h.

References m_netNames.

Referenced by BOARD::EndNets(), and DSN::SPECCTRA_DB::FromBOARD().

◆ getFreeNetCode()

int NETINFO_LIST::getFreeNetCode ( )
private

Return the first available net code that is not used by any other net.

Definition at line 263 of file netinfo_list.cpp.

References m_netCodes, and m_newNetCode.

Referenced by AppendNet().

◆ GetNetCount()

unsigned NETINFO_LIST::GetNetCount ( ) const
inline
Returns
the number of nets ( always >= 1 ) because the first net is the "not connected" net and always exists

Definition at line 369 of file netinfo.h.

References m_netNames.

Referenced by BOARD::FindNet(), BOARD::GetNetCount(), FABMASTER::loadZones(), BOARD::operator==(), and DIALOG_COPPER_ZONE::readNetInformation().

◆ GetNetItem() [1/2]

NETINFO_ITEM * NETINFO_LIST::GetNetItem ( const wxString &  aNetName) const
Parameters
aNetNamenet name to identify a given NETINFO_ITEM.
Returns
net item by aNetName, or NULL if not found.

Definition at line 76 of file netinfo_list.cpp.

References m_netNames.

◆ GetNetItem() [2/2]

◆ GetParent()

BOARD * NETINFO_LIST::GetParent ( ) const
inline

Definition at line 463 of file netinfo.h.

References m_parent.

Referenced by NET_SELECTOR_COMBOPOPUP::Accept().

◆ NetsByName()

const NETNAMES_MAP & NETINFO_LIST::NetsByName ( ) const
inline

◆ NetsByNetcode()

const NETCODES_MAP & NETINFO_LIST::NetsByNetcode ( ) const
inline

Return the netcode map, at least for python.

Definition at line 375 of file netinfo.h.

References m_netCodes.

Referenced by PCB_NET_INSPECTOR_PANEL::buildNetsList(), DRC_TEST_PROVIDER_CREEPAGE::CollectNetCodes(), and PCB_PROPERTIES_PANEL::updateLists().

◆ OrphanedItem()

static NETINFO_ITEM * NETINFO_LIST::OrphanedItem ( )
inlinestatic

NETINFO_ITEM meaning that there was no net assigned for an item, as there was no board storing net list available.

Definition at line 389 of file netinfo.h.

References UNCONNECTED.

Referenced by PNS_KICAD_IFACE::createBoardItem(), BOARD::FindNet(), PNS_KICAD_IFACE_BASE::GetOrphanedNetHandle(), PCB_CONTROL::Paste(), and BOARD_CONNECTED_ITEM::SetNetCode().

◆ RebuildDisplayNetnames()

void NETINFO_LIST::RebuildDisplayNetnames ( ) const

◆ RemoveNet()

void NETINFO_LIST::RemoveNet ( NETINFO_ITEM aNet)
protected

Remove a net from the net list.

Definition at line 87 of file netinfo_list.cpp.

References m_DisplayNetnamesDirty, NETINFO_ITEM::m_netCode, m_netCodes, m_netNames, and m_newNetCode.

Referenced by BOARD::Remove().

◆ RemoveUnusedNets()

void NETINFO_LIST::RemoveUnusedNets ( BOARD_COMMIT aCommit)
protected

Definition at line 120 of file netinfo_list.cpp.

References m_DisplayNetnamesDirty, m_netCodes, m_netNames, and COMMIT::Removed().

Referenced by BOARD::RemoveUnusedNets().

Friends And Related Function Documentation

◆ BOARD

friend class BOARD
friend

Definition at line 347 of file netinfo.h.

Member Data Documentation

◆ m_DisplayNetnamesDirty

bool NETINFO_LIST::m_DisplayNetnamesDirty
mutable

Definition at line 500 of file netinfo.h.

Referenced by AppendNet(), RebuildDisplayNetnames(), RemoveNet(), and RemoveUnusedNets().

◆ m_netCodes

NETCODES_MAP NETINFO_LIST::m_netCodes
private

map of <int, NETINFO_ITEM*> is NOT owner

Definition at line 506 of file netinfo.h.

Referenced by AppendNet(), clear(), getFreeNetCode(), GetNetItem(), NetsByNetcode(), RemoveNet(), and RemoveUnusedNets().

◆ m_netNames

NETNAMES_MAP NETINFO_LIST::m_netNames
private

map of <wxString, NETINFO_ITEM*>, is NETINFO_ITEM owner

Definition at line 505 of file netinfo.h.

Referenced by AppendNet(), begin(), clear(), end(), GetNetCount(), GetNetItem(), NetsByName(), RemoveNet(), and RemoveUnusedNets().

◆ m_newNetCode

int NETINFO_LIST::m_newNetCode
private

possible value for new net code assignment

Definition at line 508 of file netinfo.h.

Referenced by clear(), getFreeNetCode(), and RemoveNet().

◆ m_parent

BOARD* NETINFO_LIST::m_parent
private

Definition at line 503 of file netinfo.h.

Referenced by buildListOfNets(), and GetParent().

◆ ORPHANED

const int NETINFO_LIST::ORPHANED = -1
static

Constant that forces initialization of a netinfo item to the NETINFO_ITEM ORPHANED (typically -1) when calling SetNetCode on board connected items.

Definition at line 385 of file netinfo.h.

Referenced by FOOTPRINT::ClearAllNets(), DRAWING_TOOL::DrawVia(), PCB_IO_KICAD_SEXPR_PARSER::parsePAD(), and BOARD::SanitizeNetcodes().

◆ UNCONNECTED


The documentation for this class was generated from the following files: