[/============================================================================
  Boost.Geometry (aka GGL, Generic Geometry Library)

  Copyright (c) 2009-2012 Barend Gehrels, Amsterdam, the Netherlands.
  Copyright (c) 2009-2012 Mateusz Loskot, London, UK.
  Copyright (c) 2009-2012 Bruno Lalande, Paris, France.

  Use, modification and distribution is subject to the Boost Software License,
  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
  http://www.boost.org/LICENSE_1_0.txt)
=============================================================================/]

[def __this_function__ reverse]

[heading_conformance_no_ogc __this_function__]
[conformance_std __this_function__..std::__this_function__ function]

[heading Behavior]
[table
[[Case] [Behavior] ]
[[__point__][__does_nothing__]]
[[__segment__][__nyiversion__]]
[[__box__][__does_nothing__]]
[[__linestring__][Reverses the __linestring__]]
[[__ring__][Reverses the __ring__]]
[[__polygon__][Reverses the exterior ring and all interior rings in the polygon]]
[[__multi_point__][__does_nothing__]]
[[__multi_linestring__][Reverses all contained linestrings individually]]
[[__multi_polygon__][Reverses all contained polygons individually]]
]

[note The reverse of a (multi)polygon or ring might make a valid geometry invalid because the (counter)clockwise orientation reverses.]

[heading Complexity]
Linear

[heading Example]
[reverse]
[reverse_output]