#include <initializer_list>
#include <wx/string.h>

Classes
struct	TEMPLATE_FIELDNAME
	Hold a name of a symbol's field, field value, and default visibility. More...

class	TEMPLATES

Macros
#define	MANDATORY_FIELDS

#define	GLOBALLABEL_MANDATORY_FIELDS { FIELD_T::INTERSHEET_REFS }

#define	SHEET_MANDATORY_FIELDS

#define	DO_TRANSLATE true

Enumerations
enum class	FIELD_T : int { USER , REFERENCE , VALUE , FOOTPRINT , DATASHEET , DESCRIPTION , INTERSHEET_REFS , SHEET_NAME , SHEET_FILENAME , SHEET_USER }
	The set of all field indices assuming an array like sequence that a SCH_COMPONENT or LIB_PART can hold. More...

Functions
wxString	GetDefaultFieldName (FIELD_T aFieldId, bool aTranslateForHI)
	Return a default symbol field name for a mandatory field type.

wxString	GetUserFieldName (int aFieldNdx, bool aTranslateForHI)

wxString	GetCanonicalFieldName (FIELD_T aFieldType)

bool	FieldNamesAreDuplicates (const wxString &aLhs, const wxString &aRhs, std::initializer_list< FIELD_T > aMandatoryFields)
	Test whether two field names should be treated as duplicates for the purposes of field name uniqueness within a given parent (symbol, sheet, or global label).

bool	FieldNamesAreDuplicates (const wxString &aLhs, const wxString &aRhs)
	Convenience overload defaulting to symbol mandatory fields.

Macro Definition Documentation

◆ DO_TRANSLATE

#define DO_TRANSLATE true

Definition at line 68 of file template_fieldnames.h.

Referenced by SCH_SHEET::Deserialize(), DIALOG_CHANGE_SYMBOLS::DIALOG_CHANGE_SYMBOLS(), DIALOG_UPDATE_SYMBOL_FIELDS::DIALOG_UPDATE_SYMBOL_FIELDS(), SCH_EDIT_TOOL::editFieldText(), GetCanonicalFieldName(), PCB_FIELD::GetName(), SCH_FIELD::GetName(), FIELDS_GRID_TABLE::GetValue(), VIEW_CONTROLS_GRID_DATA_MODEL::GetValue(), EESCHEMA_JOBS_HANDLER::JobExportBom(), DIALOG_SYMBOL_FIELDS_TABLE::LoadFieldNames(), SCH_IO_KICAD_LEGACY::loadSymbol(), DIALOG_FOOTPRINT_PROPERTIES::OnAddField(), DIALOG_FOOTPRINT_PROPERTIES_FP_EDITOR::OnAddField(), DIALOG_LIB_SYMBOL_PROPERTIES::OnAddField(), DIALOG_SHEET_PROPERTIES::OnAddField(), DIALOG_SYMBOL_PROPERTIES::OnAddField(), PCB_IO_KICAD_SEXPR_PARSER::parsePCB_TEXT(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveField(), SCH_FIELD::SCH_FIELD(), SCH_SHEET::SCH_SHEET(), and DIALOG_LIB_FIELDS_TABLE::UpdateFieldList().

◆ GLOBALLABEL_MANDATORY_FIELDS

#define GLOBALLABEL_MANDATORY_FIELDS { FIELD_T::INTERSHEET_REFS }

Definition at line 61 of file template_fieldnames.h.

Referenced by BOOST_AUTO_TEST_CASE(), DIALOG_LABEL_PROPERTIES::OnGridCellChanging(), and SCH_IO_KICAD_SEXPR_PARSER::parseSchField().

◆ MANDATORY_FIELDS

#define MANDATORY_FIELDS

Value:

                           { FIELD_T::REFERENCE,        \
                           FIELD_T::VALUE,            \
                           FIELD_T::FOOTPRINT,        \
                           FIELD_T::DATASHEET,        \
                           FIELD_T::DESCRIPTION }

Definition at line 55 of file template_fieldnames.h.

Referenced by TEMPLATES::AddTemplateFieldName(), LIB_SYMBOL_LIBRARY_MANAGER::CreateSymbol(), DIALOG_CHANGE_SYMBOLS::DIALOG_CHANGE_SYMBOLS(), DIALOG_UPDATE_SYMBOL_FIELDS::DIALOG_UPDATE_SYMBOL_FIELDS(), FieldNamesAreDuplicates(), LIB_SYMBOL::Flatten(), VIEW_CONTROLS_GRID_DATA_MODEL::GetValue(), EESCHEMA_JOBS_HANDLER::JobExportBom(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadAliases(), DIALOG_CHANGE_SYMBOLS::onOkButtonClicked(), DIALOG_UPDATE_SYMBOL_FIELDS::onOkButtonClicked(), DIALOG_SYMBOL_FIELDS_TABLE::OnRemoveField(), DIALOG_SYMBOL_FIELDS_TABLE::OnRenameField(), SCH_IO_KICAD_SEXPR_PARSER::parseProperty(), SCH_IO_KICAD_SEXPR_PARSER::parseSchField(), DIALOG_CHANGE_SYMBOLS::updateFieldsList(), and DIALOG_UPDATE_SYMBOL_FIELDS::updateFieldsList().

◆ SHEET_MANDATORY_FIELDS

#define SHEET_MANDATORY_FIELDS

Value:

{ FIELD_T::SHEET_NAME, \

FIELD_T::SHEET_FILENAME }

FIELD_T::SHEET_NAME

@ SHEET_NAME

Definition template_fieldnames.h:50

FIELD_T::SHEET_FILENAME

@ SHEET_FILENAME

Definition template_fieldnames.h:51

Definition at line 63 of file template_fieldnames.h.

Referenced by BOOST_AUTO_TEST_CASE(), DIALOG_SHEET_PROPERTIES::OnGridCellChanging(), and SCH_IO_KICAD_SEXPR_PARSER::parseSchField().

Enumeration Type Documentation

◆ FIELD_T

enum class FIELD_T : int

strong

The set of all field indices assuming an array like sequence that a SCH_COMPONENT or LIB_PART can hold.

The first fields are fixed fields and are defined by MANDATORY_FIELDS. After that come an unlimited number of user defined fields, only some of which have indices defined here.

NOTE: this must stay a enum class to prevent developers from trying to use it as an array index.

Enumerator
USER	The field ID hasn't been set yet; field is invalid.
REFERENCE	Field Reference of part, i.e. "IC21".
VALUE	Field Value of part, i.e. "3.3K".
FOOTPRINT	Field Name Module PCB, i.e. "16DIP300".
DATASHEET	name of datasheet
DESCRIPTION	Field Description of part, i.e. "1/4W 1% Metal Film Resistor".
INTERSHEET_REFS	Global label cross-reference page numbers.
SHEET_NAME
SHEET_FILENAME
SHEET_USER

Definition at line 41 of file template_fieldnames.h.

Function Documentation

◆ FieldNamesAreDuplicates() [1/2]

bool FieldNamesAreDuplicates	(	const wxString &	aLhs,
		const wxString &	aRhs )

Convenience overload defaulting to symbol mandatory fields.

Definition at line 118 of file template_fieldnames.cpp.

References FieldNamesAreDuplicates(), and MANDATORY_FIELDS.

◆ FieldNamesAreDuplicates() [2/2]

bool FieldNamesAreDuplicates	(	const wxString &	aLhs,
		const wxString &	aRhs,
		std::initializer_list< FIELD_T >	aMandatoryFields )

Test whether two field names should be treated as duplicates for the purposes of field name uniqueness within a given parent (symbol, sheet, or global label).

Mandatory field names in the supplied set are matched case-insensitively because the s-expression parser folds case variants onto the canonical mandatory field on load. User-defined field names retain their original case in storage, so two user fields that differ only in case (e.g. "Manufacturer" vs "MANUFACTURER") are considered distinct.

Pass MANDATORY_FIELDS for symbol contexts, SHEET_MANDATORY_FIELDS for sheets, or GLOBALLABEL_MANDATORY_FIELDS for global labels. Each parent has its own canonical folding domain in the parser.

Definition at line 95 of file template_fieldnames.cpp.

References GetCanonicalFieldName().