File: entitydb.rst

package info (click to toggle)
ezdxf 1.4.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 104,528 kB
  • sloc: python: 182,341; makefile: 116; lisp: 20; ansic: 4
file content (79 lines) | stat: -rw-r--r-- 1,986 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
.. module:: ezdxf.entitydb

Entity Database
===============

The :class:`EntityDB` is a simple key/value database to store
:class:`~ezdxf.entities.DXFEntity` objects by it's handle,
every :class:`~ezdxf.document.Drawing` has its own :class:`EntityDB`, stored in
the :class:`Drawing` attribute :attr:`~ezdxf.document.Drawing.entitydb`.

Every DXF entity/object, except tables and sections, are represented as
:class:`DXFEntity` or inherited types, this entities are stored in the
:class:`EntityDB`, database-key is the :attr:`dxf.handle` as plain hex
string.

All iterators like :meth:`keys`, :meth:`values`, :meth:`items` and :meth:`__iter__`
do not yield destroyed entities.

.. warning::

    The :meth:`get` method and the index operator ``[]``, return destroyed
    entities and entities from the trashcan.

.. class:: EntityDB

    .. automethod:: __getitem__(handle: str) -> DXFEntity

    .. automethod:: __setitem__(handle: str, entity: DXFEntity) -> None

    .. automethod:: __delitem__

    .. automethod:: __contains__(item: Union[str, DXFEntity]) -> bool

    .. automethod:: __len__

    .. automethod:: __iter__

    .. automethod:: get(handle: str) -> Optional[DXFEntity]

    .. automethod:: next_handle

    .. automethod:: keys

    .. automethod:: values() -> Iterable[DXFEntity]

    .. automethod:: items()  -> Iterable[Tuple[str, DXFEntity]]

    .. automethod:: add(entity: DXFEntity) -> None

    .. automethod:: new_trashcan

    .. automethod:: trashcan

    .. automethod:: purge

    .. automethod:: query

Entity Space
============

.. autoclass:: EntitySpace

    .. automethod:: __iter__() -> Iterable[DXFEntity]

    .. automethod:: __getitem__(index) -> DXFEntity

    .. automethod:: __len__

    .. automethod:: has_handle

    .. automethod:: purge

    .. automethod:: add(entity: DXFEntity) -> None

    .. automethod:: extend(entities: Iterable[DXFEntity]) -> None

    .. automethod:: remove(entity: DXFEntity) -> None

    .. automethod:: clear