Find

funzione copia link

Scopo

Questa funzione permette di sapere se un documento è già compreso nella collection.

Sintassi

boolean b = 0 // Documento presente nella collection?
//
b := Collection.Find(documento)

Argomenti

Documento

E' un oggetto di tipo IDDocument che rappresenta il documento da cercare nella collection

Valore di ritorno

Questa funzione ritorna True se il documento è già incluso nella collection, False altrimenti.

Note

Se il documento è presente, allora la collection rimane posizionata su di esso, altrimenti la collection viene posizionata dopo l'ultimo elemento.
La ricerca del documento avviene per puntatori. Viene ricercata cioè proprio l'istanza del documento passata come parametro. Se due documenti sono uguali, cioè rappresentano lo stesso record fisico sul database, ma in memoria sono memorizzati come istanze differenti, essi non verrebbero considerati uguali da questa funzione.

Esempio di codice

// **********
// Prova ADD
// **********
public void ProveCollection2.ProvaADD()
{
  IDDocument d = null // Il documento da aggiungere
  //
  // Se non è ancora presente lo aggiungo
  if NOT(this.Fornitori1.Find(d))
  {
    this.Fornitori1.Add(d)
  }
}

In questo esempio la funzione Find viene utilizzata per sapere se un documento è già presente nella collection ed eventualmente aggiungerlo.

Ultima modifica: 25/10/2016 / Validità: da 6.5.2680