Function split_face 

pub fn split_face(
    model: &mut Model,
    shape: &Shape,
    face: &Shape,
    edges: &[Shape],
    projection: Projection,
    tol: Tolerances,
) -> OgeomResult<Built>

Cut face of shape along edges and rebuild shape around the pieces.

edges are edges, or wires and compounds of them, taken onto the face as projection says; curves meeting end to end are followed as one. Every stretch of a curve inside the face must run from the face’s boundary to its boundary, the boundary including the stretches cut before it, or close on itself inside the face; a curve that runs past the face is cut where it leaves it. The pieces share the new edges, and the boundary edges a cut ends on are cut there in every face that holds them. A region a seam of the face runs through is one piece, its boundary crossing the seam. A face given on its own comes back as a shell of its pieces.

The history records face modified into its pieces and each edge in edges generating the edges cut along it.

Errors

OgeomError::Construction, by reason, where face is not a face of shape, no edge is given, an edge asked to lie on the face does not, a curve or its projection misses the face, a curve ends inside the face, runs along its boundary, or runs from one boundary loop of it to another.