Stream_support: Add read_MEDIT()

[afabri]

Summary of Changes

Add a function that reads into an indexed cell set, that is a vector of points and a vector of arrays of 4 indices.

Todo

• Do we want an overload for reading facets
• Update User Manual
• Add testsuite

Release Management

• Affected package(s): Stream_support
• Feature/Small Feature (if any):
• Link to compiled documentation (obligatory for small feature) wrong link name to be changed
• License and copyright ownership: unchanged

[afabri]

/build:v0

[github-actions]

There was an error while building the doc:

/home/runner/work/cgal/cgal/Stream_support/doc/Stream_support/PackageDescription.txt:47: warning: unable to resolve reference to 'IOStreamMEDIT' for \ref command
<IOstreamFunctions>:1: warning: unable to resolve reference to 'IOStreamMEDIT' for \ref command
/home/runner/work/cgal/cgal/Stream_support/include/CGAL/IO/MEDIT.h:247: warning: The following parameters of CGAL::IO::read_MEDIT(std::istream &is, PointRange &points, CellRange &finite_cells, std::vector< int > &subdomains, bool verbose=false) are not documented:
  parameter 'subdomains'
  parameter 'verbose'

https://github.com/CGAL/cgal/actions/runs/30813601693

[afabri]

/build:v0

[github-actions]

There was an error while building the doc:

/home/runner/work/cgal/cgal/Stream_support/include/CGAL/IO/MEDIT.h:261: warning: Found non-existing group 'PkgStreamSupportIoFuncsMEDIT' for the command '@ingroup', ignoring command
/home/runner/work/cgal/cgal/Stream_support/doc/Stream_support/PackageDescription.txt:134: warning: unable to resolve link to 'PkgStreamSupportIoFuncsMEDIT' for \link command

https://github.com/CGAL/cgal/actions/runs/30815117302

[afabri]

/build:v0

[github-actions]

There was an error while building the doc:

/home/runner/work/cgal/cgal/Stream_support/include/CGAL/IO/MEDIT.h:247: warning: The following parameters of CGAL::IO::read_MEDIT(std::istream &is, PointRange &points, CellRange &finite_cells, std::vector< int > &subdomains, bool verbose=false) are not documented:
  parameter 'subdomains'
  parameter 'verbose'

https://github.com/CGAL/cgal/actions/runs/30815678501

[afabri]

/build:v0

[github-actions]

The documentation is built. It will be available, after a few minutes, here: https://cgal.github.io/9589/v0/Manual/index.html