There are several overloaded function templates called symmetric_difference() that compute the symmetric difference between two or more input polygons and insert the resulting polygons with holes into a container via an output iterator.

A function template in this group that accepts two input polygons has one of the two following signatures:

OutputIterator symmetric_difference(const Type1& pgn1, const Type2& pgn2, OutputIterator oi);
OutputIterator symmetric_difference(const Type1& pgn1, const Type2& pgn2, OutputIterator oi, const GpsTraits& traits);

Parameters

oi	the output iterator for the result.

The types Type1 and Type2 of the parameters must be convertible to the types specified in a row in the table below, respectively. The 3rd column specifies the corresponding dereference type of the output iterator.

`Type1`	`Type2`	Dereference Type of `oi`
`Polygon_2`	`Polygon_2`	`Polygon_with_holes_2`
`Polygon_2`	`Polygon_with_holes_2`	`Polygon_with_holes_2`
`Polygon_with_holes_2`	`Polygon_2`	`Polygon_with_holes_2`
`Polygon_with_holes_2`	`Polygon_with_holes_2`	`Polygon_with_holes_2`
`General_polygon_2`	`General_polygon_2`	`General_polygon_with_holes_2`
`General_polygon_2`	`General_polygon_with_holes_2`	`General_polygon_with_holes_2`
`General_polygon_with_holes_2`	`General_polygon_2`	`General_polygon_with_holes_2`
`General_polygon_with_holes_2`	`General_polygon_with_holes_2`	`General_polygon_with_holes_2`

See also: CGAL::complement(); CGAL::do_intersect(); CGAL::intersection(); CGAL::join(); CGAL::difference()

Functions
template<typename Kernel , typename Container , typename OutputIterator >
OutputIterator	CGAL::symmetric_difference (const Polygon_2< Kernel, Container > &pgn1, const Polygon_2< Kernel, Container > &pgn2, OutputIterator oi)
	computes the symmetric difference between two polygons and inserts the resulting polygons with holes into a container via an output iterator. More...

template<typename Kernel , typename Container , typename OutputIterator >
OutputIterator	CGAL::symmetric_difference (const Polygon_2< Kernel, Container > &pgn1, const Polygon_with_holes_2< Kernel, Container > &pgn2, OutputIterator oi)
	computes the symmetric difference between two polygons and inserts the resulting polygons with holes into a container via an output iterator. More...

template<typename Kernel , typename Container , typename OutputIterator >
OutputIterator	CGAL::symmetric_difference (const Polygon_with_holes_2< Kernel, Container > &pgn1, const Polygon_2< Kernel, Container > &pgn2, OutputIterator oi)
	computes the symmetric difference between two polygons and inserts the resulting polygons with holes into a container via an output iterator. More...

template<typename Kernel , typename Container , typename OutputIterator >
OutputIterator	CGAL::symmetric_difference (const Polygon_with_holes_2< Kernel, Container > &pgn1, const Polygon_with_holes_2< Kernel, Container > &pgn2, OutputIterator oi)
	computes the symmetric difference between two polygons with holes and inserts the resulting polygons with holes into a container via an output iterator. More...

template<typename ArrTraits , typename OutputIterator >
OutputIterator	CGAL::symmetric_difference (const General_polygon_2< ArrTraits > &pgn1, const General_polygon_2< ArrTraits > &pgn2, OutputIterator oi)
	computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator. More...

template<typename ArrTraits , typename OutputIterator >
OutputIterator	CGAL::symmetric_difference (const General_polygon_with_holes_2< General_polygon_2< ArrTraits > > &pgn1, const General_polygon_2< ArrTraits > &pgn2, OutputIterator oi)
	computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator. More...

template<typename ArrTraits , typename OutputIterator >
OutputIterator	CGAL::symmetric_difference (const General_polygon_2< ArrTraits > &pgn1, const General_polygon_with_holes_2< General_polygon_2< ArrTraits > > &pgn2, OutputIterator oi)
	computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator. More...

template<typename Polygon , typename OutputIterator >
OutputIterator	CGAL::symmetric_difference (const General_polygon_with_holes_2< Polygon > &pgn1, const General_polygon_with_holes_2< Polygon > &pgn2, OutputIterator oi)
	computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator. More...

template<typename InputIterator , typename OutputIterator >
OutputIterator	CGAL::symmetric_difference (InputIterator begin, InputIterator end, OutputIterator oi)
	Given a range of polygons (resp. More...

template<typename InputIterator1 , typename InputIterator2 , typename OutputIterator >
OutputIterator	CGAL::symmetric_difference (InputIterator1 begin1, InputIterator1 end1, InputIterator2 begin2, InputIterator2 end2, OutputIterator oi)
	Given a range of polygons (resp. More...

template<typename Kernel , typename Container , typename OutputIterator , typename GpsTraits >
OutputIterator	CGAL::symmetric_difference (const Polygon_2< Kernel, Container > &pgn1, const Polygon_2< Kernel, Container > &pgn2, OutputIterator oi, const GpsTraits &traits)
	computes the symmetric difference between two polygons and inserts the resulting polygons with holes into a container via an output iterator. More...

template<typename Kernel , typename Container , typename OutputIterator , typename GpsTraits >
OutputIterator	CGAL::symmetric_difference (const Polygon_2< Kernel, Container > &pgn1, const Polygon_with_holes_2< Kernel, Container > &pgn2, OutputIterator oi, const GpsTraits &traits)
	computes the symmetric difference between two polygons and inserts the resulting polygons with holes into a container via an output iterator. More...

template<typename Kernel , typename Container , typename OutputIterator , typename GpsTraits >
OutputIterator	CGAL::symmetric_difference (const Polygon_with_holes_2< Kernel, Container > &pgn1, const Polygon_2< Kernel, Container > &pgn2, OutputIterator oi, const GpsTraits &traits)
	computes the symmetric difference between two polygons and inserts the resulting polygons with holes into a container via an output iterator. More...

template<typename Kernel , typename Container , typename OutputIterator , typename GpsTraits >
OutputIterator	CGAL::symmetric_difference (const Polygon_with_holes_2< Kernel, Container > &pgn1, const Polygon_with_holes_2< Kernel, Container > &pgn2, OutputIterator oi, const GpsTraits &traits)
	computes the symmetric difference between two polygons with holes and inserts the resulting polygons with holes into a container via an output iterator. More...

template<typename ArrTraits , typename OutputIterator , typename GpsTraits >
OutputIterator	CGAL::symmetric_difference (const General_polygon_2< ArrTraits > &pgn1, const General_polygon_2< ArrTraits > &pgn2, OutputIterator oi, const GpsTraits &traits)
	computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator. More...

template<typename ArrTraits , typename OutputIterator , typename GpsTraits >
OutputIterator	CGAL::symmetric_difference (const General_polygon_with_holes_2< General_polygon_2< ArrTraits > > &pgn1, const General_polygon_2< ArrTraits > &pgn2, OutputIterator oi, const GpsTraits &traits)
	computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator. More...

template<typename ArrTraits , typename OutputIterator , typename GpsTraits >
OutputIterator	CGAL::symmetric_difference (const General_polygon_2< ArrTraits > &pgn1, const General_polygon_with_holes_2< General_polygon_2< ArrTraits > > &pgn2, OutputIterator oi, const GpsTraits &traits)
	computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator. More...

template<typename Polygon , typename OutputIterator , typename GpsTraits >
OutputIterator	CGAL::symmetric_difference (const General_polygon_with_holes_2< Polygon > &pgn1, const General_polygon_with_holes_2< Polygon > &pgn2, OutputIterator oi, const GpsTraits &traits)
	computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator. More...

template<typename InputIterator , typename OutputIterator , typename GpsTraits >
OutputIterator	CGAL::symmetric_difference (InputIterator begin, InputIterator end, OutputIterator oi, const GpsTraits &traits)
	Given a range of polygons (resp. More...

template<typename InputIterator1 , typename InputIterator2 , typename OutputIterator , typename GpsTraits >
OutputIterator	CGAL::symmetric_difference (InputIterator1 begin1, InputIterator1 end1, InputIterator2 begin2, InputIterator2 end2, OutputIterator oi, const GpsTraits &traits)
	Given a range of polygons (resp. More...

Function Documentation

◆ symmetric_difference() [1/20]

template<typename Kernel , typename Container , typename OutputIterator >

OutputIterator CGAL::symmetric_difference	(	const Polygon_2< Kernel, Container > &	pgn1,
		const Polygon_2< Kernel, Container > &	pgn2,
		OutputIterator	oi
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two polygons and inserts the resulting polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `Polygon_with_holes_2<Kernel, Container>`.

Returns: the past-the-end iterator of the output container.

Examples:: Boolean_set_operations_2/symmetric_difference.cpp.

◆ symmetric_difference() [2/20]

template<typename Kernel , typename Container , typename OutputIterator >

OutputIterator CGAL::symmetric_difference	(	const Polygon_2< Kernel, Container > &	pgn1,
		const Polygon_with_holes_2< Kernel, Container > &	pgn2,
		OutputIterator	oi
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two polygons and inserts the resulting polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `Polygon_with_holes_2<Kernel, Container>`.

Returns: the past-the-end iterator of the output container.

◆ symmetric_difference() [3/20]

template<typename Kernel , typename Container , typename OutputIterator >

OutputIterator CGAL::symmetric_difference	(	const Polygon_with_holes_2< Kernel, Container > &	pgn1,
		const Polygon_2< Kernel, Container > &	pgn2,
		OutputIterator	oi
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two polygons and inserts the resulting polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `Polygon_with_holes_2<Kernel, Container>`.

Returns: the past-the-end iterator of the output container.

◆ symmetric_difference() [4/20]

template<typename Kernel , typename Container , typename OutputIterator >

OutputIterator CGAL::symmetric_difference	(	const Polygon_with_holes_2< Kernel, Container > &	pgn1,
		const Polygon_with_holes_2< Kernel, Container > &	pgn2,
		OutputIterator	oi
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two polygons with holes and inserts the resulting polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `Polygon_with_holes_2<Kernel, Container>`.

Returns: the past-the-end iterator of the output container.

◆ symmetric_difference() [5/20]

template<typename ArrTraits , typename OutputIterator >

OutputIterator CGAL::symmetric_difference	(	const General_polygon_2< ArrTraits > &	pgn1,
		const General_polygon_2< ArrTraits > &	pgn2,
		OutputIterator	oi
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `General_polygon_with_holes_2<General_polygon_2<ArrTraits> >`.

Returns: the past-the-end iterator of the output container.

Precondition: ArrTraits must be a model of the concept ArrangementDirectionalXMonotoneTraits_2.

◆ symmetric_difference() [6/20]

template<typename ArrTraits , typename OutputIterator >

OutputIterator CGAL::symmetric_difference	(	const General_polygon_with_holes_2< General_polygon_2< ArrTraits > > &	pgn1,
		const General_polygon_2< ArrTraits > &	pgn2,
		OutputIterator	oi
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `General_polygon_with_holes_2<General_polygon_2<ArrTraits> >`.

Returns: the past-the-end iterator of the output container.

Precondition: ArrTraits must be a model of the concept ArrangementDirectionalXMonotoneTraits_2.

◆ symmetric_difference() [7/20]

template<typename ArrTraits , typename OutputIterator >

OutputIterator CGAL::symmetric_difference	(	const General_polygon_2< ArrTraits > &	pgn1,
		const General_polygon_with_holes_2< General_polygon_2< ArrTraits > > &	pgn2,
		OutputIterator	oi
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `General_polygon_with_holes_2<General_polygon_2<ArrTraits> >`.

Returns: the past-the-end iterator of the output container.

Precondition: ArrTraits must be a model of the concept ArrangementDirectionalXMonotoneTraits_2.

◆ symmetric_difference() [8/20]

template<typename Polygon , typename OutputIterator >

OutputIterator CGAL::symmetric_difference	(	const General_polygon_with_holes_2< Polygon > &	pgn1,
		const General_polygon_with_holes_2< Polygon > &	pgn2,
		OutputIterator	oi
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `General_polygon_with_holes_2<Polygon>`.

Returns: the past-the-end iterator of the output container.

◆ symmetric_difference() [9/20]

template<typename InputIterator , typename OutputIterator >

OutputIterator CGAL::symmetric_difference	(	InputIterator	begin,
		InputIterator	end,
		OutputIterator	oi
	)

#include <CGAL/Boolean_set_operations_2.h>

Given a range of polygons (resp.

general polygons) or a range of general polygons with holes (resp. general polygons with holes) computes the symmetric difference of all polygons in the range and inserts the resulting polygons with holes (resp. general polygons with holes) into a container via an output iterator. A point is contained in the symmetric difference, if and only if it is contained in an odd number of input polygons.

Parameters

begin	the first iterator of the input range. Its value type is either `Polygon_2` (resp. `General_polygon_2`) or `Polygon_with_holes_2` (resp. `General_polygon_with_holes_2`).
end	the past-the-end iterator of the input range. Its value type is either `Polygon_2` (resp. `General_polygon_2`) or `Polygon_with_holes_2` (resp. `General_polygon_with_holes_2`).
oi	the output iterator for the result. Its dereference type must be convertible to `Polygon_with_holes_2` (resp. `General_polygons_with_holes_2`).

Returns: the past-the-end iterator of the output container.

◆ symmetric_difference() [10/20]

template<typename InputIterator1 , typename InputIterator2 , typename OutputIterator >

OutputIterator CGAL::symmetric_difference	(	InputIterator1	begin1,
		InputIterator1	end1,
		InputIterator2	begin2,
		InputIterator2	end2,
		OutputIterator	oi
	)

#include <CGAL/Boolean_set_operations_2.h>

Given a range of polygons (resp.

general polygons) and a range of general polygons with holes (resp. general polygons with holes) computes the intersection of all polygons in the two ranges and inserts the resulting polygons with holes (resp. general polygons with holes) into a container via an output iterator. A point is contained in the symmetric difference, if and only if it is contained in an odd number of input polygons.

Parameters

begin1	the first iterator of the 1st input range. Its value type is `Polygon_2` (resp. `General_polygon_2`).
end1	the past-the-end iterator of the 1st input range. Its value type is `Polygon_2` (resp. `General_polygon_2`).
begin2	the first iterator of the 2nd input range. Its value type is `Polygon_with_holes_2` (resp. `General_polygon_with_holes_2`).
end2	the past-the-end iterator of the 2nd input range. Its value type is `Polygon_with_holes_2` (resp. `General_polygon_with_holes_2`).
oi	the output iterator for the result. Its dereference type must be convertible to `Polygon_with_holes_2` (resp. `General_polygons_with_holes_2`).

Returns: the past-the-end iterator of the output container.

◆ symmetric_difference() [11/20]

template<typename Kernel , typename Container , typename OutputIterator , typename GpsTraits >

OutputIterator CGAL::symmetric_difference	(	const Polygon_2< Kernel, Container > &	pgn1,
		const Polygon_2< Kernel, Container > &	pgn2,
		OutputIterator	oi,
		const GpsTraits &	traits
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two polygons and inserts the resulting polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `Polygon_with_holes_2<Kernel, Container>`.
traits	a traits object.

Returns: the past-the-end iterator of the output container.

Precondition: GpsTraits must be a model of GeneralPolygonSetTraits_2.

◆ symmetric_difference() [12/20]

template<typename Kernel , typename Container , typename OutputIterator , typename GpsTraits >

OutputIterator CGAL::symmetric_difference	(	const Polygon_2< Kernel, Container > &	pgn1,
		const Polygon_with_holes_2< Kernel, Container > &	pgn2,
		OutputIterator	oi,
		const GpsTraits &	traits
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two polygons and inserts the resulting polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `Polygon_with_holes_2<Kernel, Container>`.
traits	a traits object.

Returns: the past-the-end iterator of the output container.

Precondition: GpsTraits must be a model of GeneralPolygonSetTraits_2.

◆ symmetric_difference() [13/20]

template<typename Kernel , typename Container , typename OutputIterator , typename GpsTraits >

OutputIterator CGAL::symmetric_difference	(	const Polygon_with_holes_2< Kernel, Container > &	pgn1,
		const Polygon_2< Kernel, Container > &	pgn2,
		OutputIterator	oi,
		const GpsTraits &	traits
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two polygons and inserts the resulting polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `Polygon_with_holes_2<Kernel, Container>`.
traits	a traits object.

Returns: the past-the-end iterator of the output container.

Precondition: GpsTraits must be a model of GeneralPolygonSetTraits_2.

◆ symmetric_difference() [14/20]

template<typename Kernel , typename Container , typename OutputIterator , typename GpsTraits >

OutputIterator CGAL::symmetric_difference	(	const Polygon_with_holes_2< Kernel, Container > &	pgn1,
		const Polygon_with_holes_2< Kernel, Container > &	pgn2,
		OutputIterator	oi,
		const GpsTraits &	traits
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two polygons with holes and inserts the resulting polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `Polygon_with_holes_2<Kernel, Container>`.
traits	a traits object.

Returns: the past-the-end iterator of the output container.

Precondition: GpsTraits must be a model of GeneralPolygonSetTraits_2.

◆ symmetric_difference() [15/20]

template<typename ArrTraits , typename OutputIterator , typename GpsTraits >

OutputIterator CGAL::symmetric_difference	(	const General_polygon_2< ArrTraits > &	pgn1,
		const General_polygon_2< ArrTraits > &	pgn2,
		OutputIterator	oi,
		const GpsTraits &	traits
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `General_polygon_with_holes_2<General_polygon_2<ArrTraits> >`.
traits	a traits object.

Returns: the past-the-end iterator of the output container.

Precondition: ArrTraits must be a model of the concept ArrangementDirectionalXMonotoneTraits_2.; GpsTraits must be a model of GeneralPolygonSetTraits_2.

◆ symmetric_difference() [16/20]

template<typename ArrTraits , typename OutputIterator , typename GpsTraits >

OutputIterator CGAL::symmetric_difference	(	const General_polygon_with_holes_2< General_polygon_2< ArrTraits > > &	pgn1,
		const General_polygon_2< ArrTraits > &	pgn2,
		OutputIterator	oi,
		const GpsTraits &	traits
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `General_polygon_with_holes_2<General_polygon_2<ArrTraits> >`.
traits	a traits object.

Returns: the past-the-end iterator of the output container.

Precondition: ArrTraits must be a model of the concept ArrangementDirectionalXMonotoneTraits_2.; GpsTraits must be a model of GeneralPolygonSetTraits_2.

◆ symmetric_difference() [17/20]

template<typename ArrTraits , typename OutputIterator , typename GpsTraits >

OutputIterator CGAL::symmetric_difference	(	const General_polygon_2< ArrTraits > &	pgn1,
		const General_polygon_with_holes_2< General_polygon_2< ArrTraits > > &	pgn2,
		OutputIterator	oi,
		const GpsTraits &	traits
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `General_polygon_with_holes_2<General_polygon_2<ArrTraits> >`.
traits	a traits object.

Returns: the past-the-end iterator of the output container.

Precondition: ArrTraits must be a model of the concept ArrangementDirectionalXMonotoneTraits_2.; GpsTraits must be a model of GeneralPolygonSetTraits_2.

◆ symmetric_difference() [18/20]

template<typename Polygon , typename OutputIterator , typename GpsTraits >

OutputIterator CGAL::symmetric_difference	(	const General_polygon_with_holes_2< Polygon > &	pgn1,
		const General_polygon_with_holes_2< Polygon > &	pgn2,
		OutputIterator	oi,
		const GpsTraits &	traits
	)

#include <CGAL/Boolean_set_operations_2.h>

computes the symmetric difference between two general polygons and inserts the resulting general polygons with holes into a container via an output iterator.

Parameters

pgn1	the 1st input polygon.
pgn2	the 2nd input polygon.
oi	the output iterator for the result. Its dereference type must be convertible to `General_polygon_with_holes_2<Polygon>`.
traits	a traits object.

Returns: the past-the-end iterator of the output container.

Precondition: GpsTraits must be a model of GeneralPolygonSetTraits_2.

◆ symmetric_difference() [19/20]

template<typename InputIterator , typename OutputIterator , typename GpsTraits >

OutputIterator CGAL::symmetric_difference	(	InputIterator	begin,
		InputIterator	end,
		OutputIterator	oi,
		const GpsTraits &	traits
	)

#include <CGAL/Boolean_set_operations_2.h>

Given a range of polygons (resp.

general polygons) or a range of general polygons with holes (resp. general polygons with holes) computes the symmetric difference of all polygons in the range and inserts the resulting polygons with holes (resp. general polygons with holes) into a container via an output iterator. A point is contained in the symmetric difference, if and only if it is contained in an odd number of input polygons.

Parameters

begin	the first iterator of the input range. Its value type is either `Polygon_2` (resp. `General_polygon_2`) or `Polygon_with_holes_2` (resp. `General_polygon_with_holes_2`).
end	the past-the-end iterator of the input range. Its value type is either `Polygon_2` (resp. `General_polygon_2`) or `Polygon_with_holes_2` (resp. `General_polygon_with_holes_2`).
oi	the output iterator for the result. Its dereference type must be convertible to `Polygon_with_holes_2` (resp. `General_polygons_with_holes_2`).
traits	a traits object.

Returns: the past-the-end iterator of the output container.

Precondition: GpsTraits must be a model of GeneralPolygonSetTraits_2.

◆ symmetric_difference() [20/20]

template<typename InputIterator1 , typename InputIterator2 , typename OutputIterator , typename GpsTraits >

OutputIterator CGAL::symmetric_difference	(	InputIterator1	begin1,
		InputIterator1	end1,
		InputIterator2	begin2,
		InputIterator2	end2,
		OutputIterator	oi,
		const GpsTraits &	traits
	)

#include <CGAL/Boolean_set_operations_2.h>

Given a range of polygons (resp.

general polygons) and a range of general polygons with holes (resp. general polygons with holes) computes the intersection of all polygons in the two ranges and inserts the resulting polygons with holes (resp. general polygons with holes) into a container via an output iterator. A point is contained in the symmetric difference, if and only if it is contained in an odd number of input polygons.

Parameters

begin1	the first iterator of the 1st input range. Its value type is `Polygon_2` (resp. `General_polygon_2`).
end1	the past-the-end iterator of the 1st input range. Its value type is `Polygon_2` (resp. `General_polygon_2`).
begin2	the first iterator of the 2nd input range. Its value type is `Polygon_with_holes_2` (resp. `General_polygon_with_holes_2`).
end2	the past-the-end iterator of the 2nd input range. Its value type is `Polygon_with_holes_2` (resp. `General_polygon_with_holes_2`).
oi	the output iterator for the result. Its dereference type must be convertible to `Polygon_with_holes_2` (resp. `General_polygons_with_holes_2`).
traits	a traits object.

Returns: the past-the-end iterator of the output container.

Precondition: GpsTraits must be a model of GeneralPolygonSetTraits_2.

Functions

Function Documentation

◆ symmetric_difference() [1/20]

◆ symmetric_difference() [2/20]

◆ symmetric_difference() [3/20]

◆ symmetric_difference() [4/20]

◆ symmetric_difference() [5/20]

◆ symmetric_difference() [6/20]

◆ symmetric_difference() [7/20]

◆ symmetric_difference() [8/20]

◆ symmetric_difference() [9/20]

◆ symmetric_difference() [10/20]

◆ symmetric_difference() [11/20]

◆ symmetric_difference() [12/20]

◆ symmetric_difference() [13/20]

◆ symmetric_difference() [14/20]

◆ symmetric_difference() [15/20]

◆ symmetric_difference() [16/20]

◆ symmetric_difference() [17/20]

◆ symmetric_difference() [18/20]

◆ symmetric_difference() [19/20]

◆ symmetric_difference() [20/20]