KiCad PCB EDA Suite
Loading...
Searching...
No Matches
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 329 of file netinfo.h.

Constructor & Destructor Documentation

◆ NETINFO_LIST()

NETINFO_LIST::NETINFO_LIST ( BOARD * aParent)

Definition at line 40 of file netinfo_list.cpp.

References AppendNet(), BOARD, m_newNetCode, and m_parent.

◆ ~NETINFO_LIST()

NETINFO_LIST::~NETINFO_LIST ( )

Definition at line 49 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 149 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 NETINFO_LIST().

◆ begin()

iterator NETINFO_LIST::begin ( ) const
inline

Definition at line 436 of file netinfo.h.

References m_netNames.

Referenced by 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 179 of file netinfo_list.cpp.

References NETINFO_ITEM::Clear(), and m_parent.

◆ clear()

void NETINFO_LIST::clear ( )
private

Delete the list of nets (and free memory).

Definition at line 55 of file netinfo_list.cpp.

References m_netCodes, m_netNames, and m_newNetCode.

Referenced by ~NETINFO_LIST().

◆ end()

iterator NETINFO_LIST::end ( ) const
inline

Definition at line 441 of file netinfo.h.

References m_netNames.

Referenced by 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 266 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 353 of file netinfo.h.

References m_netNames.

Referenced by 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 79 of file netinfo_list.cpp.

References m_netNames, and result.

◆ GetNetItem() [2/2]

NETINFO_ITEM * NETINFO_LIST::GetNetItem ( int aNetCode) const

◆ GetParent()

BOARD * NETINFO_LIST::GetParent ( ) const
inline

Definition at line 447 of file netinfo.h.

References BOARD, and m_parent.

◆ 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 359 of file netinfo.h.

References m_netCodes.

Referenced by 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 373 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 90 of file netinfo_list.cpp.

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

◆ RemoveUnusedNets()

void NETINFO_LIST::RemoveUnusedNets ( BOARD_COMMIT * aCommit)
protected

Definition at line 123 of file netinfo_list.cpp.

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

Friends And Related Symbol Documentation

◆ BOARD

friend class BOARD
friend

Definition at line 331 of file netinfo.h.

References BOARD.

Referenced by BOARD, GetParent(), and NETINFO_LIST().

Member Data Documentation

◆ m_DisplayNetnamesDirty

bool NETINFO_LIST::m_DisplayNetnamesDirty
mutable

Definition at line 484 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 490 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 489 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 492 of file netinfo.h.

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

◆ m_parent

BOARD* NETINFO_LIST::m_parent
private

Definition at line 487 of file netinfo.h.

Referenced by buildListOfNets(), GetParent(), and NETINFO_LIST().

◆ 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 369 of file netinfo.h.

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

◆ UNCONNECTED


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