KPLOT_DETACH(3)

NAME
kplot_detach - detach plots from the plotting context

LIBRARY
libkplot

SYNOPSIS
#include <cairo.h>
#include <kplot.h>
int
kplot_detach(struct kplot *p, const struct kdata *d);

DESCRIPTION
The kplot_detach function detaches a data source d from a plotting context p as added with kplot_attach_data(3), kplot_attach_datas(3), or kplot_attach_smooth(3). In doing so, it decrements the reference count of the data source.

If the data source is added with kplot_attach_datas(3), all of the data sources attached alongside are removed as well.

RETURN VALUES
kplot_detach returns 0 if the data source was not found or reallocation of internal structures failed due to memory exhaustion. (The latter behaviour is very unusual, as the reallocation is always to a smaller buffer.) Otherwise it returns non-zero.

SEE ALSO
kplot(3), kplot_attach_data(3), kplot_attach_datas(3), kplot_attach_smooth(3)