ceph/src/boost/libs/geometry/doc/reference/algorithms/append.qbk

   1 [/============================================================================
   2   Boost.Geometry (aka GGL, Generic Geometry Library)
   3
   4   Copyright (c) 2009-2014 Barend Gehrels, Amsterdam, the Netherlands.
   5   Copyright (c) 2009-2014 Mateusz Loskot, London, UK.
   6   Copyright (c) 2009-2014 Bruno Lalande, Paris, France.
   7
   8   This file was modified by Oracle on 2014.
   9   Modifications copyright (c) 2014, Oracle and/or its affiliates.
  10
  11   Contributed and/or modified by Menelaos Karavelas, on behalf of Oracle
  12
  13   Use, modification and distribution is subject to the Boost Software License,
  14   Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
  15   http://www.boost.org/LICENSE_1_0.txt)
  16 =============================================================================/]
  17
  18 [def __this_function__ append]
  19
  20 [heading_conformance_no_ogc __this_function__]
  21
  22 [include reference/status/append_status.qbk]
  23
  24 [heading Behavior]
  25 [table
  26 [[Case] [Behavior] ]
  27 [[__point__, __box__, __segment__][Compiles, but no action]]
  28 [[__linestring__][Appends point or range to the end of the linestring]]
  29 [[__ring__][Appends point or range to the end of the ring (without explicitly closing it)]]
  30 [[__polygon__][Appends point or range to the end of the polygon (without explicitly closing it),
  31         either the exterior ring (the default) or specify a zero-based index for one of the interior rings.
  32         In the last case, the interior rings are not resized automatically,
  33         so ensure that the zero-based index is smaller than the number of interior rings]]
  34 [[__multi_linestring__][Appends point or range to the end of the
  35         linestring with the given multi index.
  36         The multi-linestring is not resized automatically, so ensure
  37         that the multi index is smaller than then number of linestring
  38         in the multi-linestring.]]
  39 [[__multi_polygon__][Appends point or range to the end of the polygon
  40         (without explicitly closing it) with the given multi-index.
  41         The point or range is appended at the end of the
  42         exterior ring (the default) or specify a zero-based ring index for
  43         the interior rings.
  44         The multi-polygon is not resized automatically, so ensure
  45         that the multi index is smaller than then number of polygon
  46         in the multi-polygon. The same applies for the interior rings
  47         of the polygon: the interior rings are not resized
  48         automatically, so ensure that the zero-based ring index is
  49         smaller than the number of interior rings of the polygon.]]
  50 ]
  51
  52 [heading Complexity]
  53 Linear
  54
  55 [heading Example]
  56 [append]
  57 [append_output]
  58
  59 [heading See also]
  60 * [link geometry.reference.algorithms.assign.assign_points assign]