StormByte::Config::Item::List Class Reference

Unnamed-item container [ … ]. More...

#include <list.hxx>

Inheritance diagram for StormByte::Config::Item::List:

Collaboration diagram for StormByte::Config::Item::List:

Public Member Functions
Construction
	List ()=default
	Constructs an empty List.
	List (const std::string &name)
	Constructs a List with the given name.
	List (std::string &&name)
	Constructs a List with the given name (move).
	List (const List &list)=default
	Copy constructor.
	List (List &&list) noexcept=default
	Move constructor.
List &	operator= (const List &list)=default
	Copy assignment operator.
List &	operator= (List &&list) noexcept=default
	Move assignment operator.
	~List () noexcept override=default
	Destructor.
Access
PointerType	Clone () const override
	Clones the list.
PointerType	Move () override
	Moves the list.
constexpr Item::ContainerType	ContainerType () const noexcept override
	Gets the container type.
Public Member Functions inherited from StormByte::Config::Item::Container
	Container ()=default
	Constructs an empty Container.
	Container (const std::string &name)
	Constructs a Container with the given name.
	Container (std::string &&name)
	Constructs a Container with the given name (move).
	Container (const Container &base)=default
	Copy constructor.
	Container (Container &&base) noexcept=default
	Move constructor.
Container &	operator= (const Container &base)=default
	Copy assignment operator.
Container &	operator= (Container &&base) noexcept=default
	Move assignment operator.
virtual	~Container () noexcept override=default
	Destructor.
Base &	Add (const Base &item, const StormByte::Config::OnExistingAction &on_existing)
	Adds an item (const reference) using an explicit policy.
Base &	Add (Base &&item, const StormByte::Config::OnExistingAction &on_existing)
	Adds an item (rvalue) using an explicit policy.
Base &	Add (const Base &item)
	Adds an item using the container's current OnExistingAction policy.
Base &	Add (Base &&item)
	Adds an item using the container's current OnExistingAction policy (move).
Base &	Add (Base::PointerType item, const StormByte::Config::OnExistingAction &on_existing)
	Adds an item to the container.
void	Clear () noexcept
	Clears all items from the container.
bool	Exists (const std::string &path) const
	Checks if an item exists by path.
void	Remove (const size_t &index)
	Removes an item by index.
void	Remove (const std::string &path)
	Removes an item by path.
constexpr std::span< Base::PointerType >	Items () noexcept
	Returns a span of all items in the container.
constexpr std::span< const Base::PointerType >	Items () const noexcept
	Returns a const span of all items in the container.
constexpr size_t	Size () const noexcept
	Gets the number of items in the current level.
size_t	Count () const noexcept
	Gets the total number of items including nested ones.
void	SetOnExistingAction (StormByte::Config::OnExistingAction action) noexcept
	Sets the action to take when an item with the same identity already exists.
StormByte::Config::OnExistingAction	GetOnExistingAction () const noexcept
	Gets the current OnExistingAction policy.
bool	Equals (const Base &other) const noexcept override
	Polymorphic equality comparison.
Base &	operator[] (const size_t &index)
	Gets a reference to an item by index.
const Base &	operator[] (const size_t &index) const
	Gets a const reference to an item by index.
Base &	operator[] (const std::string &path)
	Gets a reference to an item by path.
const Base &	operator[] (const std::string &path) const
	Gets a const reference to an item by path.
bool	operator== (const Container &container) const noexcept
	Equality operator.
bool	operator!= (const Container &container) const noexcept
	Inequality operator.
std::string	Serialize (const int &indent_level) const noexcept override
	Serializes the container to a string.
constexpr std::string	ContainerTypeToString () const noexcept
	Gets the container type as string.
constexpr Item::Type	Type () const noexcept override
	Gets the item type.
Public Member Functions inherited from StormByte::Config::Item::Base
	Base ()=default
	Default constructor.
	Base (const std::string &name)
	Constructs a Base item with a name.
	Base (const Base &base)=default
	Copy constructor.
	Base (Base &&base) noexcept=default
	Move constructor.
Base &	operator= (const Base &base)=default
	Copy assignment operator.
Base &	operator= (Base &&base) noexcept=default
	Move assignment operator.
virtual	~Base () noexcept=default
	Destructor.
bool	operator== (const Base &other) const noexcept
	Equality operator.
bool	operator!= (const Base &other) const noexcept
	Inequality operator.
constexpr const std::optional< std::string > &	Name () const noexcept
	Gets the name of the item.
constexpr void	Name (const std::string &name) noexcept
	Sets the item name.
bool	IsNameValid () const noexcept
	Checks if the current name is valid.
virtual std::optional< CommentType >	GetCommentType () const noexcept
	Returns the comment type if this item is a Comment, otherwise std::nullopt.
constexpr std::string	TypeToString () const noexcept
	Gets the item type as a string.
	operator std::string () const
	Converts the item to a string.
template<typename T >
const T &	Value () const
	Gets the item value (const).
template<typename T >
T &	Value ()
	Gets the item value (mutable).

Additional Inherited Members
Static Public Member Functions inherited from StormByte::Config::Item::Container
static constexpr std::pair< const char, const char >	EnclosureCharacters (const ContainerType &type) noexcept
	Returns the enclosure characters for a given container type.
static constexpr const char	EndCharacter (const ContainerType &type) noexcept
	Returns the closing character for a given container type.
Protected Attributes inherited from StormByte::Config::Item::Container
std::vector< Base::PointerType >	m_items
	Items stored in the container.
StormByte::Config::OnExistingAction	m_on_existing_action = StormByte::Config::OnExistingAction::ThrowException
	Collision policy.
Protected Attributes inherited from StormByte::Config::Item::Base
std::optional< std::string >	m_name
	Item name.

Detailed Description

Unnamed-item container [ … ].

include_dirs = [
    "/usr/include"
    "/usr/local/include"
]

Constructor & Destructor Documentation

List() [1/4]

StormByte::Config::Item::List::List

(

const std::string &

name

)

Constructs a List with the given name.

Parameters

name	The name of the list.

List() [2/4]

StormByte::Config::Item::List::List

(

std::string &&

name

)

Constructs a List with the given name (move).

Parameters

name	The name of the list.

List() [3/4]

StormByte::Config::Item::List::List ( const List &  list )

default

Copy constructor.

Parameters

list	List to copy.

List() [4/4]

StormByte::Config::Item::List::List ( List &&  list )

defaultnoexcept

Move constructor.

Parameters

list	List to move.

Member Function Documentation

Clone()

PointerType StormByte::Config::Item::List::Clone ( ) const

inlineoverride

Clones the list.

Returns

Cloned list.

ContainerType()

constexpr Item::ContainerType StormByte::Config::Item::List::ContainerType ( ) const

inlineconstexproverridevirtualnoexcept

Gets the container type.

Returns

Container type.

Implements StormByte::Config::Item::Container.

Move()

PointerType StormByte::Config::Item::List::Move ( )

inlineoverride

Moves the list.

Returns

Moved list.

operator=() [1/2]

List & StormByte::Config::Item::List::operator= ( const List &  list )

default

Copy assignment operator.

Parameters

list	List to assign.

Returns

Reference to this List.

operator=() [2/2]

List & StormByte::Config::Item::List::operator= ( List &&  list )

defaultnoexcept

Move assignment operator.

Parameters

list	List to move.

Returns

Reference to this List.

---

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

• /home/runner/work/StormByte-Config/StormByte-Config/lib/public/StormByte/config/item/list.hxx