# entities¶

class dolfin.cpp.mesh.entities(*args)

Bases: object

MeshEntityIterator provides a common iterator for mesh entities over meshes, boundaries and incidence relations. The basic use is illustrated below.

The following example shows how to iterate over all mesh entities
of a mesh of topological dimension dim:

for (MeshEntityIterator e(mesh, dim); !e.end(); ++e)
{
e->foo();
}

The following example shows how to iterate over mesh entities of
topological dimension dim connected (incident) to some mesh entity f:

for (MeshEntityIterator e(f, dim); !e.end(); ++e)
{
e->foo();
}


In addition to the general iterator, a set of specific named iterators are provided for entities of type Vertex , Edge , Face , Facet and Cell . These iterators are defined along with their respective classes.

Copy constructor.

Parameters: MeshEntityIterator & it (const) –
end()

Check if iterator has reached the end.

Return type: bool
end_iterator()

Provide a safeguard iterator pointing beyond the end of an iteration process, either iterating over the mesh /or incident entities. Added to be bit more like STL iterators, since many algorithms rely on a kind of beyond iterator.

Return type: MeshEntityIterator
next()
pos()

Return current position.

Return type: std::size_t
thisown

The membership flag