dx::coreaudio::server::_preference Class Reference

persistant CoreAudio storarage base class - do not use directly! use coreaudio::server::preference More...

#include <dx_coreaudio_server.h>

Inheritance diagram for dx::coreaudio::server::_preference:

Collaboration diagram for dx::coreaudio::server::_preference:

Public Member Functions
	catch (...)
	dx_catchall_rethrow () template< typename self_t > static void assign_property(const self_t &self

Static Public Member Functions
static self_t void	assign (const self_t &self, const value_t &value) try
static self_t container_t	children (const self_t &self) try
static self_t bool	fetch (const self_t &self, value_t &value) try
static bool	nested (const self_t &self) try
static ::CFPropertyListRef	property_list (const self_t &self) try

Public Attributes
::CFPropertyListRef value	try

Protected Member Functions
::CFIndex	count () const noexcept
	dx_catchall_rethrow () const reference &retain() const noexcept
	dx_catchall_rethrow () reference &operator
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
CFTypeID	id () noexcept
reference &	initialize (::CFPropertyListRef cf_object, bool retain=true) try
	operator::CFPropertyListRef () const noexcept
	operator::CFPropertyListRef () const noexcept
	operator::CFTypeID () const noexcept
reference &	release () noexcept

Static Protected Member Functions
::CFTypeID	id () noexcept

Protected Attributes
::CFPropertyListRef	cf_object

Friends
class	cf::tree< _preference >

Detailed Description

persistant CoreAudio storarage base class - do not use directly! use coreaudio::server::preference

Due to CoreAudio persistant storage limitations this class does not support root key retrieval and excepts on such attempts, including checking for root container.

The value is cached @ the underlaying cf::reference<::CFPropertyListRef>.

Implements cf::tree's 10 position-only primitives (cf_tree.h) over AudioServerPlugInHostInterface's CopyFromStorage/WriteToStorage/ DeleteFromStorage - operating on this key alone, never the parent chain. cf::tree supplies the dx::key_value_tree<preference> contract (fetch/ assign/purge/nested) on top, by recursing through those primitives up to the true root. get()'s own dx_pass(host && key...) is what actually enforces this class' no-root-key limitation: property_list() (cf tree.h) reaches it only through operator bool()/operator ::CFPropertyListRef() below, so an empty key still excepts there instead of silently falling back to nullptr the way cf::_preference's root case does.

Member Function Documentation

assign()

self_t void cf::tree< _preference >::assign ( const self_t & self, const value_t & value )

inlinestaticinherited

catch()

cf::tree< _preference >::catch ( ... )

inlineinherited

children()

self_t container_t cf::tree< _preference >::children ( const self_t & self )

inlinestaticinherited

count()

::CFIndex cf::reference< ::CFPropertyListRef >::count ( ) const

inlinenoexceptinherited

dx_catchall_rethrow() [1/3]

cf::reference< ::CFPropertyListRef >::dx_catchall_rethrow ( ) const &

inlinenoexceptinherited

dx_catchall_rethrow() [2/3]

cf::reference< ::CFPropertyListRef >::dx_catchall_rethrow ( ) &

inherited

Here is the call graph for this function:

dx_catchall_rethrow() [3/3]

cf::tree< _preference >::dx_catchall_rethrow ( ) const &

inherited

downward write-back mirroring property_list()'s upward read, creating ancestor dictionaries as needed.

fetch()

self_t bool cf::tree< _preference >::fetch ( const self_t & self, value_t & value )

inlinestaticinherited

id() [1/23]

CFTypeID cf::reference<::CFMutableArrayRef >::id ( )

inlinenoexceptinherited

id() [2/23]

CFTypeID cf::reference<::CFArrayRef >::id ( )

inlinenoexceptinherited

id() [3/23]

CFTypeID cf::reference<::CFBundleRef >::id ( )

inlinenoexceptinherited

id() [4/23]

CFTypeID cf::reference<::CFDataRef >::id ( )

inlinenoexceptinherited

id() [5/23]

CFTypeID cf::reference<::CFMutableDictionaryRef >::id ( )

inlinenoexceptinherited

Here is the call graph for this function:

id() [6/23]

CFTypeID cf::reference<::CFDictionaryRef >::id ( )

inlinenoexceptinherited

Here is the call graph for this function:

id() [7/23]

CFTypeID cf::reference<::CFErrorRef >::id ( )

inlinenoexceptinherited

id() [8/23]

CFTypeID cf::reference<::CFBooleanRef >::id ( )

inlinenoexceptinherited

Here is the call graph for this function:

id() [9/23]

CFTypeID cf::reference<::CFNumberRef >::id ( )

inlinenoexceptinherited

Here is the call graph for this function:

id() [10/23]

::CFTypeID cf::reference< ::CFPropertyListRef >::id ( )

staticnoexceptinherited

id() [11/23]

CFTypeID cf::reference<::CFRunLoopObserverRef >::id ( )

inlinenoexceptinherited

id() [12/23]

CFTypeID cf::reference<::CFRunLoopSourceRef >::id ( )

inlinenoexceptinherited

id() [13/23]

CFTypeID cf::reference<::CFRunLoopRef >::id ( )

inlinenoexceptinherited

id() [14/23]

CFTypeID cf::reference<::CFReadStreamRef >::id ( )

inlinenoexceptinherited

id() [15/23]

CFTypeID cf::reference<::CFMutableStringRef >::id ( )

inlinenoexceptinherited

id() [16/23]

CFTypeID cf::reference<::CFStringRef >::id ( )

inlinenoexceptinherited

id() [17/23]

CFTypeID cf::reference<::CFURLRef >::id ( )

inlinenoexceptinherited

id() [18/23]

CFTypeID cf::reference<::CFUUIDRef >::id ( )

inlinenoexceptinherited

id() [19/23]

CFTypeID cf::reference<::SCPreferencesRef >::id ( )

inlinenoexceptinherited

id() [20/23]

CFTypeID cf::reference<::SecTrustRef >::id ( )

inlinenoexceptinherited

id() [21/23]

CFTypeID cf::reference<::SecCertificateRef >::id ( )

inlinenoexceptinherited

id() [22/23]

CFTypeID cf::reference<::SecStaticCodeRef >::id ( )

inlinenoexceptinherited

id() [23/23]

CFTypeID cf::reference<::SecCodeRef >::id ( )

inlinenoexceptinherited

initialize()

reference & cf::reference< ::CFPropertyListRef >::initialize ( ::CFPropertyListRef cf_object, bool retain = true )

inlineinherited

Here is the call graph for this function:

nested()

bool cf::tree< _preference >::nested ( const self_t & self )

inlinestaticinherited

operator::CFPropertyListRef() [1/2]

cf::reference< ::CFPropertyListRef >::operator ::CFPropertyListRef ( ) const

inlinenoexceptinherited

operator::CFPropertyListRef() [2/2]

cf::reference< ::CFPropertyListRef >::operator ::CFPropertyListRef ( ) const

inlinenoexceptinherited

operator::CFTypeID()

cf::reference< ::CFPropertyListRef >::operator::CFTypeID ( ) const

inlineexplicitnoexceptinherited

Here is the call graph for this function:

Here is the caller graph for this function:

property_list()

::CFPropertyListRef cf::tree< _preference >::property_list ( const self_t & self )

inlinestaticinherited

Here is the caller graph for this function:

release()

reference & cf::reference< ::CFPropertyListRef >::release ( )

inlinenoexceptinherited

Here is the call graph for this function:

Friends And Related Symbol Documentation

cf::tree< _preference >

friend class cf::tree< _preference >

friend

Member Data Documentation

cf_object

::CFPropertyListRef cf::reference< ::CFPropertyListRef >::cf_object

protectedinherited

try

::CFPropertyListRef value cf::tree< _preference >::try

inherited

---

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

• dx_coreaudio_server.h