The SerializableObjectList class implements a list of librepcb::SerializableObject. More...

#include <serializableobjectlist.h>

Inheritance diagram for SerializableObjectList< T, P, OnEditedArgs >:

Collaboration diagram for SerializableObjectList< T, P, OnEditedArgs >:

Classes
class	Iterator

Public Types
enum	Event

using	iterator = Iterator< typename QVector< std::shared_ptr< T > >::iterator, T >

using	const_iterator = Iterator< typename QVector< std::shared_ptr< T > >::const_iterator, const T >

typedef Slot< SerializableObjectList< T, P, OnEditedArgs... >, int, const std::shared_ptr< const T > &, Event >	OnEditedSlot

typedef Slot< SerializableObjectList< T, P, OnEditedArgs... >, int, const std::shared_ptr< const T > &, OnEditedArgs... >	OnElementEditedSlot

Public Member Functions
	SerializableObjectList () noexcept

	SerializableObjectList (const SerializableObjectList< T, P, OnEditedArgs... > &other) noexcept

	SerializableObjectList (SerializableObjectList< T, P, OnEditedArgs... > &&other) noexcept

	SerializableObjectList (std::initializer_list< std::shared_ptr< T >> elements) noexcept

	SerializableObjectList (const SExpression &node, const Version &fileFormat)

virtual	~SerializableObjectList () noexcept

bool	isEmpty () const noexcept

int	count () const noexcept

std::vector< Uuid >	getUuids () const noexcept

QSet< Uuid >	getUuidSet () const noexcept

int	indexOf (const T *obj) const noexcept

int	indexOf (const Uuid &key) const noexcept

int	indexOf (const QString &name) const noexcept

bool	contains (int index) const noexcept

bool	contains (const T *obj) const noexcept

bool	contains (const Uuid &key) const noexcept

bool	contains (const QString &name) const noexcept

std::shared_ptr< T >	value (int index) noexcept

std::shared_ptr< const T >	value (int index) const noexcept

std::shared_ptr< T >	find (const T *obj) noexcept

std::shared_ptr< T >	find (const Uuid &key) noexcept

std::shared_ptr< const T >	find (const Uuid &key) const noexcept

std::shared_ptr< T >	find (const QString &name) noexcept

std::shared_ptr< const T >	find (const QString &name) const noexcept

std::shared_ptr< const T >	at (int index) const noexcept

std::shared_ptr< T > &	first () noexcept

std::shared_ptr< const T >	first () const noexcept

std::shared_ptr< T > &	last () noexcept

std::shared_ptr< const T >	last () const noexcept

std::shared_ptr< T >	get (const T *obj)

std::shared_ptr< T >	get (const Uuid &key)

std::shared_ptr< const T >	get (const Uuid &key) const

std::shared_ptr< T >	get (const QString &name)

std::shared_ptr< const T >	get (const QString &name) const

const_iterator	begin () const noexcept

const_iterator	end () const noexcept

const_iterator	cbegin () noexcept

const_iterator	cend () noexcept

iterator	begin () noexcept

iterator	end () noexcept

int	loadFromSExpression (const SExpression &node, const Version &fileFormat)

void	swap (int i, int j) noexcept

int	insert (int index, const std::shared_ptr< T > &obj) noexcept

int	append (const std::shared_ptr< T > &obj) noexcept

std::shared_ptr< T >	take (int index) noexcept

std::shared_ptr< T >	take (const T *obj) noexcept

std::shared_ptr< T >	take (const Uuid &uuid) noexcept

std::shared_ptr< T >	take (const QString &name) noexcept

void	remove (int index) noexcept

void	remove (const T *obj) noexcept

void	remove (const Uuid &uuid) noexcept

void	remove (const QString &name) noexcept

void	clear () noexcept

void	serialize (SExpression &root) const override
	Serialize the object into an existing S-Expression node. More...

SerializableObjectList< T, P, OnEditedArgs... >	sortedByUuid () const noexcept

SerializableObjectList< T, P, OnEditedArgs... >	sortedByName () const noexcept

std::shared_ptr< T >	operator[] (int i) noexcept

std::shared_ptr< const T >	operator[] (int i) const noexcept

bool	operator== (const SerializableObjectList< T, P, OnEditedArgs... > &rhs) const noexcept

bool	operator!= (const SerializableObjectList< T, P, OnEditedArgs... > &rhs) const noexcept

SerializableObjectList< T, P, OnEditedArgs... > &	operator= (const SerializableObjectList< T, P, OnEditedArgs... > &rhs) noexcept

SerializableObjectList< T, P, OnEditedArgs... > &	operator= (SerializableObjectList< T, P, OnEditedArgs... > &&rhs) noexcept

Public Member Functions inherited from SerializableObject
	SerializableObject () noexcept

virtual	~SerializableObject () noexcept

SExpression	serializeToDomElement (const QString &name) const
	Serialize the object to a new S-Expression node. More...

Public Attributes
Signal< SerializableObjectList< T, P, OnEditedArgs... >, int, const std::shared_ptr< const T > &, Event >	onEdited

Signal< SerializableObjectList< T, P, OnEditedArgs... >, int, const std::shared_ptr< const T > &, OnEditedArgs... >	onElementEdited

Protected Member Functions
void	insertElement (int index, const std::shared_ptr< T > &obj) noexcept

std::shared_ptr< T >	takeElement (int index) noexcept

void	elementEditedHandler (const T &obj, OnEditedArgs... args) noexcept

void	throwKeyNotFoundException (const Uuid &key) const

void	throwNameNotFoundException (const QString &name) const

Protected Attributes
QVector< std::shared_ptr< T > >	mObjects

Slot< T, OnEditedArgs... >	mOnEditedSlot

Additional Inherited Members
Static Public Member Functions inherited from SerializableObject
template<typename T >
static void	serializeObjectContainer (SExpression &root, const T &container, const QString &itemName)

template<typename T >
static void	serializePointerContainer (SExpression &root, const T &container, const QString &itemName)

template<typename T >
static void	serializePointerContainerUuidSorted (SExpression &root, const T &container, const QString &itemName)

Detailed Description

template<typename T, typename P, typename... OnEditedArgs>
class librepcb::SerializableObjectList< T, P, OnEditedArgs >

The SerializableObjectList class implements a list of librepcb::SerializableObject.

This template class lets you hold a list of serializable objects and provides some useful features:

The method loadFromSExpression() to deserialize from a librepcb::SExpression.
The method serialize() to serialize the whole list into a librepcb::SExpression.
Iterators (for example to use in C++11 range based for loops).
Methods to find elements by UUID and/or name (if supported by template type T).
Method sortedByUuid() to create a copy of the list with elements sorted by UUID.
Signals to get notified about added, removed and modified elements.
Undo commands librepcb::CmdListElementInsert, librepcb::CmdListElementRemove and ibrepcb::CmdListElementsSwap.
Const correctness: A const list always returns pointers/references to const elements.

Template Parameters

T

The type of the list items. The type must provide following functionality:

Optional: A nothrow copy constructor (to make the list copyable)
Optional: A constructor with one parameter of type const SExpression&
Optional: A method serialize() according to librepcb::SerializableObject
Optional: Comparison operator overloadings
Optional: A method Uuid getUuid() const noexcept
Optional: A method QString getName() const noexcept

P A class which provides the S-Expression node tag name of the list items. Example: struct MyNameProvider {static constexpr const char* tagname = "item";};

Note: Instead of directly storing elements of type T, elements are always wrapped into a std::shared_ptr<T> before adding them to the list. This is done to ensure that elements never have to be copied or moved for adding or removing them to/from the list. Otherwise it would not be possible to use this list in undo commands as references/pointers to elements would become invalid. Using pointers ensures that the objects are located at the same address over the whole lifetime. To still minimize the risk of memory leaks, std::shared_ptr is used instead of raw pointers.

Warning: Using Qt's foreach keyword on a librepcb::SerializableObjectList is not recommended because it always creates a deep copy of the list! You should use range based for loops (since C++11) instead.

Member Typedef Documentation

◆ iterator

using iterator = Iterator<typename QVector<std::shared_ptr<T> >::iterator, T>

◆ const_iterator

using const_iterator = Iterator<typename QVector<std::shared_ptr<T> >::const_iterator, const T>

◆ OnEditedSlot

typedef Slot<SerializableObjectList<T, P, OnEditedArgs...>, int, const std::shared_ptr<const T>&, Event> OnEditedSlot

◆ OnElementEditedSlot

typedef Slot<SerializableObjectList<T, P, OnEditedArgs...>, int, const std::shared_ptr<const T>&, OnEditedArgs...> OnElementEditedSlot

Member Enumeration Documentation

◆ Event

enum Event

strong

Enumerator
ElementAdded
ElementRemoved
ElementEdited

Constructor & Destructor Documentation

◆ SerializableObjectList() [1/5]

SerializableObjectList ( )

inlinenoexcept

◆ SerializableObjectList() [2/5]

SerializableObjectList ( const SerializableObjectList< T, P, OnEditedArgs... > & other )

inlinenoexcept

◆ SerializableObjectList() [3/5]

SerializableObjectList ( SerializableObjectList< T, P, OnEditedArgs... > && other )

inlinenoexcept

◆ SerializableObjectList() [4/5]

SerializableObjectList ( std::initializer_list< std::shared_ptr< T >> elements )

inlinenoexcept

◆ SerializableObjectList() [5/5]

SerializableObjectList	(	const SExpression &	node,
		const Version &	fileFormat
	)

inlineexplicit

◆ ~SerializableObjectList()

virtual ~SerializableObjectList ( )

inlinevirtualnoexcept

Member Function Documentation

◆ isEmpty()

bool isEmpty ( ) const

inlinenoexcept

Here is the caller graph for this function:

◆ count()

int count ( ) const

inlinenoexcept

Here is the caller graph for this function:

◆ getUuids()

std::vector<Uuid> getUuids ( ) const

inlinenoexcept

◆ getUuidSet()

QSet<Uuid> getUuidSet ( ) const

inlinenoexcept

Here is the caller graph for this function:

◆ indexOf() [1/3]

int indexOf ( const T * obj ) const

inlinenoexcept

Here is the caller graph for this function:

◆ indexOf() [2/3]

int indexOf ( const Uuid & key ) const

inlinenoexcept

◆ indexOf() [3/3]

int indexOf ( const QString & name ) const

inlinenoexcept

◆ contains() [1/4]

bool contains ( int index ) const

inlinenoexcept

Here is the caller graph for this function:

◆ contains() [2/4]

bool contains ( const T * obj ) const

inlinenoexcept

◆ contains() [3/4]

bool contains ( const Uuid & key ) const

inlinenoexcept

◆ contains() [4/4]

bool contains ( const QString & name ) const

inlinenoexcept

◆ value() [1/2]

std::shared_ptr<T> value ( int index )

inlinenoexcept

Here is the caller graph for this function:

◆ value() [2/2]

std::shared_ptr<const T> value ( int index ) const

inlinenoexcept

◆ find() [1/5]

std::shared_ptr<T> find ( const T * obj )

inlinenoexcept

Here is the caller graph for this function:

◆ find() [2/5]

std::shared_ptr<T> find ( const Uuid & key )

inlinenoexcept

◆ find() [3/5]

std::shared_ptr<const T> find ( const Uuid & key ) const

inlinenoexcept

◆ find() [4/5]

std::shared_ptr<T> find ( const QString & name )

inlinenoexcept

◆ find() [5/5]

std::shared_ptr<const T> find ( const QString & name ) const

inlinenoexcept

◆ at()

std::shared_ptr<const T> at ( int index ) const

inlinenoexcept

Here is the caller graph for this function:

◆ first() [1/2]

std::shared_ptr<T>& first ( )

inlinenoexcept

Here is the caller graph for this function:

◆ first() [2/2]

std::shared_ptr<const T> first ( ) const

inlinenoexcept

◆ last() [1/2]

std::shared_ptr<T>& last ( )

inlinenoexcept

◆ last() [2/2]

std::shared_ptr<const T> last ( ) const

inlinenoexcept

◆ get() [1/5]

std::shared_ptr<T> get ( const T * obj )

inline

Here is the caller graph for this function:

◆ get() [2/5]

std::shared_ptr<T> get ( const Uuid & key )

inline

◆ get() [3/5]

std::shared_ptr<const T> get ( const Uuid & key ) const

inline

◆ get() [4/5]

std::shared_ptr<T> get ( const QString & name )

inline

◆ get() [5/5]

std::shared_ptr<const T> get ( const QString & name ) const

inline

◆ begin() [1/2]

const_iterator begin ( ) const

inlinenoexcept

Here is the caller graph for this function:

◆ end() [1/2]

const_iterator end ( ) const

inlinenoexcept

Here is the caller graph for this function:

◆ cbegin()

const_iterator cbegin ( )

inlinenoexcept

◆ cend()

const_iterator cend ( )

inlinenoexcept

◆ begin() [2/2]

iterator begin ( )

inlinenoexcept

◆ end() [2/2]

iterator end ( )

inlinenoexcept

◆ loadFromSExpression()

int loadFromSExpression	(	const SExpression &	node,
		const Version &	fileFormat
	)

inline

Here is the caller graph for this function:

◆ swap()

void swap	(	int	i,
		int	j
	)

inlinenoexcept

Here is the caller graph for this function:

◆ insert()

int insert	(	int	index,
		const std::shared_ptr< T > &	obj
	)

inlinenoexcept

Here is the caller graph for this function:

◆ append()

int append ( const std::shared_ptr< T > & obj )

inlinenoexcept

Here is the caller graph for this function:

◆ take() [1/4]

std::shared_ptr<T> take ( int index )

inlinenoexcept

Here is the caller graph for this function:

◆ take() [2/4]

std::shared_ptr<T> take ( const T * obj )

inlinenoexcept

Here is the caller graph for this function:

◆ take() [3/4]

std::shared_ptr<T> take ( const Uuid & uuid )

inlinenoexcept

◆ take() [4/4]

std::shared_ptr<T> take ( const QString & name )

inlinenoexcept

◆ remove() [1/4]

void remove ( int index )

inlinenoexcept

Here is the caller graph for this function:

◆ remove() [2/4]

void remove ( const T * obj )

inlinenoexcept

◆ remove() [3/4]

void remove ( const Uuid & uuid )

inlinenoexcept

◆ remove() [4/4]

void remove ( const QString & name )

inlinenoexcept

◆ clear()

void clear ( )

inlinenoexcept

Here is the caller graph for this function:

◆ serialize()

void serialize ( SExpression & root ) const

inlineoverridevirtual

Serialize the object into an existing S-Expression node.

This method inserts/appends all attributes and childs of the object to an existing S-Expression node. The content which already exists in the given S-Expression node will not be removed.

Note: The generated S-Expression node has always the format of the application's major version (it's not possible to generate DOMs of older versions).

Parameters

root	The target DOM root node

Exceptions

Exception This method throws an exception if an error occurs.

Implements SerializableObject.

Here is the caller graph for this function:

◆ sortedByUuid()

SerializableObjectList<T, P, OnEditedArgs...> sortedByUuid ( ) const

inlinenoexcept

Here is the caller graph for this function:

◆ sortedByName()

SerializableObjectList<T, P, OnEditedArgs...> sortedByName ( ) const

inlinenoexcept

◆ operator[]() [1/2]

std::shared_ptr<T> operator[] ( int i )

inlinenoexcept

◆ operator[]() [2/2]

std::shared_ptr<const T> operator[] ( int i ) const

inlinenoexcept

◆ operator==()

bool operator== ( const SerializableObjectList< T, P, OnEditedArgs... > & rhs ) const

inlinenoexcept

◆ operator!=()

bool operator!= ( const SerializableObjectList< T, P, OnEditedArgs... > & rhs ) const

inlinenoexcept

◆ operator=() [1/2]

SerializableObjectList<T, P, OnEditedArgs...>& operator= ( const SerializableObjectList< T, P, OnEditedArgs... > & rhs )

inlinenoexcept

◆ operator=() [2/2]

SerializableObjectList<T, P, OnEditedArgs...>& operator= ( SerializableObjectList< T, P, OnEditedArgs... > && rhs )

inlinenoexcept

◆ insertElement()

void insertElement	(	int	index,
		const std::shared_ptr< T > &	obj
	)

inlineprotectednoexcept

Here is the caller graph for this function:

◆ takeElement()

std::shared_ptr<T> takeElement ( int index )

inlineprotectednoexcept

Here is the caller graph for this function:

◆ elementEditedHandler()

void elementEditedHandler	(	const T &	obj,
		OnEditedArgs...	args
	)

inlineprotectednoexcept

◆ throwKeyNotFoundException()

void throwKeyNotFoundException ( const Uuid & key ) const

inlineprotected

Here is the caller graph for this function:

◆ throwNameNotFoundException()

void throwNameNotFoundException ( const QString & name ) const

inlineprotected

Here is the caller graph for this function:

Member Data Documentation

◆ onEdited

Signal<SerializableObjectList<T, P, OnEditedArgs...>, int, const std::shared_ptr<const T>&, Event> onEdited

◆ onElementEdited

Signal<SerializableObjectList<T, P, OnEditedArgs...>, int, const std::shared_ptr<const T>&, OnEditedArgs...> onElementEdited

◆ mObjects

QVector<std::shared_ptr<T> > mObjects

protected

◆ mOnEditedSlot

Slot<T, OnEditedArgs...> mOnEditedSlot

protected

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

/__w/1/s/libs/librepcb/common/fileio/serializableobjectlist.h

Classes

Public Types

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

template<typename T, typename P, typename... OnEditedArgs> class librepcb::SerializableObjectList< T, P, OnEditedArgs >

Member Typedef Documentation

◆ iterator

◆ const_iterator

◆ OnEditedSlot

◆ OnElementEditedSlot

Member Enumeration Documentation

◆ Event

Constructor & Destructor Documentation

◆ SerializableObjectList() [1/5]

◆ SerializableObjectList() [2/5]

◆ SerializableObjectList() [3/5]

◆ SerializableObjectList() [4/5]

◆ SerializableObjectList() [5/5]

◆ ~SerializableObjectList()

Member Function Documentation

◆ isEmpty()

◆ count()

◆ getUuids()

◆ getUuidSet()

◆ indexOf() [1/3]

◆ indexOf() [2/3]

◆ indexOf() [3/3]

◆ contains() [1/4]

◆ contains() [2/4]

◆ contains() [3/4]

◆ contains() [4/4]

◆ value() [1/2]

◆ value() [2/2]

◆ find() [1/5]

◆ find() [2/5]

◆ find() [3/5]

◆ find() [4/5]

◆ find() [5/5]

◆ at()

◆ first() [1/2]

◆ first() [2/2]

◆ last() [1/2]

◆ last() [2/2]

◆ get() [1/5]

◆ get() [2/5]

◆ get() [3/5]

◆ get() [4/5]

◆ get() [5/5]

◆ begin() [1/2]

◆ end() [1/2]

◆ cbegin()

◆ cend()

◆ begin() [2/2]

◆ end() [2/2]

◆ loadFromSExpression()

◆ swap()

◆ insert()

◆ append()

◆ take() [1/4]

◆ take() [2/4]

◆ take() [3/4]

◆ take() [4/4]

◆ remove() [1/4]

◆ remove() [2/4]

◆ remove() [3/4]

◆ remove() [4/4]

◆ clear()

◆ serialize()

◆ sortedByUuid()

◆ sortedByName()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ operator==()

◆ operator!=()

◆ operator=() [1/2]

◆ operator=() [2/2]

template<typename T, typename P, typename... OnEditedArgs>
class librepcb::SerializableObjectList< T, P, OnEditedArgs >