FINDITEMTREE
Consente di ricercare un determinato elemento sulla struttura gerarchica definita a partire da un insieme di variabili definite dal programma.
Se l'esito della ricerca è positivo, in uscita sono valorizzate le variabili indicate sulla specifica '@DEFTREE od eventualmente le corrispondenti variabili globali ZTNODO e ZTNODOPADRE.
In alternativa questa specifica consente di posizionarsi su un nodo di cui si conosce l'ID.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| NOMEALBERO | Intero | ||||
| IDNODO | Intero | ||||
| V | |||||
| NODOCORRENTE | Intero | ||||
| DIREZIONE | |||||
| FILTRO |
NOMEALBERO
Variabile di tipo LONG che dovrà contenere l'ID dell'albero
IDNODO
Consente di definire l'identificativo univoco del nodo che deve essere ricercato.
Questo attributo deve essere utilizzato quando si desidera utilizzare la specifica per effettuare il posizionamento sul nodo indicato, oppure come ID di partenza per la funzione di scansione SU/GIU dell'albero.
V
Consente di indicare un elenco di valori che devono essere ricercati sull'albero.
Queste informazioni devono essere indicate nello stesso ordine con cui sono state indicate sulla specifica '@DEFTREE; eventualmente il loro numero può essere inferiore rispetto alla '@DEFTREE.
La ricerca verrà eseguita realizzando una visita in profondità a partire dalla radice; le variabili indicate sul parametro verranno 'confrontate' con quelle definite sulla '@INSITEMTREE sino a localizzare un nodo che soddisfi la condizione di uguaglianza.
NODOCORRENTE
Consente, dopo aver ricercato il nodo e dopo averlo localizzato, di definire quel nodo come corrente.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | nodo non corrente |
1 | nodo corrente |
DIREZIONE
Consente di indicare la direzione di ricerca.
La presenza del parametro determina se la lettura da eseguire è puntuale rispetto all'ID passato o se si vuole leggere il successivo/precedente in base a Direzione.
Se non è indicato il parametro DIREZIONE[] verrà letto il primo nodo che soddisfa le condizioni di uguaglianza.
Se è indicato il parametro DIREZIONE[] verrà letto il nodo precedente o successivo a quello passato nell'IDNODO[]: se l'ID del nodo è vuoto, se la direzione è GIÙ si leggerà a partire dalla radice, se la direzione è SU si leggerà a partire dall'ultimo nodo dell'albero.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
SU | direzione verso la radice dell'albero |
GIU | direzione verso la fine dell'albero |
FILTRO
Consente di definire un elenco di filtri per la selezione del nodo.