tpm_elemadj

Compiles a list of adjacent elements for the specified element.

struct resbuf

*tpm_elemadj(

ade_id tpm_id,

ade_id elem_id,

int adj_type);

Returns a list of element IDs or NULL.

tpm_id	The topology ID.
elem_id	An element ID, received from tpm_elemid.
adj_type	The type of adjacent elements to be compiled into the list. Values can be: 1 (node), 2 (link), or 3 (polygon).

The following sample populates a resbuf with adjacent elements, (links) on a network topology using tpm_elemadj(). If the operation is successful the adjacent id(s) are displayed, and the resbuf is released as required. Note, tpm_acopen() was used to obtain the loaded topology id and tpm_elemid() was used to obtain a specific element id within the loaded topology.

char* pszTopoName = "NetTopo";
int topoWriteAccess = 0;
ade_id topoId = tpm_acopen(pszTopoName, topoWriteAccess);
int adjElementType = 2;
long elementIndex = 1;
ade_id adjElementID = tpm_elemid(topoId, adjElementType, elementIndex);
struct resbuf* pAdjElementIdsRb = tpm_elemadj(topoId, adjElementID, adjElementType);
if (NULL != pAdjElementIdsRb){
    struct resbuf* rb = pAdjElementIdsRb;
    acutPrintf(
        "\nThe specified element has an ID of %.0lf. The following adjacent ID(s) were detected:"
        , adjElementID);
    while(NULL != rb) {
        acutPrintf(
            "\n\t %.0lf"
            , rb->resval.rreal);
        rb = rb->rbnext;
    }
}
else {
    acutPrintf(
        "\nNo adjacent elements were detected.");
}
acutRelRb(pAdjElementIdsRb);
tpm_acclose(topoId);