Base class for standalone diagram elements. More...

Detailed Description

Base class for standalone diagram elements.

This is a base cass of any standalone elements such as classes, structs, concepts, packages and so on participants and so on.

Definition at line 47 of file diagram_element.h.

#include <diagram_element.h>

Public Member Functions
	diagram_element ()

	~diagram_element () override=default

const eid_t &	id () const
	Returns diagram element id.

void	set_id (eid_t id)

std::optional< eid_t >	parent_element_id () const

void	set_parent_element_id (eid_t id)

virtual std::string	alias () const
	Return elements' diagram alias.

void	set_name (const std::string &name)

void	set_name (const std::string &parent, const std::string &name)

std::string	name () const

virtual std::string	type_name () const

std::string	full_name (bool relative) const
	Return the elements fully qualified name.

std::vector< relationship > &	relationships ()

const std::vector< relationship > &	relationships () const

void	add_relationship (relationship &&cr)

void	append (const decorated_element &e)

bool	is_nested () const

void	nested (bool nested)

bool	complete () const

void	complete (bool completed)

void	remove_duplicate_relationships ()

virtual void	apply_filter (const diagram_filter &filter, const std::set< eid_t > &removed)

Public Member Functions inherited from clanguml::common::model::decorated_element
virtual	~decorated_element ()=default

bool	skip () const

bool	skip_relationship () const

std::pair< relationship_t, std::string >	get_relationship () const

std::string	style_spec () const

const std::vector< std::shared_ptr< decorators::decorator > > &	decorators () const

void	add_decorators (const std::vector< std::shared_ptr< decorators::decorator > > &decorators)

void	append (const decorated_element &de)

std::optional< comment_t >	comment () const

void	set_comment (const comment_t &c)

virtual std::optional< std::string >	doxygen_link () const

Public Member Functions inherited from clanguml::common::model::source_location
	source_location ()=default

	source_location (std::string f, unsigned int l)

const std::string &	file () const

void	set_file (const std::string &file)

const std::string &	file_relative () const

void	set_file_relative (const std::string &file)

const std::string &	translation_unit () const

void	set_translation_unit (const std::string &translation_unit)

unsigned int	line () const

void	set_line (const unsigned line)

unsigned int	column () const

void	set_column (const unsigned column)

unsigned int	location_id () const

void	set_location_id (unsigned int h)

Public Member Functions inherited from clanguml::util::memoized< full_name_tag_t, std::string, bool >
auto	memoize (bool is_complete, F &&f, Args... args) const

void	invalidate (Args... args) const

Public Member Functions inherited from clanguml::util::memoized< name_and_ns_tag, std::string >
auto	memoize (bool is_complete, F &&f, Args... args) const

void	invalidate (Args... args) const

Protected Member Functions
virtual std::string	full_name_impl (bool) const

Private Attributes
eid_t	id_ {}

std::optional< eid_t >	parent_element_id_ {}

std::string	name_

std::vector< relationship >	relationships_

bool	nested_ {false}

bool	complete_ {false}

Friends
bool	operator== (const diagram_element &l, const diagram_element &r)

std::ostream &	operator<< (std::ostream &out, const diagram_element &rhs)

Additional Inherited Members
Public Types inherited from clanguml::util::memoized< full_name_tag_t, std::string, bool >
using	key_t = std::tuple< Args... >

using	value_t = std::string

Public Types inherited from clanguml::util::memoized< name_and_ns_tag, std::string >
using	key_t = std::tuple< Args... >

using	value_t = std::string

Constructor & Destructor Documentation

◆ diagram_element()

clanguml::common::model::diagram_element::diagram_element ( )

default

◆ ~diagram_element()

clanguml::common::model::diagram_element::~diagram_element ( )

overridedefault

Member Function Documentation

◆ add_relationship()

void clanguml::common::model::diagram_element::add_relationship ( relationship && cr )

Add relationships, whose source is this element.

Parameters

cr	Relationship to another diagram element.

Definition at line 52 of file diagram_element.cc.

{
    if ((cr.type() == relationship_t::kInstantiation) &&
        (cr.destination() == id())) {
        LOG_DBG("Skipping self instantiation relationship for {}",
            cr.destination());
        return;
    }
 
    if (!util::contains(relationships_, cr)) {
        LOG_DBG("Adding relationship from: '{}' ({}) - {} - '{}'", id(),
            full_name(true), to_string(cr.type()), cr.destination());
 
        relationships_.emplace_back(std::move(cr));
    }
}

◆ alias()

std::string clanguml::common::model::diagram_element::alias ( ) const

virtual

Return elements' diagram alias.

Todo:: This is a PlantUML specific method - it shouldn't be here.

Returns: PlantUML's diagram element alias.

Reimplemented in clanguml::sequence_diagram::model::method, and clanguml::sequence_diagram::model::objc_method.

Definition at line 44 of file diagram_element.cc.

{
    // Only generate alias for global id's
    assert(id_.is_global());
 
    return fmt::format("C_{:022}", id_.value());
}

◆ append()

void clanguml::common::model::diagram_element::append ( const decorated_element & e )

Add element to the diagram.

Parameters

e	Diagram element.

Definition at line 79 of file diagram_element.cc.

{
    decorated_element::append(e);
}

◆ apply_filter()

void clanguml::common::model::diagram_element::apply_filter	(	const diagram_filter &	filter,
		const std::set< eid_t > &	removed
	)

virtual

Reimplemented in clanguml::class_diagram::model::class_.

Definition at line 105 of file diagram_element.cc.

{
    common::model::apply_filter(relationships(), filter);
 
    auto &rels = relationships();
    rels.erase(std::remove_if(std::begin(rels), std::end(rels),
                   [&removed](auto &&r) {
                       return removed.count(r.destination()) > 0;
                   }),
        std::end(rels));
}

◆ complete() [1/2]

bool clanguml::common::model::diagram_element::complete ( ) const

Returns the diagrams completion status.

Returns: Whether the diagram is complete.

Definition at line 88 of file diagram_element.cc.

88{ return complete_; }

◆ complete() [2/2]

void clanguml::common::model::diagram_element::complete ( bool completed )

Set the diagrams completion status.

Parameters

completed

Definition at line 90 of file diagram_element.cc.

90{ complete_ = completed; }

◆ full_name()

std::string clanguml::common::model::diagram_element::full_name ( bool relative ) const

inline

Return the elements fully qualified name.

This method should be implemented in each subclass, and ensure that for instance it includes fully qualified namespace, template params, etc.

Returns: Full elements name.

Definition at line 143 of file diagram_element.h.

    {
        return util::memoized<full_name_tag_t, std::string, bool>::memoize(
            complete(),
            [this](bool relative) { return full_name_impl(relative); },
            relative);
    }

◆ full_name_impl()

virtual std::string clanguml::common::model::diagram_element::full_name_impl ( bool ) const

inlineprotectedvirtual

Reimplemented in clanguml::common::model::element, clanguml::common::model::package, clanguml::sequence_diagram::model::method, clanguml::sequence_diagram::model::objc_method, clanguml::class_diagram::model::class_, clanguml::class_diagram::model::concept_, clanguml::class_diagram::model::enum_, clanguml::class_diagram::model::objc_interface, clanguml::sequence_diagram::model::class_, clanguml::sequence_diagram::model::function, clanguml::sequence_diagram::model::function_template, and clanguml::common::model::source_file.

Definition at line 223 of file diagram_element.h.

    {
        return name();
    }

◆ id()

const eid_t & clanguml::common::model::diagram_element::id ( ) const

Returns diagram element id.

Each element in the diagram is uniquely identified by id. The id is currently calculated from the full string representation of the element, in order to be uniquely identifiable among multiple translation units.

Returns: Elements id.

Definition at line 30 of file diagram_element.cc.

30{ return id_; }

◆ is_nested()

bool clanguml::common::model::diagram_element::is_nested ( ) const

Whether this element is nested in another element.

Returns

Definition at line 84 of file diagram_element.cc.

84{ return nested_; }

◆ name()

std::string clanguml::common::model::diagram_element::name ( ) const

inline

Return diagram element name.

Returns: Diagram element name.

Definition at line 126 of file diagram_element.h.

126{ return name_; }

◆ nested()

void clanguml::common::model::diagram_element::nested ( bool nested )

Set element's nested status.

Parameters

nested

Definition at line 86 of file diagram_element.cc.

86{ nested_ = nested; }

◆ parent_element_id()

std::optional< eid_t > clanguml::common::model::diagram_element::parent_element_id ( ) const

Get elements parent package id.

Returns: Parent package id if element is nested.

Definition at line 34 of file diagram_element.cc.

{
    return parent_element_id_;
}

◆ relationships() [1/2]

std::vector< relationship > & clanguml::common::model::diagram_element::relationships ( )

Return all relationships outgoing from this element.

Returns: List of relationships.

Definition at line 69 of file diagram_element.cc.

{
    return relationships_;
}

◆ relationships() [2/2]

const std::vector< relationship > & clanguml::common::model::diagram_element::relationships ( ) const

Return all relationships outgoing from this element.

Returns: List of relationships.

Definition at line 74 of file diagram_element.cc.

{
    return relationships_;
}

◆ remove_duplicate_relationships()

void clanguml::common::model::diagram_element::remove_duplicate_relationships ( )

Due to the fact that a relationship to the same element can be added once with local TU id and other time with global id, the relationship set can contain duplicates.

Definition at line 92 of file diagram_element.cc.

{
    std::vector<relationship> unique_relationships;
 
    for (auto &r : relationships_) {
        if (!util::contains(unique_relationships, r)) {
            unique_relationships.emplace_back(r);
        }
    }
 
    std::swap(relationships_, unique_relationships);
}

◆ set_id()

void clanguml::common::model::diagram_element::set_id ( eid_t id )

Set elements id.

Parameters

id	Elements id.

Definition at line 32 of file diagram_element.cc.

32{ id_ = id; }

◆ set_name() [1/2]

void clanguml::common::model::diagram_element::set_name ( const std::string & name )

inline

Set diagram elements name.

Parameters

name	Elements name.

Definition at line 104 of file diagram_element.h.

    {
        util::memoized<name_and_ns_tag, std::string>::invalidate();
        name_ = name;
    }

◆ set_name() [2/2]

void clanguml::common::model::diagram_element::set_name	(	const std::string &	parent,
		const std::string &	name
	)

inline

Set diagram elements name for nested elements.

Parameters

parent	Parents name.
name	Elements name.

Definition at line 116 of file diagram_element.h.

    {
        set_name(fmt::format("{}##{}", parent, name));
    }

◆ set_parent_element_id()

void clanguml::common::model::diagram_element::set_parent_element_id ( eid_t id )

Set elements parent package id.

Parameters

id	Id of parent package.

Definition at line 39 of file diagram_element.cc.

{
    parent_element_id_ = id;
}

◆ type_name()

virtual std::string clanguml::common::model::diagram_element::type_name ( ) const

inlinevirtual

Return the type name of the diagram element.

Returns: Diagrams element type name.

Reimplemented in clanguml::class_diagram::model::class_, clanguml::class_diagram::model::concept_, clanguml::class_diagram::model::enum_, clanguml::class_diagram::model::objc_interface, clanguml::common::model::package, clanguml::sequence_diagram::model::participant, clanguml::sequence_diagram::model::class_, clanguml::sequence_diagram::model::function, clanguml::sequence_diagram::model::method, clanguml::sequence_diagram::model::objc_method, and clanguml::sequence_diagram::model::function_template.

Definition at line 133 of file diagram_element.h.

133{ return "__undefined__"; };

Friends And Related Symbol Documentation

◆ operator<<

std::ostream & operator<<	(	std::ostream &	out,
		const diagram_element &	rhs
	)

friend

Definition at line 123 of file diagram_element.cc.

{
    out << "(" << rhs.name() << ", full_name=[" << rhs.full_name(false) << "])";
 
    return out;
}

◆ operator==

bool operator==	(	const diagram_element &	l,
		const diagram_element &	r
	)

friend

Definition at line 118 of file diagram_element.cc.

{
    return l.id() == r.id();
}

Member Data Documentation

◆ complete_

bool clanguml::common::model::diagram_element::complete_ {false}

private

Definition at line 234 of file diagram_element.h.

◆ id_

eid_t clanguml::common::model::diagram_element::id_ {}

private

Definition at line 229 of file diagram_element.h.

◆ name_

std::string clanguml::common::model::diagram_element::name_

private

Definition at line 231 of file diagram_element.h.

◆ nested_

bool clanguml::common::model::diagram_element::nested_ {false}

private

Definition at line 233 of file diagram_element.h.

◆ parent_element_id_

std::optional<eid_t> clanguml::common::model::diagram_element::parent_element_id_ {}

private

Definition at line 230 of file diagram_element.h.

◆ relationships_

std::vector<relationship> clanguml::common::model::diagram_element::relationships_

private

Definition at line 232 of file diagram_element.h.

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

src/common/model/diagram_element.h
src/common/model/diagram_element.cc

Detailed Description

Public Member Functions

Protected Member Functions

Private Attributes

Friends

Additional Inherited Members

Constructor & Destructor Documentation

◆ diagram_element()

◆ ~diagram_element()

Member Function Documentation

◆ add_relationship()

◆ alias()

◆ append()

◆ apply_filter()

◆ complete() [1/2]

◆ complete() [2/2]

◆ full_name()

◆ full_name_impl()

◆ id()

◆ is_nested()

◆ name()

◆ nested()

◆ parent_element_id()

◆ relationships() [1/2]

◆ relationships() [2/2]

◆ remove_duplicate_relationships()

◆ set_id()

◆ set_name() [1/2]

◆ set_name() [2/2]

◆ set_parent_element_id()

◆ type_name()

Friends And Related Symbol Documentation

◆ operator<<

◆ operator==

Member Data Documentation

◆ complete_

◆ id_

◆ name_

◆ nested_

◆ parent_element_id_

◆ relationships_