• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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]
53Linear
54
55[heading Example]
56[append]
57[append_output]
58
59[heading See also]
60* [link geometry.reference.algorithms.assign.assign_points assign]
61