juce::NamedValueSet Class Reference

#include <juce_NamedValueSet.h>

Classes
struct	NamedValue

Public Member Functions
	NamedValueSet () noexcept
	NamedValueSet (const NamedValueSet &)
	NamedValueSet (NamedValueSet &&) noexcept
NamedValueSet &	operator= (const NamedValueSet &)
NamedValueSet &	operator= (NamedValueSet &&) noexcept
	NamedValueSet (std::initializer_list< NamedValue >)
	~NamedValueSet () noexcept
bool	operator== (const NamedValueSet &) const noexcept
bool	operator!= (const NamedValueSet &) const noexcept
const NamedValueSet::NamedValue *	begin () const noexcept
const NamedValueSet::NamedValue *	end () const noexcept
int	size () const noexcept
bool	isEmpty () const noexcept
const var &	operator[] (const Identifier &name) const noexcept
var	getWithDefault (const Identifier &name, const var &defaultReturnValue) const
bool	set (const Identifier &name, const var &newValue)
bool	set (const Identifier &name, var &&newValue)
bool	contains (const Identifier &name) const noexcept
bool	remove (const Identifier &name)
Identifier	getName (int index) const noexcept
var *	getVarPointer (const Identifier &name) noexcept
const var *	getVarPointer (const Identifier &name) const noexcept
const var &	getValueAt (int index) const noexcept
var *	getVarPointerAt (int index) noexcept
const var *	getVarPointerAt (int index) const noexcept
int	indexOf (const Identifier &name) const noexcept
void	clear ()
void	setFromXmlAttributes (const XmlElement &xml)
void	copyToXmlAttributes (XmlElement &xml) const

Private Attributes
Array< NamedValue >	values

Detailed Description

Holds a set of named var objects.

This can be used as a basic structure to hold a set of var object, which can be retrieved by using their identifier.

@tags{Core}

Constructor & Destructor Documentation

NamedValueSet() [1/4]

juce::NamedValueSet::NamedValueSet ( )

noexcept

Creates an empty set.

NamedValueSet() [2/4]

juce::NamedValueSet::NamedValueSet

(

const NamedValueSet &

other

)

NamedValueSet() [3/4]

juce::NamedValueSet::NamedValueSet ( NamedValueSet && other )

noexcept

NamedValueSet() [4/4]

juce::NamedValueSet::NamedValueSet

(

std::initializer_list< NamedValue >

list

)

Creates a NamedValueSet from a list of names and properties.

~NamedValueSet()

juce::NamedValueSet::~NamedValueSet ( )

noexcept

Destructor.

Member Function Documentation

begin()

const NamedValueSet::NamedValue * juce::NamedValueSet::begin ( ) const

inlinenoexcept

clear()

void juce::NamedValueSet::clear

(

)

Removes all values.

contains()

bool juce::NamedValueSet::contains ( const Identifier & name ) const

noexcept

Returns true if the set contains an item with the specified name.

copyToXmlAttributes()

void juce::NamedValueSet::copyToXmlAttributes

(

XmlElement &

xml

)

const

Sets attributes in an XML element corresponding to each of this object's properties.

end()

const NamedValueSet::NamedValue * juce::NamedValueSet::end ( ) const

inlinenoexcept

getName()

Identifier juce::NamedValueSet::getName ( int index ) const

noexcept

Returns the name of the value at a given index. The index must be between 0 and size() - 1.

getValueAt()

const var & juce::NamedValueSet::getValueAt ( int index ) const

noexcept

Returns the value of the item at a given index. The index must be between 0 and size() - 1.

getVarPointer() [1/2]

const var * juce::NamedValueSet::getVarPointer ( const Identifier & name ) const

noexcept

Returns a pointer to the var that holds a named value, or null if there is no value with this name.

Do not use this method unless you really need access to the internal var object for some reason - for normal reading and writing always prefer operator[]() and set(). Also note that the pointer returned may become invalid as soon as any subsequent methods are called on the NamedValueSet.

getVarPointer() [2/2]

var * juce::NamedValueSet::getVarPointer ( const Identifier & name )

noexcept

Returns a pointer to the var that holds a named value, or null if there is no value with this name.

Do not use this method unless you really need access to the internal var object for some reason - for normal reading and writing always prefer operator[]() and set(). Also note that the pointer returned may become invalid as soon as any subsequent methods are called on the NamedValueSet.

getVarPointerAt() [1/2]

const var * juce::NamedValueSet::getVarPointerAt ( int index ) const

noexcept

Returns the value of the item at a given index. The index must be between 0 and size() - 1, or this will return a nullptr Also note that the pointer returned may become invalid as soon as any subsequent methods are called on the NamedValueSet.

getVarPointerAt() [2/2]

var * juce::NamedValueSet::getVarPointerAt ( int index )

noexcept

Returns the value of the item at a given index. The index must be between 0 and size() - 1, or this will return a nullptr Also note that the pointer returned may become invalid as soon as any subsequent methods are called on the NamedValueSet.

getWithDefault()

var juce::NamedValueSet::getWithDefault	(	const Identifier &	name,
		const var &	defaultReturnValue ) const

Tries to return the named value, but if no such value is found, this will instead return the supplied default value.

indexOf()

int juce::NamedValueSet::indexOf ( const Identifier & name ) const

noexcept

Returns the index of the given name, or -1 if it's not found.

isEmpty()

bool juce::NamedValueSet::isEmpty ( ) const

noexcept

Returns true if the set is empty.

operator!=()

bool juce::NamedValueSet::operator!= ( const NamedValueSet & other ) const

noexcept

operator=() [1/2]

NamedValueSet & juce::NamedValueSet::operator=

(

const NamedValueSet &

other

)

operator=() [2/2]

NamedValueSet & juce::NamedValueSet::operator= ( NamedValueSet && other )

noexcept

operator==()

bool juce::NamedValueSet::operator== ( const NamedValueSet & other ) const

noexcept

Two NamedValueSets are considered equal if they contain all the same key/value pairs, regardless of the order.

operator[]()

const var & juce::NamedValueSet::operator[] ( const Identifier & name ) const

noexcept

Returns the value of a named item. If the name isn't found, this will return a void variant.

remove()

bool juce::NamedValueSet::remove

(

const Identifier &

name

)

Removes a value from the set.

Returns

true if a value was removed; false if there was no value with the name that was given.

set() [1/2]

bool juce::NamedValueSet::set	(	const Identifier &	name,
		const var &	newValue )

Changes or adds a named value.

Returns

true if a value was changed or added; false if the value was already set the value passed-in.

set() [2/2]

bool juce::NamedValueSet::set	(	const Identifier &	name,
		var &&	newValue )

Changes or adds a named value.

Returns

true if a value was changed or added; false if the value was already set the value passed-in.

setFromXmlAttributes()

void juce::NamedValueSet::setFromXmlAttributes

(

const XmlElement &

xml

)

Sets properties to the values of all of an XML element's attributes.

size()

int juce::NamedValueSet::size ( ) const

noexcept

Returns the total number of values that the set contains.

Member Data Documentation

values

Array<NamedValue> juce::NamedValueSet::values

private

---

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

• /home/runner/work/lmms-fork/lmms-fork/plugins/CarlaBase/carla/source/modules/juce_core/containers/juce_NamedValueSet.h
• /home/runner/work/lmms-fork/lmms-fork/plugins/CarlaBase/carla/source/modules/juce_core/containers/juce_NamedValueSet.cpp