## Other utilities Other utilities |

## Synopsis

                        GocPoints;
    GocPoints *         goc_points_new                      (unsigned  n);
    GocPoints *         goc_points_ref                      (GocPoints *points);
    void                goc_points_unref                    (GocPoints *points);

## Description

Only one structure is currently available: GocPoints.

## Details

### GocPoints

    typedef struct {
    	GocPoint *points;
    } GocPoints;

A boxed type used to hold a list of GocPoint instances.

GocPoint *`points`; | The embedded points.

### goc_points_new ()

    GocPoints *         goc_points_new                      (unsigned  n);

Creates a new GocPoints instances with `n` points with nul initial coordinates. The coordinates can be changed using direct access:

         GocPoints points = goc_points_new (1);
         points->points[0].x = my_x;
         points->points[0].y = my_y;

`n` : | the number of GocPoint instances.
Returns : | the newly created GocPoints with an initial references count of 1.

### goc_points_ref ()

    GocPoints *         goc_points_ref                      (GocPoints *points);

Increases the references count of `points` by 1.

`points` : | GocPoints
Returns : | the referenced GocPoints.

### goc_points_unref ()

    void                goc_points_unref                    (GocPoints *points);

Decreases the references count of `points` by 1, and destroys it if the references count becomes 0.

`points` : | GocPoints