KiCad PCB EDA Suite
Loading...
Searching...
No Matches
NETLIST_READER Class Referenceabstract

Base class to derive netlist readers from. More...

#include <netlist_reader.h>

Inheritance diagram for NETLIST_READER:
KICAD_NETLIST_READER KICAD_NETLIST_READER LEGACY_NETLIST_READER LEGACY_NETLIST_READER

Public Types

enum  NETLIST_FILE_T {
  UNKNOWN = -1 , ORCAD , LEGACY , KICAD ,
  UNKNOWN = -1 , ORCAD , LEGACY , KICAD
}
 
enum  NETLIST_FILE_T {
  UNKNOWN = -1 , ORCAD , LEGACY , KICAD ,
  UNKNOWN = -1 , ORCAD , LEGACY , KICAD
}
 

Public Member Functions

 NETLIST_READER (LINE_READER *aLineReader, NETLIST *aNetlist, CMP_READER *aFootprintLinkReader=nullptr)
 
virtual ~NETLIST_READER ()
 
virtual void LoadNetlist ()=0
 Load the contents of the netlist file into aNetlist.
 
 NETLIST_READER (LINE_READER *aLineReader, NETLIST *aNetlist, CMP_READER *aFootprintLinkReader=nullptr)
 
virtual ~NETLIST_READER ()
 
virtual void LoadNetlist ()=0
 Load the contents of the netlist file into aNetlist.
 

Static Public Member Functions

static NETLIST_FILE_T GuessNetlistFileType (LINE_READER *aLineReader)
 Look at aFileHeaderLine to see if it matches any of the netlist file types it knows about.
 
static NETLIST_READERGetNetlistReader (NETLIST *aNetlist, const wxString &aNetlistFileName, const wxString &aCompFootprintFileName=wxEmptyString)
 Attempt to determine the net list file type of aNetlistFileName and return the appropriate NETLIST_READER type.
 
static NETLIST_FILE_T GuessNetlistFileType (LINE_READER *aLineReader)
 Look at aFileHeaderLine to see if it matches any of the netlist file types it knows about.
 
static NETLIST_READERGetNetlistReader (NETLIST *aNetlist, const wxString &aNetlistFileName, const wxString &aCompFootprintFileName=wxEmptyString)
 Attempt to determine the net list file type of aNetlistFileName and return the appropriate NETLIST_READER type.
 

Protected Attributes

NETLISTm_netlist
 The net list to read the file(s) into.
 
bool m_loadFootprintFilters
 Load the component footprint filters section if true.
 
bool m_loadNets
 Load the nets section of the netlist file if true.
 
LINE_READERm_lineReader
 The line reader of the netlist.
 
CMP_READERm_footprintReader
 The reader used to load the footprint links. If NULL, footprint links are not read.
 

Detailed Description

Base class to derive netlist readers from.

A pure virtual class to derive a specific type of netlist reader from.

This base class can be used without PCB-specific dependencies. For PCB-specific functionality (like handling FOOTPRINT objects), use the derived class in pcbnew.

Definition at line 92 of file common/netlist_reader/netlist_reader.h.

Member Enumeration Documentation

◆ NETLIST_FILE_T [1/2]

Enumerator
UNKNOWN 
ORCAD 
LEGACY 
KICAD 
UNKNOWN 
ORCAD 
LEGACY 
KICAD 

Definition at line 96 of file common/netlist_reader/netlist_reader.h.

◆ NETLIST_FILE_T [2/2]

Enumerator
UNKNOWN 
ORCAD 
LEGACY 
KICAD 
UNKNOWN 
ORCAD 
LEGACY 
KICAD 

Definition at line 97 of file pcbnew/netlist_reader/netlist_reader.h.

Constructor & Destructor Documentation

◆ NETLIST_READER() [1/2]

NETLIST_READER::NETLIST_READER ( LINE_READER * aLineReader,
NETLIST * aNetlist,
CMP_READER * aFootprintLinkReader = nullptr )
inline
Parameters
aLineReaderownership is taken of this LINE_READER.
aNetlistthe NETLIST object to read into.
aFootprintLinkReaderownership is taken of this CMP_READER.

Definition at line 113 of file common/netlist_reader/netlist_reader.h.

References m_footprintReader, m_lineReader, m_loadFootprintFilters, m_loadNets, and m_netlist.

Referenced by GetNetlistReader(), KICAD_NETLIST_READER::KICAD_NETLIST_READER(), and LEGACY_NETLIST_READER::LEGACY_NETLIST_READER().

◆ ~NETLIST_READER() [1/2]

NETLIST_READER::~NETLIST_READER ( )
virtual

Definition at line 36 of file common/netlist_reader/netlist_reader.cpp.

References m_footprintReader, and m_lineReader.

◆ NETLIST_READER() [2/2]

NETLIST_READER::NETLIST_READER ( LINE_READER * aLineReader,
NETLIST * aNetlist,
CMP_READER * aFootprintLinkReader = nullptr )
inline
Parameters
aLineReaderownership is taken of this LINE_READER.
aNetlistthe NETLIST object to read into.
aFootprintLinkReaderownership is taken of this CMP_READER.

Definition at line 114 of file pcbnew/netlist_reader/netlist_reader.h.

References m_footprintReader, m_lineReader, m_loadFootprintFilters, m_loadNets, and m_netlist.

◆ ~NETLIST_READER() [2/2]

virtual NETLIST_READER::~NETLIST_READER ( )
virtual

Member Function Documentation

◆ GetNetlistReader() [1/2]

NETLIST_READER * NETLIST_READER::GetNetlistReader ( NETLIST * aNetlist,
const wxString & aNetlistFileName,
const wxString & aCompFootprintFileName = wxEmptyString )
static

Attempt to determine the net list file type of aNetlistFileName and return the appropriate NETLIST_READER type.

Parameters
aNetlistis the netlist to load aNetlistFileName into.
aNetlistFileNameis the full path and file name of the net list to read.
aCompFootprintFileNameis the full path and file name of the component footprint associations to read. Set to wxEmptyString if loading the footprint association file is not required.
Returns
the appropriate NETLIST_READER if aNetlistFileName is a valid netlist or NULL if aNetlistFileName is not a valid netlist files.

Definition at line 76 of file common/netlist_reader/netlist_reader.cpp.

References GuessNetlistFileType(), KICAD, LEGACY, NETLIST_READER(), and ORCAD.

Referenced by TEST_NETLIST_EXPORTER_KICAD_FIXTURE::CompareNetlists(), and PCB_EDIT_FRAME::ReadNetlistFromFile().

◆ GetNetlistReader() [2/2]

static NETLIST_READER * NETLIST_READER::GetNetlistReader ( NETLIST * aNetlist,
const wxString & aNetlistFileName,
const wxString & aCompFootprintFileName = wxEmptyString )
static

Attempt to determine the net list file type of aNetlistFileName and return the appropriate NETLIST_READER type.

Parameters
aNetlistis the netlist to load aNetlistFileName into.
aNetlistFileNameis the full path and file name of the net list to read.
aCompFootprintFileNameis the full path and file name of the component footprint associations to read. Set to wxEmptyString if loading the footprint association file is not required.
Returns
the appropriate NETLIST_READER if aNetlistFileName is a valid netlist or NULL if aNetlistFileName is not a valid netlist files.

References NETLIST_READER().

◆ GuessNetlistFileType() [1/2]

NETLIST_READER::NETLIST_FILE_T NETLIST_READER::GuessNetlistFileType ( LINE_READER * aLineReader)
static

Look at aFileHeaderLine to see if it matches any of the netlist file types it knows about.

Parameters
aLineReaderis the LINE_READER object containing lines from the netlist to test.
Returns
the NETLIST_FILE_T of aLineReader.

Definition at line 43 of file common/netlist_reader/netlist_reader.cpp.

References From_UTF8(), KICAD, LEGACY, LINE_READER::Line(), ORCAD, LINE_READER::ReadLine(), and UNKNOWN.

Referenced by GetNetlistReader().

◆ GuessNetlistFileType() [2/2]

static NETLIST_FILE_T NETLIST_READER::GuessNetlistFileType ( LINE_READER * aLineReader)
static

Look at aFileHeaderLine to see if it matches any of the netlist file types it knows about.

Parameters
aLineReaderis the LINE_READER object containing lines from the netlist to test.
Returns
the NETLIST_FILE_T of aLineReader.

◆ LoadNetlist() [1/2]

virtual void NETLIST_READER::LoadNetlist ( )
pure virtual

Load the contents of the netlist file into aNetlist.

Exceptions
IO_ERRORif a file IO error occurs.
PARSE_ERRORif an error occurs while parsing the file.

Implemented in KICAD_NETLIST_READER, KICAD_NETLIST_READER, LEGACY_NETLIST_READER, and LEGACY_NETLIST_READER.

◆ LoadNetlist() [2/2]

virtual void NETLIST_READER::LoadNetlist ( )
pure virtual

Load the contents of the netlist file into aNetlist.

Exceptions
IO_ERRORif a file IO error occurs.
PARSE_ERRORif an error occurs while parsing the file.

Implemented in KICAD_NETLIST_READER, KICAD_NETLIST_READER, LEGACY_NETLIST_READER, and LEGACY_NETLIST_READER.

References m_footprintReader, m_lineReader, m_loadFootprintFilters, m_loadNets, and m_netlist.

Member Data Documentation

◆ m_footprintReader

CMP_READER * NETLIST_READER::m_footprintReader
protected

The reader used to load the footprint links. If NULL, footprint links are not read.

Definition at line 168 of file common/netlist_reader/netlist_reader.h.

Referenced by KICAD_NETLIST_READER::LoadNetlist(), LEGACY_NETLIST_READER::LoadNetlist(), LoadNetlist(), NETLIST_READER(), and ~NETLIST_READER().

◆ m_lineReader

◆ m_loadFootprintFilters

bool NETLIST_READER::m_loadFootprintFilters
protected

Load the component footprint filters section if true.

Definition at line 163 of file common/netlist_reader/netlist_reader.h.

Referenced by LEGACY_NETLIST_READER::LoadNetlist(), LoadNetlist(), and NETLIST_READER().

◆ m_loadNets

bool NETLIST_READER::m_loadNets
protected

Load the nets section of the netlist file if true.

Definition at line 164 of file common/netlist_reader/netlist_reader.h.

Referenced by LoadNetlist(), and NETLIST_READER().

◆ m_netlist


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