VgaGames4 - nodelink man-pages

[.. upper level ..]

vg4->nodelink->get()

Get linked nodes of a node.

SYNTAX
int vg4->nodelink->get(struct VG_Nodelink *ndlnk, const char *nodeid, const char ***linkids, VG_BOOL withdeact)

FUNCTION PARAMETERS
ndlnk Nodelink
nodeid Node
linkids For returning linked nodes, must be freed with free()
withdeact Whether ignore deactivation of links

RETURN VALUE
Returns number of nodes in linkids

DESCRIPTION
Get linked nodes of a node. Links deactivated by vg4->nodelink->deactivate() will be ignored. With withdeact set to VG_TRUE, a possible deactivation of nodeid to another linked node is ignored.

EXAMPLE
/* get activated linked nodes of NODE1 */
const char **linkids;
int nlink, i1;

nlink = vg4->nodelink->get(ndlnk, "NODE1", &linkids, VG_FALSE);
if (nlink > 0) {
  for (i1 = 0; i1 < nlink; i1++) {
    printf("%s\n", linkids[i1]);
  }
  free(linkids);
}