EggNameUniquifier

class EggNameUniquifier

Bases: EggObject

This is a handy class for guaranteeing unique node names in an egg hierarchy. It is an abstract class; to use it you must subclass off of it. See the comment above.

Inheritance diagram

bool add_name(std::string const &category, std::string const &name, EggNode *node = nullptr)

Adds the name to the indicated category. This name will not be used for any other egg node within this category. Returns true if the name was added, or false if it was already in use for the category.

void clear(void)

Empties the table of used named and prepares the Uniquifier for a new tree.

virtual std::string filter_name(EggNode *node)

Returns the name of the given node, or at least the name it should be. This provides a hook to adjust the name before attempting to uniquify it, if desired, for instance to remove invalid characters.

virtual std::string generate_name(EggNode *node, std::string const &category, int index)

Generates a new name for the given node when its existing name clashes with some other node. This function will be called repeatedly, if necessary, until it returns a name that actually is unique.

The category is the string returned by get_category(), and index is a uniquely-generated number that may be useful for synthesizing the name.

virtual std::string get_category(EggNode *node) = 0

static TypeHandle get_class_type(void)

EggNode *get_node(std::string const &category, std::string const &name) const

Returns the node associated with the given category and name, or NULL if the name has not been used.

bool has_name(std::string const &category, std::string const &name) const

Returns true if the name has been used for the indicated category already, false otherwise.

void uniquify(EggNode *node)

Begins the traversal from the indicated node.