api/latest/dictionary_8h_source.html

#ifndef POSER_CORE_DICTIONARY_H

#define POSER_CORE_DICTIONARY_H


#include <poser/decl.h>


#include <stddef.h>


C_CLASS_DECL(PSC_Dictionary);


DECLDATA void (*PSC_DICT_NODELETE)(void *);


DECLEXPORT PSC_Dictionary *

PSC_Dictionary_create(void (*deleter)(void *));


DECLEXPORT void

PSC_Dictionary_set(PSC_Dictionary *self, const void *key, size_t keysz,

    void *obj, void (*deleter)(void *))

    CMETHOD ATTR_NONNULL((2));


DECLEXPORT void *

PSC_Dictionary_get(const PSC_Dictionary *self, const void *key, size_t keysz)

    CMETHOD ATTR_PURE ATTR_NONNULL((2));


DECLEXPORT size_t

PSC_Dictionary_count(const PSC_Dictionary *self)

    CMETHOD ATTR_PURE;


DECLEXPORT size_t

PSC_Dictionary_removeAll(PSC_Dictionary *self,

    int (*matcher)(const void *, size_t, void *, const void *),

    const void *arg)

    CMETHOD ATTR_NONNULL((1));


void

PSC_Dictionary_destroy(PSC_Dictionary *self);


#endif

PSC_Dictionary
A dictionary storing any data objects using any type of keys.

PSC_Dictionary::PSC_Dictionary_create
PSC_Dictionary * PSC_Dictionary_create(void(*deleter)(void *))
PSC_Dictionary default constructor.

PSC_Dictionary::PSC_Dictionary_removeAll
size_t PSC_Dictionary_removeAll(PSC_Dictionary *self, int(*matcher)(const void *, size_t, void *, const void *), const void *arg)
Remove all matching entries from dictionary.

PSC_Dictionary::PSC_Dictionary_get
void * PSC_Dictionary_get(const PSC_Dictionary *self, const void *key, size_t keysz)
Retrieve a stored object by its key.

PSC_Dictionary::PSC_Dictionary_destroy
void PSC_Dictionary_destroy(PSC_Dictionary *self)
PSC_Dictionary destructor.

PSC_Dictionary::PSC_Dictionary_set
void PSC_Dictionary_set(PSC_Dictionary *self, const void *key, size_t keysz, void *obj, void(*deleter)(void *))
Set a new object for a given key.

PSC_Dictionary::PSC_Dictionary_count
size_t PSC_Dictionary_count(const PSC_Dictionary *self)
The total number of stored objects.