KiCad PCB EDA Suite
Loading...
Searching...
No Matches
lib_id.h
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright (C) 2010-2012 SoftPLC Corporation, Dick Hollenbeck <[email protected]>
5 * Copyright (C) 2012 Wayne Stambaugh <[email protected]>
6 * Copyright (C) 2010-2020 KiCad Developers, see change_log.txt for contributors.
7 *
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * as published by the Free Software Foundation; either version 2
11 * of the License, or (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, you may find one here:
20 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
21 * or you may search the http://www.gnu.org website for the version 2 license,
22 * or you may write to the Free Software Foundation, Inc.,
23 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
24 */
25
26#ifndef _LIB_ID_H_
27#define _LIB_ID_H_
28
29#include <richio.h>
30#include <utf8.h>
31
48class LIB_ID
49{
50public:
51 LIB_ID() {}
52
53 // NOTE: don't define any constructors which call Parse() on their arguments. We want it
54 // to be obvious to callers that parsing is involved (and that valid IDs are guaranteed in
55 // the presence of disallowed characters, malformed ids, etc.).
56
66 LIB_ID( const wxString& aLibraryName, const wxString& aItemName );
67
82 int Parse( const UTF8& aId, bool aFix = false );
83
87 const UTF8& GetLibNickname() const { return m_libraryName; }
88 const wxString GetUniStringLibNickname() const { return m_libraryName.wx_str(); }
89
97 int SetLibNickname( const UTF8& aNickname );
98
102 const UTF8& GetLibItemName() const { return m_itemName; }
103
112 const wxString GetUniStringLibItemName() const { return m_itemName.wx_str(); }
113
121 int SetLibItemName( const UTF8& aLibItemName );
122
131 void SetSubLibraryName( const UTF8& aName ) { m_subLibraryName = aName; }
132 const wxString GetUniStringSubLibraryName() const { return m_subLibraryName.wx_str(); }
133
137 const wxString GetFullLibraryName() const;
138
142 UTF8 Format() const;
143
148 wxString GetUniStringLibId() const
149 {
150 return Format().wx_str();
151 }
152
159 static UTF8 Format( const UTF8& aLibraryName, const UTF8& aLibItemName );
160
172 bool IsValid() const
173 {
174 return !m_libraryName.empty() && !m_itemName.empty();
175 }
176
180 bool IsLegacy() const
181 {
182 return m_libraryName.empty() && !m_itemName.empty();
183 }
184
188 void clear();
189
193 bool empty() const
194 {
195 return m_libraryName.empty() && m_itemName.empty();
196 }
197
205 int compare( const LIB_ID& aLibId ) const;
206
207 bool operator < ( const LIB_ID& aLibId ) const { return this->compare( aLibId ) < 0; }
208 bool operator > ( const LIB_ID& aLibId ) const { return this->compare( aLibId ) > 0; }
209 bool operator ==( const LIB_ID& aLibId ) const { return this->compare( aLibId ) == 0; }
210 bool operator !=( const LIB_ID& aLibId ) const { return !(*this == aLibId); }
211
218 static int HasIllegalChars( const UTF8& aLibItemName );
219
227 static UTF8 FixIllegalChars( const UTF8& aLibItemName, bool aLib );
228
235 static unsigned FindIllegalLibraryNameChar( const UTF8& aLibraryName );
236
237protected:
261 static bool isLegalChar( unsigned aUniChar );
262
269 static bool isLegalLibraryNameChar( unsigned aUniChar );
270
274};
275
276
277#endif // _LIB_ID_H_
A logical library item identifier and consists of various portions much like a URI.
Definition: lib_id.h:49
int Parse(const UTF8 &aId, bool aFix=false)
Parse LIB_ID with the information from aId.
Definition: lib_id.cpp:50
bool operator==(const LIB_ID &aLibId) const
Definition: lib_id.h:209
int SetLibItemName(const UTF8 &aLibItemName)
Override the library item name portion of the LIB_ID to aLibItemName.
Definition: lib_id.cpp:109
bool operator!=(const LIB_ID &aLibId) const
Definition: lib_id.h:210
LIB_ID()
Definition: lib_id.h:51
bool IsValid() const
Check if this LID_ID is valid.
Definition: lib_id.h:172
static int HasIllegalChars(const UTF8 &aLibItemName)
Examine aLibItemName for invalid LIB_ID item name characters.
Definition: lib_id.cpp:174
int compare(const LIB_ID &aLibId) const
Compare the contents of LIB_ID objects by performing a std::string comparison of the library nickname...
Definition: lib_id.cpp:159
bool empty() const
Definition: lib_id.h:193
static bool isLegalChar(unsigned aUniChar)
Tests whether a Unicode character is a legal LIB_ID item name character.
Definition: lib_id.cpp:207
bool operator<(const LIB_ID &aLibId) const
Definition: lib_id.h:207
wxString GetUniStringLibId() const
Definition: lib_id.h:148
static unsigned FindIllegalLibraryNameChar(const UTF8 &aLibraryName)
Looks for characters that are illegal in library nicknames.
Definition: lib_id.cpp:242
UTF8 Format() const
Definition: lib_id.cpp:117
const wxString GetUniStringSubLibraryName() const
Definition: lib_id.h:132
UTF8 m_libraryName
The nickname of the library or empty.
Definition: lib_id.h:271
void SetSubLibraryName(const UTF8 &aName)
Definition: lib_id.h:131
const wxString GetUniStringLibItemName() const
Get strings for display messages in dialogs.
Definition: lib_id.h:112
int SetLibNickname(const UTF8 &aNickname)
Override the logical library name portion of the LIB_ID to aNickname.
Definition: lib_id.cpp:98
const wxString GetUniStringLibNickname() const
Definition: lib_id.h:88
const UTF8 & GetLibItemName() const
Definition: lib_id.h:102
bool operator>(const LIB_ID &aLibId) const
Definition: lib_id.h:208
bool IsLegacy() const
Definition: lib_id.h:180
UTF8 GetSubLibraryName() const
Some LIB_IDs can have a sub-library identifier in addition to a library nickname.
Definition: lib_id.h:130
const UTF8 & GetLibNickname() const
Return the logical library name portion of a LIB_ID.
Definition: lib_id.h:87
static UTF8 FixIllegalChars(const UTF8 &aLibItemName, bool aLib)
Replace illegal LIB_ID item name characters with underscores '_'.
Definition: lib_id.cpp:190
UTF8 m_itemName
The name of the entry in the logical library.
Definition: lib_id.h:272
void clear()
Clear the contents of the library nickname, library entry name.
Definition: lib_id.cpp:42
const wxString GetFullLibraryName() const
Definition: lib_id.cpp:276
UTF8 m_subLibraryName
Optional sub-library name used for grouping within a library.
Definition: lib_id.h:273
static bool isLegalLibraryNameChar(unsigned aUniChar)
Tests whether a Unicode character is a legal LIB_ID library nickname character.
Definition: lib_id.cpp:254
An 8 bit string that is assuredly encoded in UTF8, and supplies special conversion support to and fro...
Definition: utf8.h:71
bool empty() const
Definition: utf8.h:103
wxString wx_str() const
Definition: utf8.cpp:46