amxd_object_hierarchy.c File Reference

#include <stdlib.h>
#include <string.h>
#include <stdarg.h>
#include <ctype.h>
#include "amxd_priv.h"
#include <amxd/amxd_common.h>
#include <amxd/amxd_dm.h>
#include <amxd/amxd_object.h>
#include <amxd/amxd_path.h>
#include "amxd_dm_priv.h"
#include "amxd_object_priv.h"
#include "amxd_assert.h"

Go to the source code of this file.

Macros
#define	_GNU_SOURCE

Functions
static void	amxd_object_hierarchy_up (amxd_object_t *const object, amxd_object_filter_fn_t filter, amxd_object_cb_fn_t cb, int32_t depth, void *priv)
static void	amxd_object_hierarchy_down (amxd_object_t *const object, const amxd_direction_t direction, amxd_object_filter_fn_t filter, amxd_object_cb_fn_t cb, int32_t depth, void *priv)
static void	amxd_path_prepend_instance (const amxd_object_t *object, amxc_string_t *path, const char *name, uint32_t length, const uint32_t flags)
static char *	amxd_object_build_path (const amxd_object_t *object, const amxd_object_t *stop, const uint32_t flags)
static amxd_object_t *	amxd_object_is_supported_impl (amxd_object_t *object, amxd_path_t *path)
amxd_object_t *	amxd_object_get_parent (const amxd_object_t *const object)
	Get the parent object. More...
amxd_object_t *	amxd_object_get_root (const amxd_object_t *const object)
	Get the data model root. More...
amxd_dm_t *	amxd_object_get_dm (const amxd_object_t *const object)
	Get the data model. More...
amxd_object_t *	amxd_object_get_child (const amxd_object_t *object, const char *name)
	Get a child of the object. More...
amxd_object_t *	amxd_object_get_instance (const amxd_object_t *object, const char *name, uint32_t index)
	Get an instance of the template object. More...
amxd_object_t *	amxd_object_get (const amxd_object_t *object, const char *name)
	Get an instance or child of an object. More...
amxd_object_t *	amxd_object_findf (amxd_object_t *const object, const char *rel_path,...)
amxd_status_t	amxd_object_resolve_pathf (amxd_object_t *object, amxc_llist_t *paths, const char *rel_path,...)
amxd_status_t	amxd_object_resolve_pathf_ext (amxd_object_t *object, bool *key_path, amxc_llist_t *paths, const char *rel_path,...)
char *	amxd_object_get_path (const amxd_object_t *object, const uint32_t flags)
	Get the full path of the object. More...
char *	amxd_object_get_rel_path (const amxd_object_t *child, const amxd_object_t *parent, const uint32_t flags)
	Get the relative path of the object. More...
bool	amxd_object_is_child_of (const amxd_object_t *const child, const amxd_object_t *const parent)
	Checks if the child object is in the hierarchical tree of the parent object. More...
void	amxd_object_hierarchy_walk (amxd_object_t *const object, const amxd_direction_t direction, amxd_object_filter_fn_t filter, amxd_object_cb_fn_t cb, int32_t depth, void *priv)
	Iterates over all objects in the data model tree. More...
void	amxd_object_for_all (amxd_object_t *object, const char *rel_spath, amxd_mobject_cb_t fn, void *priv)
	Executes a task for all matching objects in an object tree. More...
bool	amxd_object_is_supported (amxd_object_t *object, const char *req_path)
	Checks if a path is in the supported data model. More...

Macro Definition Documentation

_GNU_SOURCE

#define _GNU_SOURCE

Definition at line 56 of file amxd_object_hierarchy.c.

Function Documentation

amxd_object_build_path()

static char* amxd_object_build_path ( const amxd_object_t *  object, const amxd_object_t *  stop, const uint32_t  flags  )

static

Definition at line 152 of file amxd_object_hierarchy.c.

                                                          {
    amxc_string_t path;
    const amxd_object_t* current = object;
    const char* sep = NULL;
    char* str_path = NULL;
    int sep_length = 0;
 
    if((flags & AMXD_OBJECT_REGEXP) == AMXD_OBJECT_REGEXP) {
        sep = "\\.";
        sep_length = 2;
    } else {
        sep = ".";
        sep_length = 1;
    }
 
    amxc_string_init(&path, 64);
 
    while(current != stop &&
          amxd_object_get_name(current, flags) != NULL) {
        const char* name = amxd_object_get_name(current, flags);
        int length = strlen(name);
 
        if(!amxc_string_is_empty(&path) &&
           ( strncmp(path.buffer, sep, sep_length) != 0)) {
            amxc_string_prepend(&path, sep, sep_length);
        }
 
        if(amxd_object_get_type(current) == amxd_object_instance) {
            amxd_path_prepend_instance(current, &path, name, length, flags);
        } else {
            if(((flags & AMXD_OBJECT_SUPPORTED) == AMXD_OBJECT_SUPPORTED) &&
               ( amxd_object_get_type(current) == amxd_object_template)) {
                amxc_string_prepend(&path, "{i}", 3);
                amxc_string_prepend(&path, sep, sep_length);
            }
            amxc_string_prepend(&path, name, length);
        }
        current = amxd_object_get_parent(current);
    }
 
    if((flags & AMXD_OBJECT_TERMINATE) == AMXD_OBJECT_TERMINATE) {
        amxc_string_append(&path, sep, sep_length);
    }
 
    str_path = amxc_string_take_buffer(&path);
    amxc_string_clean(&path);
 
    return str_path;
}

amxd_object_findf()

amxd_object_t* amxd_object_findf	(	amxd_object_t *const	object,
		const char *	rel_path,
			...
	)

Definition at line 392 of file amxd_object_hierarchy.c.

                                      {
    amxd_object_t* result = NULL;
    amxd_dm_t* dm = NULL;
    amxd_status_t status = amxd_status_ok;
    amxd_path_t path;
    va_list args;
    bool key_path = false;
 
    amxd_path_init(&path, NULL);
 
    when_null(object, exit);
    when_str_empty(rel_path, exit);
 
    if(!amxd_object_is_base(object)) {
        dm = amxd_object_get_dm(object);
    }
 
    va_start(args, rel_path);
    status = amxd_path_vsetf(&path, true, rel_path, args);
    va_end(args);
    when_failed(status, exit);
 
    result = amxd_object_find_internal(object, &key_path, &path, &status);
 
exit:
    if(dm != NULL) {
        dm->status = status;
    }
    amxd_path_clean(&path);
    return result;
}

amxd_object_hierarchy_down()

static void amxd_object_hierarchy_down ( amxd_object_t *const  object, const amxd_direction_t  direction, amxd_object_filter_fn_t  filter, amxd_object_cb_fn_t  cb, int32_t  depth, void *  priv  )

static

Definition at line 92 of file amxd_object_hierarchy.c.

                                                   {
    if(depth < 0) {
        return;
    }
 
    if((filter != NULL) && !filter(object, depth, priv)) {
        return;
    }
    if(direction == amxd_direction_down) {
        cb(object, depth, priv);
    }
 
    depth = depth == INT32_MAX ? INT32_MAX : depth - 1;
    amxd_object_for_each(child, it, object) {
        amxd_object_t* child = amxc_container_of(it, amxd_object_t, it);
        amxd_object_hierarchy_down(child, direction, filter, cb, depth, priv);
    }
 
    amxd_object_for_each(instance, it, object) {
        amxd_object_t* instance = amxc_container_of(it, amxd_object_t, it);
        amxd_object_hierarchy_down(instance, direction, filter, cb, depth, priv);
    }
    if(direction == amxd_direction_down_reverse) {
        cb(object, depth, priv);
    }
}

amxd_object_hierarchy_up()

static void amxd_object_hierarchy_up ( amxd_object_t *const  object, amxd_object_filter_fn_t  filter, amxd_object_cb_fn_t  cb, int32_t  depth, void *  priv  )

static

Definition at line 76 of file amxd_object_hierarchy.c.

                                                 {
    amxd_object_t* current = object;
    while(current != NULL && depth >= 0) {
        if((filter != NULL) && !filter(current, depth, priv)) {
            break;
        }
        cb(current, depth, priv);
        current = amxd_object_get_parent(current);
        depth = depth == INT32_MAX ? INT32_MAX : depth - 1;
    }
}

amxd_object_is_supported_impl()

static amxd_object_t* amxd_object_is_supported_impl ( amxd_object_t *  object, amxd_path_t *  path  )

static

Definition at line 204 of file amxd_object_hierarchy.c.

                                                                       {
    char* part = NULL;
 
    if(amxd_object_get_type(object) == amxd_object_template) {
        part = amxd_path_get_first(path, true);
        free(part);
    }
    part = amxd_path_get_first(path, true);
    if((part != NULL) && (part[0] == '.')) {
        free(part);
        part = amxd_path_get_first(path, true);
    }
    when_null(part, exit);
    object = amxd_object_get(object, part);
    free(part);
    when_null(object, exit);
    object = amxd_object_is_supported_impl(object, path);
 
exit:
    return object;
}

amxd_object_resolve_pathf()

amxd_status_t amxd_object_resolve_pathf	(	amxd_object_t *	object,
		amxc_llist_t *	paths,
		const char *	rel_path,
			...
	)

Definition at line 426 of file amxd_object_hierarchy.c.

                                             {
    amxd_status_t status = amxd_status_unknown_error;
    amxd_path_t path;
    va_list args;
    bool key_path = false;
 
    amxd_path_init(&path, NULL);
 
    when_null(object, exit);
    when_true(amxd_object_is_base(object), exit);
    when_str_empty(rel_path, exit);
 
    va_start(args, rel_path);
    status = amxd_path_vsetf(&path, true, rel_path, args);
    va_end(args);
    when_failed(status, exit);
 
    status = amxd_object_resolve_internal(object, &key_path, paths, &path);
 
exit:
    amxd_path_clean(&path);
    return status;
}

amxd_object_resolve_pathf_ext()

amxd_status_t amxd_object_resolve_pathf_ext	(	amxd_object_t *	object,
		bool *	key_path,
		amxc_llist_t *	paths,
		const char *	rel_path,
			...
	)

Definition at line 453 of file amxd_object_hierarchy.c.

                                                 {
    amxd_status_t status = amxd_status_unknown_error;
    amxd_path_t path;
    va_list args;
 
    amxd_path_init(&path, NULL);
 
    when_null(key_path, exit);
    when_null(object, exit);
    when_true(amxd_object_is_base(object), exit);
    when_str_empty(rel_path, exit);
 
    *key_path = false;
 
    va_start(args, rel_path);
    status = amxd_path_vsetf(&path, true, rel_path, args);
    va_end(args);
    when_failed(status, exit);
 
    status = amxd_object_resolve_internal(object, key_path, paths, &path);
 
exit:
    amxd_path_clean(&path);
    return status;
}

amxd_path_prepend_instance()

static void amxd_path_prepend_instance ( const amxd_object_t *  object, amxc_string_t *  path, const char *  name, uint32_t  length, const uint32_t  flags  )

static

Definition at line 124 of file amxd_object_hierarchy.c.

                                                             {
    if((flags & AMXD_OBJECT_SUPPORTED) != AMXD_OBJECT_SUPPORTED) {
        if((flags & AMXD_OBJECT_EXTENDED) == AMXD_OBJECT_EXTENDED) {
            if((flags & AMXD_OBJECT_REGEXP) == AMXD_OBJECT_REGEXP) {
                amxc_string_prepend(path, "\\]", 2);
            } else {
                amxc_string_prepend(path, "]", 1);
            }
        }
        if((flags & AMXD_OBJECT_INDEXED) == AMXD_OBJECT_INDEXED) {
            amxc_string_prependf(path, "%" PRId32, object->index);
        } else {
            amxc_string_prepend(path, name, length);
        }
        if((flags & AMXD_OBJECT_EXTENDED) == AMXD_OBJECT_EXTENDED) {
            if((flags & AMXD_OBJECT_REGEXP) == AMXD_OBJECT_REGEXP) {
                amxc_string_prepend(path, "\\[", 2);
            } else {
                amxc_string_prepend(path, "[", 1);
            }
        }
    }
}