VgaGames4

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);
    }