decorate.h 1.38 KB
Newer Older
1 2 3
#ifndef DECORATE_H
#define DECORATE_H

4 5 6 7 8 9 10 11 12 13
/*
 * A data structure that associates Git objects to void pointers. See
 * t/helper/test-example-decorate.c for a demonstration of how to use these
 * functions.
 */

/*
 * An entry in the data structure.
 */
struct decoration_entry {
14
	const struct object *base;
15 16 17
	void *decoration;
};

18 19 20 21 22
/*
 * The data structure.
 *
 * This data structure must be zero-initialized.
 */
23
struct decoration {
24 25 26 27
	/*
	 * Not used by the decoration mechanism. Clients may use this for
	 * whatever they want.
	 */
28
	const char *name;
29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45

	/*
	 * The capacity of "entries".
	 */
	unsigned int size;

	/*
	 * The number of real Git objects (that is, entries with non-NULL
	 * "base").
	 */
	unsigned int nr;

	/*
	 * The entries. This is an array of size "size", containing nr entries
	 * with non-NULL "base" and (size - nr) entries with NULL "base".
	 */
	struct decoration_entry *entries;
46 47
};

48 49 50 51 52
/*
 * Add an association from the given object to the given pointer (which may be
 * NULL), returning the previously associated pointer. If there is no previous
 * association, this function returns NULL.
 */
53
extern void *add_decoration(struct decoration *n, const struct object *obj, void *decoration);
54 55 56 57 58

/*
 * Return the pointer associated to the given object. If there is no
 * association, this function returns NULL.
 */
59
extern void *lookup_decoration(struct decoration *n, const struct object *obj);
60 61

#endif